Chapter 3. Set up your environment

Procedure

1. Set the following environment variables, which are used for convenience in this guide:

   export KUADRANT_GATEWAY_NS=api-gateway
   export KUADRANT_GATEWAY_NAME=external
   export KUADRANT_DEVELOPER_NS=toystore
   export KUADRANT_AWS_ACCESS_KEY_ID=xxxx
   export KUADRANT_AWS_SECRET_ACCESS_KEY=xxxx
   export KUADRANT_AWS_DNS_PUBLIC_ZONE_ID=xxxx
   export KUADRANT_ZONE_ROOT_DOMAIN=example.com
   export KUADRANT_CLUSTER_ISSUER_NAME=self-signed

   Copy to Clipboard Toggle word wrap

   These environment variables are described as follows:

   • KUADRANT_GATEWAY_NS: Namespace for your example Gateway in OpenShift.
   • KUADRANT_GATEWAY_NAME: Name of your example Gateway in OpenShift.
   • KUADRANT_DEVELOPER_NS: Namespace for the example toystore app in OpenShift.
   • KUADRANT_AWS_ACCESS_KEY_ID: AWS key ID with access to manage your DNS zone.
   • KUADRANT_AWS_SECRET_ACCESS_KEY: AWS secret access key with permissions to manage your DNS zone.
   • KUADRANT_AWS_DNS_PUBLIC_ZONE_ID: AWS Route 53 zone ID for the Gateway. This is the ID of the hosted zone that is displayed in the AWS Route 53 console.
   • KUADRANT_ZONE_ROOT_DOMAIN: Root domain in AWS Route 53 associated with your DNS zone ID.

   • KUADRANT_CLUSTER_ISSUER_NAME: Name of the certificate authority or issuer TLS certificates.

     Note

     This guide uses environment variables for convenience only. Alternatively, if you know the environment variable values, you can set up the required .yaml files to suit your environment.

2. Create the namespace for the Toystore app as follows:

   kubectl create ns ${KUADRANT_DEVELOPER_NS}

   Copy to Clipboard Toggle word wrap

3. Deploy the Toystore app to the developer namespace:

   kubectl apply -f https://raw.githubusercontent.com/Kuadrant/Kuadrant-operator/main/examples/toystore/toystore.yaml -n ${KUADRANT_DEVELOPER_NS}

   Copy to Clipboard Toggle word wrap