Chapter 2. Deploying Developer Hub on AKS with the Helm chart

Procedure

1. Log in to AKS by running the following command:

   $ az login [--tenant=<optional_directory_name>]

2. Create a resource group by running the following command:

   $ az group create --name <resource_group_name> --location <location>

   Tip

   You can list available regions by running the following command:

   $ az account list-locations -o table

3. Create an AKS cluster by running the following command:

   $ az aks create \
   --resource-group <resource_group_name> \
   --name <cluster_name> \
   --enable-managed-identity \
   --generate-ssh-keys

   You can refer to --help for additional options.

4. Connect to your cluster by running the following command:

   $ az aks get-credentials --resource-group <resource_group_name> --name <cluster_name>

   The previous command configures the Kubernetes client and sets the current context in the kubeconfig to point to your AKS cluster.

5. Open terminal and run the following command to add the Helm chart repository:

   $ helm repo add openshift-helm-charts https://charts.openshift.io/

6. Create and activate the <my-rhdh-project> namespace:

   DEPLOYMENT_NAME=<redhat-developer-hub>
   NAMESPACE=<rhdh>
   kubectl create namespace ${NAMESPACE}
   kubectl config set-context --current --namespace=${NAMESPACE}

7. Create a pull secret, which is used to pull the Developer Hub images from the Red Hat Container Registry, by running the following command:

   $ kubectl -n $NAMESPACE create secret docker-registry rhdh-pull-secret \
       --docker-server=registry.redhat.io \
       --docker-username=<redhat_user_name> \
       --docker-password=<redhat_password> \
       --docker-email=<email>

8. Create a file named values.yaml using the following template:

   global:
     host: <app_address>
   route:
     enabled: false
   upstream:
     ingress:
       enabled: true
       className: webapprouting.kubernetes.azure.com
       host:
     backstage:
       image:
         pullSecrets:
           - rhdh-pull-secret
       podSecurityContext:
         fsGroup: 3000
     postgresql:
       image:
         pullSecrets:
           - rhdh-pull-secret
       primary:
         podSecurityContext:
           enabled: true
           fsGroup: 3000
     volumePermissions:
       enabled: true

9. To install Developer Hub by using the Helm chart, run the following command:

   $ helm -n $NAMESPACE install -f values.yaml $DEPLOYMENT_NAME openshift-helm-charts/redhat-developer-hub --version 1.8.6

10. Verify the deployment status:

    $ kubectl get deploy $DEPLOYMENT_NAME -n $NAMESPACE

11. Configure your Developer Hub Helm chart instance with the Developer Hub database password and router base URL values from your cluster:

    PASSWORD=$(kubectl get secret redhat-developer-hub-postgresql -o jsonpath="{.data.password}" | base64 -d)
    CLUSTER_ROUTER_BASE=$(kubectl get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/^[^.]*\.//')
    helm upgrade $DEPLOYMENT_NAME -i "https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.8.6/redhat-developer-hub-1.8.6.tgz" \
        --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \
        --set global.postgresql.auth.password="$PASSWORD"

12. Display the running Developer Hub instance URL, by running the following command:

    $ echo "https://$DEPLOYMENT_NAME-$NAMESPACE.$CLUSTER_ROUTER_BASE"