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>]

   Copy to Clipboard

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

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

   Copy to Clipboard
   Tip

   You can list available regions by running the following command:

   az account list-locations -o table

   Copy to Clipboard

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

   Copy to Clipboard

   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>

   Copy to Clipboard

   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/

   Copy to Clipboard

6. Create and activate the <rhdh> namespace:

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

   Copy to Clipboard

7. Create a pull secret, which is used to pull the Developer Hub images from the Red Hat Ecosystem, 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>

   Copy to Clipboard

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

   Copy to Clipboard

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.3.5

   Copy to Clipboard

10. Verify the deployment status:

    kubectl get deploy $DEPLOYMENT_NAME -n $NAMESPACE

    Copy to Clipboard

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.3.5/redhat-developer-hub-1.3.5.tgz" \
        --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \
        --set global.postgresql.auth.password="$PASSWORD"

    Copy to Clipboard

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

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

    Copy to Clipboard