Installing Emissary-ingress

You must install Emissary-ingress to terminate Transport Layer Security (TLS) and route traffic to Rational® Test Automation Server. You can install Emissary-ingress by pulling the images from Azure Container Registry (ACR) when you do not want to pull the images from the public registries.

Before you begin

You must have completed the following tasks:

  • Set up the Azure Kubernetes Service (AKS) cluster with Kubernetes. For more information, refer to Azure Kubernetes Service documentation.

  • Installed the following software:

    • Git Bash 2.31.1. For more information, refer to the Git documentation.

    • Helm. For more information, refer to the Helm documentation. For more information about specific versions of software requirements, see System Requirements.
      Note: The Helm command must be in one of the directories in your PATH environment variable.
    • kubectl tool 1.21. For more information, refer to the Kubernetes documentation.

    • Azure command-line interface (Azure CLI) 2.34.1. For more information, refer to the Azure CLI documentation.

      Note: You can run the az version command to find the version and dependent libraries that are installed.
  • Logged in to the AKS cluster.

    Note: You can run the az login command to log in to AKS interactively.
  • Subscribed to active Azure subscription.

    Note: You can run the az account set --subscription {subscription_name} command to set your active subscription.
  • Configured the location of your AKS cluster.

    Note: You can run the az configure --defaults location={location_name} command to set the location of your AKS cluster.
    Tip: You can run the following command to get the list of all the available locations:
    az account list-locations --query "[].{DisplayName:displayName, Name:name}" -o table

About this task

The following table lists the variables that you must replace with the actual value in the command.

Variables Description
{resource_group}

The name of the resource group that you created during the creation of the AKS cluster.

{azure_cluster}

The name of the Azure cluster that you created during the creation of the AKS cluster.

{azure_container_registry}

The name of the ACR that you created during the AKS setup.

{ip_address}

The internal IP address to use with the Emissary-ingress.

Note: You must ensure that the IP address is not in use within your virtual network.

Procedure

  1. Run the following command to configure kubectl to connect to the AKS cluster:
    az aks get-credentials -g {resource_group} -n {azure_cluster}
    Note: You can verify the connection to the AKS cluster by running the kubectl get nodes command that displays a list of the cluster nodes.
  2. Add the Emissary-ingress repository to Helm by running the following command:
    helm repo add datawire https://app.getambassador.io --force-update
  3. Run the following command to know the latest version of the Emissary-ingress chart that matches the keyword emissary-ingress:
    helm search repo emissary-ingress
  4. Run the following command to list the images and move into ACR:
    for image in $(helm template emissary-ingress --namespace emissary datawire/emissary-ingress \
    --set adminService.create=false \
    --set agent.enabled=false \
    --set replicaCount=1 \
    --set test.enabled=false \
    --set image.repository=gcr.io/datawire/emissary \
    --version "7.3.2" \
    | sed -r -n 's/ *image: *([^"]*)/\1/p' | uniq)
    do
      echo "az acr import -n {azure_container_registry} \\"
      echo "  --source ${image/:*?@/@} \\"
      tag=${image/@*/}
      echo "  --image ${tag#*/}"
    done
    Remember: emissary-ingress is the name of the namespace. If you created a namespace by using a different value, then you must use that value in place of the emissary-ingress in all the instances in this procedure.
    The terminal displays a block of commands.
  5. Run the commands that are displayed on the terminal after you perform Step 4 to import an image to ACR.
  6. Run the following commands to install the Emissary-ingress by referencing the images from ACR:
    curl -s https://app.getambassador.io/yaml/emissary/2.2.2/emissary-crds.yaml \
        | sed -r -e "s/replicas: 3/replicas: 1/" \
        | sed -r -e "s#docker.io/emissaryingress#{azure_container_registry}.azurecr.io/datawire#" \
        | kubectl apply -f -
    
    helm install emissary-ingress datawire/emissary-ingress \
        -n emissary \
        --create-namespace \
        --set adminService.create=false \
        --set agent.enabled=false \
        --set replicaCount=1 \
        --set test.enabled=false \
        --set image.repository="{azure_container_registry}.azurecr.io/datawire/emissary" \
        --set service.annotations."service\.beta\.kubernetes\.io/azure-load-balancer-internal"=true \
        --set service.loadBalancerIP={ip_address} \
        --version "7.3.2" && \
      kubectl rollout status  -n emissary deployment/emissary-ingress -w
    
  7. Run the following command to verify that external-IP is assigned to Emissary-ingress:
    kubectl get svc -n emissary -w emissary-ingress
    Note: The status of EXTERNAL-IP is displayed as Pending for a few minutes. If the status does not change to {ip_address}, then that indicates you have a permission issue.
    You can run the following command to investigate the issue:
    kubectl describe svc -n emissary emissary-ingres

Results

You have installed Emissary-ingress.

What to do next

You can install the server software. See Installing the server software on Azure Kubernetes Service.