Chapter 3. OpenShift Service Mesh and cert-manager

Procedure

1. Add the Jetstack charts repository to your local Helm repository by running the following command:

   $ helm repo add jetstack https://charts.jetstack.io --force-update

2. Install the istio-csr chart by running the following command:

   $ helm upgrade cert-manager-istio-csr jetstack/cert-manager-istio-csr \
       --install \
       --namespace cert-manager \
       --wait \
       --set "app.tls.rootCAFile=/var/run/secrets/istio-csr/ca.pem" \
       --set "volumeMounts[0].name=root-ca" \
       --set "volumeMounts[0].mountPath=/var/run/secrets/istio-csr" \
       --set "volumes[0].name=root-ca" \
       --set "volumes[0].secret.secretName=istio-root-ca" \
       --set "app.istio.namespace=istio-system"

Procedure

1. Specify all the Istio revisions to your istio-csr deployment. See "istio-csr deployment".

2. Add the Jetstack charts to your local Helm repository by running the following command:

   $ helm repo add jetstack https://charts.jetstack.io --force-update

3. Install the istio-csr chart with your revision name by running the following command:

   $ helm upgrade cert-manager-istio-csr jetstack/cert-manager-istio-csr \
       --install \
       --namespace cert-manager \
       --wait \
       --set "app.tls.rootCAFile=/var/run/secrets/istio-csr/ca.pem" \
       --set "volumeMounts[0].name=root-ca" \
       --set "volumeMounts[0].mountPath=/var/run/secrets/istio-csr" \
       --set "volumes[0].name=root-ca" \
       --set "volumes[0].secret.secretName=istio-root-ca" \
       --set "app.istio.namespace=istio-system" \
       --set "app.istio.revisions={default-v1-23-0}"

   Note

   Revision names use the following format, <istio-name>-v<major_version>-<minor_version>-<patch_version>. For example: default-v1-23-0.

Procedure

1. Create the Istio object as shown in the following example:

   Example istio.yaml object

   apiVersion: sailoperator.io/v1alpha1
   kind: Istio
   metadata:
     name: default
   spec:
     version: v1.23.0
     namespace: istio-system
     values:
       global:
         caAddress: cert-manager-istio-csr.cert-manager.svc:443
       pilot:
         env:
           ENABLE_CA_SERVER: "false"
         volumeMounts:
           - mountPath: /tmp/var/run/secrets/istiod/tls
             name: istio-csr-dns-cert
             readOnly: true

   Note

   If you installed your CSR agent with a revision based update strategy, then you need to add the following to your Istio object YAML:

   kind: Istio
   metadata:
     name: default
   spec:
     updateStrategy:
       type: RevisionBased

2. Create the Istio resource by running the following command:

   $ oc apply -f istio.yaml

3. Wait for the Istio object to become ready by running the following command:

   $ oc wait --for=condition=Ready istios/default -n istio-system

Procedure

1. Create the sample namespace by running the following command:

   $ oc new-project sample

2. Find your active Istio revision by running the following command:

   $ oc get istiorevisions

3. Add the injection label for your active revision to the sample namespace by running the following command:

   $ oc label namespace sample istio.io/rev=<your-active-revision-name> --overwrite=true

4. Deploy the sample httpbin service by running the following command:

   $ oc apply -n sample -f https://raw.githubusercontent.com/openshift-service-mesh/istio/refs/heads/master/samples/httpbin/httpbin.yaml

5. Deploy the sample sleep application by running the following command:

   $ oc apply -n sample -f https://raw.githubusercontent.com/istio/istio/refs/heads/master/samples/sleep/sleep.yaml

6. Wait for both applications to become ready by running the following command:

   $ oc rollout status -n sample deployment httpbin sleep

7. Verify that sleep application can access the httpbin service by running the following command:

   $ oc exec "$(oc get pod -l app=sleep -n sample \
        -o jsonpath={.items..metadata.name})" -c sleep -n sample -- \
        curl http://httpbin.sample:8000/ip -s -o /dev/null \
        -w "%{http_code}\n"

   Example of a successful output

   200

8. Run the following command to print the workload certificate for the httpbin service and verify the output:

   $ istioctl proxy-config secret -n sample $(oc get pods -n sample -o jsonpath='{.items..metadata.name}' --selector app=httpbin) -o json | jq -r '.dynamicActiveSecrets[0].secret.tlsCertificate.certificateChain.inlineBytes' | base64 --decode | openssl x509 -text -noout

   Example output

   ...
   Issuer: O = cert-manager + O = cluster.local, CN = istio-ca
   ...
   X509v3 Subject Alternative Name:
     URI:spiffe://cluster.local/ns/sample/sa/httpbin