Deploying the Platform UI on AKS

Install the Kubernetes certificate management controller (cert-manager) in your AKS cluster to generate and manage the TLS certificates that are needed for internal communication.

By default, cert-manager is installed into a cert-manager namespace in your cluster. For more information about installing cert-manager, see the cert-manager documentation.

To install cert-manager, complete the following steps:

1. Log into your AKS cluster, using your AKS user credentials:

   kubectl login

2. Run the following command to install the cert-manager resources from a YAML manifest file on GitHub:

   kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.17.2/cert-manager.yaml

3. To verify the installation, run the following command:

   kubectl get pods --namespace cert-manager

   The output should indicate that the cert-manager pods have a status of Running.

1. Log into your AKS cluster with your AKS user credentials:

   kubectl login

2. If you installed the operators in "All namespaces on the cluster" mode, you will need to use a different namespace in which to deploy the instance.

   • If needed, create a new namespace for this purpose:

     kubectl create namespace <namespace_name>

     For example:

     kubectl create namespace integration

3. Create a PlatformNavigator YAML file. For example, you could create a file called platform-ui-instance.yaml with the following example configuration. Update the values as indicated:

   • For metadata.namespace, enter your namespace name.

   • Change the value of spec.license.accept to true if you accept the Cloud Pak for Integration license agreement. For details, see Licensing.

   • Change any other configuration details as required.

     apiVersion: integration.ibm.com/v1beta1
     kind: PlatformNavigator
     metadata:
       name: integration-quickstart
       namespace: integration
     spec:
       license:
         accept: false
         license: L-VEMB-RABZSN
       replicas: 1
       version: 16.2.0

   For information about advanced configuration options, see Configuring the Platform UI.

4. Apply the YAML file to the AKS cluster:

   kubectl apply -f platform-ui-instance.yaml

5. Check the status of the Platform UI instance by running the following command in the namespace where it was deployed:

   kubectl get platformnavigator

1. Set the name and the namespace (placeholders <name> and <namespace>) for the Platform UI:

   NAME=<name>
   NAMESPACE=<namespace>

2. Get the URL with the following command:

   kubectl get pn -n ${NAMESPACE} ${NAME} -o jsonpath="{.status.metadata.UIEndpoint}{'\n'}"

3. Copy the URL into your browser.

For your first login to the Platform UI, the initial administrator username is integration-admin.

The initial administrator password is placed in a secret named <NAME>-platform-ui-authentication, where <NAME> is the name of the Platform UI instance. Follow the applicable steps to locate the secret in the correct namespace.

1. Set the name and the namespace (placeholders <name> and <namespace>) for the Platform UI:

   NAME=<name>
   NAMESPACE=<namespace>

2. Get the password from the secret in the namespace:

   kubectl get secret/${NAME}-platform-ui-authentication -n ${NAMESPACE} \
      -o go-template='{{index .data "authentication.yaml" | base64decode}}{{"\n"}}'

   The user credentials are printed in your command line tool.

For more information on managing usernames and passwords, see Managing users on AKS.