How to deploy an image on K8SaaS with TrustNest IAM Service Principal

If you are not familiar with Service Principal you can read this documentation here

• To start you will need to acquire a service principal from TrustNest IAM

• Then onboard your service principal into your Active Directory Group.

  • If you are not familiar you with the process you can follow the documentation here
  • In the past, you needed to extract the kubeconfig from the K8S internal Service principal but this won't be necessary anymore.

caution

Be sure to onboard your Service Principal with at least one of the 2 groups.

• k8saas-<INSTANCE_NAME>-k8saas-developer-cluster-role
• k8saas-<INSTANCE_NAME>-k8saas-devops-cluster-role

Otherwise you will not be able to deploy on your cluster.

• Add these variable in your gitlab-ci.yml

  - AKS_VERSION: <AKS_VERSION_OF_YOUR_CLUSTER> #e.g. 1.26.6
  - INSTANCE_NAME: k8saas-<YOUR_CLUSTER_NAME> #e.g. k8saas-rbo-sandbox
  - K8SAAS_DEPLOY_IMAGE: artifactory.thalesdigital.io/docker-public/k8saas/az-cli-helm
  - SVC_PRINCIPAL_SECRET_BASE64: "$SVC_PRINCIPAL_SECRET_BASE64"
  tip

  The AKS version of your cluster can be found on grafana, here's how you to access Grafana

• Change image: dtzar/helm-kubectl:$HELM_VERSION to image: $K8SAAS_DEPLOY_IMAGE:$AKS_VERSION

• Then in the before script:

  • Remove any reference to KUBECONFIG as these will be deprecated.

  ...
  - echo ${KUBE_CONFIG_K8SAAS} | base64 -d > ${KUBECONFIG}
  - export KUBECONFIG=${KUBECONFIG}
  ...
  • Insert these line:

  ...
  - export SVC_PRINCIPAL_SECRET=$(echo "$SVC_PRINCIPAL_SECRET_BASE64" | base64 -d)
  - az login -u "$SVC_PRINCIPAL" -p "$SVC_PRINCIPAL_SECRET" --tenant "$TENANT"
  - az aks get-credentials --name k8saas-"$INSTANCE_NAME" --resource-group k8saas-"$INSTANCE_NAME" && kubelogin convert-kubeconfig -l azurecli
  ...

This is an exemple to help you understand what to do:

image: nginx:latest

stages:
  - build-docker
  - deploy_aks

variables:
  AKS_VERSION: "1.26.6"
  INSTANCE_NAME: "rbo-sandbox"
  K8SAAS_DEPLOY_IMAGE: artifactory.thalesdigital.io/docker-public/k8saas/az-cli-helm
  SVC_PRINCIPAL_SECRET_BASE64: "$SVC_PRINCIPAL_SECRET_BASE64"

build-docker:
  stage: build-docker
  image:
    name: gcr.io/kaniko-project/executor:debug
    entrypoint: [""]
  script:
    - mkdir -p /kaniko/.docker
    - echo "$CI_COMMIT_TAG"
    - echo "{\"auths\":{\"$ARTIFACTORY_URL\":{\"username\":\"$ARTIFACTORY_USER\",\"password\":\"$ARTIFACTORY_PASSWORD\"}}}" > /kaniko/.docker/config.json
    - /kaniko/executor --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/Dockerfile --destination K8SAAS_DEPLOY_IMAGE:$CI_COMMIT_SHA

deploy_aks:
  stage: deploy_aks
  image: $K8SAAS_DEPLOY_IMAGE:$AKS_VERSION
  before_script:
    - export SVC_PRINCIPAL_SECRET=$(echo "$SVC_PRINCIPAL_SECRET_BASE64" | base64 -d)
    - az login -u "$SVC_PRINCIPAL" -p "$SVC_PRINCIPAL_SECRET" --tenant "$TENANT"
    - az aks get-credentials --name k8saas-"$INSTANCE_NAME" --resource-group k8saas-"$INSTANCE_NAME" && kubelogin convert-kubeconfig -l azurecli
    - cd helloworld
  script:
    - echo Starting
    - echo " >>>>>>>>>> Deploy in progress for $CI_PROJECT_NAME <<<<<<<<<< "
    - >
      helm install helloworld
      --namespace customer-namespaces
      --timeout 2m
      --wait .

• Add these variable in your project CICD variables

  • SVC_PRINCIPAL

    • This will be the name of your service principal you requested to Trustnest IAM

  • SVC_PRINCIPAL_SECRET_BASE64

    • The secret that was shared with the service principal. Be sure to tick the masked variable.

    

  • TENANT

    • Thalesdigital.io tenant - 737c6905-f186-4bcf-afb3-43e349ee23a3

• Launch your pipeline and look at the log, you should have something similar to this confirming it's now using your Trustnest IAM Service Principal:

Executing "step_script" stage of the job script
$ export SVC_PRINCIPAL_SECRET=$(echo "$SVC_PRINCIPAL_SECRET_BASE64" | base64 -d)
$ az login -u "$SVC_PRINCIPAL" -p $SVC_PRINCIPAL_SECRET --tenant "$TENANT"
[
    {
      "cloudName": "AzureCloud",
      "homeTenantId": "737c6905-f186-4bcf-afb3-43e349ee23a3",
      "id": "2927a8a3-7ed8-4c24-a9a4-d7b4c65600e2",
      "isDefault": true,
      "managedByTenants": [],
      "name": "MVP-TDF-K8SAAS-TEST",
      "state": "Enabled",
      "tenantId": "737c6905-f186-4bcf-afb3-43e349ee23a3",
      "user": {
        "name": "MCS-MANAGED-SERVICES-rbo-mcs@svc.thalesdigital.io",
        "type": "user"
      }
    },
    {
      "cloudName": "AzureCloud",
      "homeTenantId": "737c6905-f186-4bcf-afb3-43e349ee23a3",
      "id": "61ed80ee-27d4-4f1f-adf0-7a6c5a83f9bc",
      "isDefault": false,
      "managedByTenants": [],
      "name": "COS-IT-SRE-PRD-Services",
      "state": "Enabled",
      "tenantId": "737c6905-f186-4bcf-afb3-43e349ee23a3",
      "user": {
        "name": "MCS-MANAGED-SERVICES-rbo-mcs@svc.thalesdigital.io",
        "type": "user"
      }
    }
]
$ az aks get-credentials --name k8saas-"$INSTANCE_NAME" --resource-group k8saas-"$INSTANCE_NAME" && kubelogin convert-kubeconfig -l azurecli
WARNING: Merged "k8saas-rbo-diag2-sandbox" as current context in /root/.kube/config

tip

Don't forget to update $SVC_PRINCIPAL_SECRET, whenever you are asked to renew the service principal credential.