SPK Artifacts Via F5 Artifact Registry¶
Overview¶
The Service Proxy for Kubernetes (SPK) manifest file, helm charts, docker images, and other utilities are now available via F5 Artifact Registry (FAR) at repo.f5.com. FAR is accessible to all, but only users with a valid Service Account Key can download and install the artifacts.
This document details the procedures for downloading a Service Account Key, and using the Service Account Key to download the SPK Manifest file and install Helm charts, docker images, and other utilities into the cluster from FAR (repo.f5.com).
Procedures¶
1. Download the Service Account Key¶
To download the Service Account Key, do the following:
Login to the MyF5.
Navigate to Support Resources and click Downloads.
Check the box for the End User License Agreement and Program Terms, then click Next.
Choose BIG-IP_Next from the Select a Product Family Group drop-down.
Select Service Proxy for Kubernetes (SPK) from the Product Line drop-down.
Choose the desired version from the Product Version drop-down.
Select the f5-far-auth-key.tgz file from the download file list. Choose a download location from the drop-down menu and click Download.
The TGZ file contains a Service Account Key. This is Service Account Key in base64 format, used for logging into FAR.
2. Download the Manifest File¶
Download the manifest.yaml file for the current release or the specific release you are looking for.
To download the Manifest file, do the following:
Perform a Helm Login to download the Manifest file from FAR:
cat <service_account_key_base64 file> | helm registry login -u _json_key_base64 --password-stdin https://repo.f5.com
In this example, cne_pull-base64.json is the Service Account Key.
cat cne_pull_64.json | helm registry login -u _json_key_base64 --password-stdin https://repo.f5.com
Perform a Helm Pull to pull the Manifest file from FAR:
helm pull oci://repo.f5.com/<path of Manifest file> --version <version of Manifest file>
In this example, release/f5-spk-manifest is the path for pulling manifest.yaml file and its version is 1.9.2.
helm pull oci://repo.f5.com/release/f5-spk-manifest --version 1.9.2
The f5-spk-manifest-1.9.2.tgz file is now pulled.
Run list command to see newly downloaded Manifest tar file:
ls
The file list shows the service_account_key_base64 file and Manifest file named f5-spk-manifest-1.9.2.tgz:
Extract the Manifest file:
tar xvf f5-spk-manifest-1.9.2.tgz
Run list command on the f5-spk-manifest-1.9.2 directory. It shall list spk-manifest-1.9.2.yaml file:
ls f5-spk-manifest-1.9.2
The file list shows a spk-manifest-1.9.2.yaml file:
The spk-manifest-1.9.2.yaml file: Contains names and version numbers of all SPK Helm charts and docker images.
Example of spk-manifest-1.9.2.yaml file:
f5_helm_repo: oci://repo.f5.com f5_docker_repo: repo.f5.com releases: - version: 1.9.2 helm_charts: - name: charts/csrc version: 0.4.10 - name: charts/cwc version: 5.0.10 - name: utils/f5-cert-gen version: 0.9.2 - name: charts/f5-cert-manager version: 0.22.10 - name: charts/f5-crdconversion version: 0.4.14 - name: charts/f5-dssm version: 4.0.5 - name: charts/f5-spk-crds-common version: 7.0.3 - name: charts/f5-spk-crds-deprecated version: 7.0.3 - name: charts/f5-spk-crds-service-proxy version: 7.0.3 - name: charts/f5-toda-fluentd version: 7.0.5 - name: charts/f5ingress version: v12.0.35 - name: charts/rabbitmq version: 7.0.2 docker_images: - name: images/cert-manager-cainjector version: 2.2.3 - name: images/cert-manager-controller version: 2.2.3 - name: images/cert-manager-ctl version: 2.2.3 - name: images/cert-manager-webhook version: 2.2.3 - name: images/crd-conversion version: v1.30.2 - name: images/f5-cert-client version: v2.3.4 - name: images/f5-csm-qkview version: v26.37.21 - name: images/f5-debug-sidecar version: v7.220.1-0.0.1 - name: images/f5-dssm-store version: v4.0.2 - name: images/f5-dssm-upgrader version: v1.2.4 - name: images/f5-fluentbit version: v0.8.3 - name: images/f5-fluentd version: v1.5.6 - name: images/f5-l4p-engine version: v1.100.27 - name: images/f5-license-helper version: v0.10.1 - name: images/f5-toda-tmstatsd version: v6.1.1 - name: images/f5dr-img version: v0.10.8 - name: images/f5dr-img-init version: v0.10.8 - name: images/f5ingress version: v12.0.35 - name: images/init-certmgr version: v0.22.10 - name: images/opentelemetry-collector-contrib version: 0.75.0 - name: images/rabbit version: v5.0.2 - name: images/spk-csrc version: v0.2.17 - name: images/spk-cwc version: v5.0.10 - name: images/tmm-img version: v5.1.11 - name: images/tmrouted-img version: v0.11.7 - name: images/f5-blobd version: v0.12.0
3. Install the Helm charts¶
Following are the two different procedures described to install the Helm charts. Perform the steps mentioned in either Procedure 1 or procedure 2 to complete the installation.
Note: Perform any one of the following procedures.
Procedure 1: Download the SPK Helm charts, Docker Images and other Utilities¶
Do the following steps to download the SPK Helm charts, Docker Images and other Utilities:
Perform a Helm Login to download the Helm charts from FAR:
cat <service_account_key_base64 file> | helm registry login -u _json_key_base64 --password-stdin https://repo.f5.com
In this example, cne_pull-base64.json is the Service Account Key.
cat cne_pull_64.json | helm registry login -u _json_key_base64 --password-stdin https://repo.f5.com
Perform a Helm Pull to pull the Helm charts from FAR:
helm pull oci://repo.f5.com/<path of Helm chart> --version <version of Helm chart>
In this example, charts/f5ingress is the path for pulling f5ingress Helm chart and its version is v12.0.35 as retrieved from the manifest.yaml file.
helm pull oci://repo.f5.com/charts/f5ingress --version v12.0.35
Perform a Utilities Pull to pull the other utilities from FAR:
helm pull oci://repo.f5.com/<path of Utilities> --version <version of Utility>
In this example, utils/log-doc-f5ingress is the path for pulling log-doc-f5ingress utility and its version is 12.0.35 as retrieved from the manifest.yaml file.
helm pull oci://repo.f5.com/utils/log-doc-f5ingress --version 12.0.35
Perform a Docker Login to download the docker images from FAR:
cat <service_account_key_base64 file> | docker login -u _json_key_base64 --password-stdin <URL of F5 Artifact Registry>
In this example, cne_pull_64.json is the same Service Account Key.
cat cne_pull_64.json | docker login -u _json_key_base64 --password-stdin https://repo.f5.com
Perform a Docker Pull to pull the docker images from FAR:
docker pull repo.f5.com/<path of Docker Image>:<version of Docker Image>
In this example, images/rabbit is the path for pulling rabbit docker image and its version is v5.0.2 as retrieved from the manifest.yaml file.
docker pull repo.f5.com/images/rabbit:v5.0.2
Procedure 2: Installing the helm chart via imagePullSecrets¶
The imagePullSecrets feature is used to securely install helm chart from a FAR directly into a cluster by using the Service Account Key from the TGZ file as authentication credentials.
Use the following steps to install the helm chart directly from FAR into a cluster:
Perform a Helm Login, as shown in Step 1 of Procedure 1: Download the SPK Helm charts, Docker Images and other Utilities section.
Perform a Docker Login to download the docker images as shown in step 4 of Procedure 1: Download the SPK Helm charts, Docker Images and other Utilities section.
Copy and paste the below bash script into a .sh file and run it.
Note: The bash script here is using cne_pull_64.json as a Service Account Key. This script is written for Linux. Remove
-w 0
as arguments to base64 from the script when using on Mac.#!/bin/bash # Read the content of pipeline.json into the SERVICE_ACCOUNT_KEY variable SERVICE_ACCOUNT_KEY=$(cat cne_pull_64.json) # Create the SERVICE_ACCOUNT_K8S_SECRET variable by appending "_json_key_base64:" to the base64 encoded SERVICE_ACCOUNT_KEY SERVICE_ACCOUNT_K8S_SECRET=$(echo "_json_key_base64:${SERVICE_ACCOUNT_KEY}" | base64 -w 0) # Create the secret.yaml file with the provided content cat << EOF > far-secret.yaml --- apiVersion: v1 kind: Secret metadata: name: far-secret data: .dockerconfigjson: $(echo "{\"auths\": {\ \"repo.f5.com\":\ {\"auth\": \"$SERVICE_ACCOUNT_K8S_SECRET\"}}}" | base64 -w 0) type: kubernetes.io/dockerconfigjson EOF
The far-secret.yaml secret file will be generated according to the secret name provided in the bash script.
Apply a far-secret.yaml secret file to the namespace where you want to install the helm chart:
oc create -f far-secret.yaml -n <namespace>
In this example the far-secret.yaml secret is install to the demo-ns Project.
oc create -f far-secret.yaml -n demo-ns
In this Fluentd example, configure the fluentd_values.yaml file with imageCredentials and image.repository parameters to install the helm chart from FAR:
imageCredentials: name: far-secret image: repository: repo.f5.com/images
Install the helm chart:
helm install <release name> oci://repo.f5.com/<path of helm chart> --version <version number> -f <values>.yaml
In this example, charts/f5-toda-fluentd is the path for installing f5-toda-fluentd helm chart its version is 7.0.5, values file is fluentd_values.yaml (Created in Step 3).
helm install f5-fluentd oci://repo.f5.com/charts/f5-toda-fluentd --version 7.0.5 -f fluentd_values.yaml
Verify the status of the helm chart:
oc get pods -n demo-ns
In this example, the f5-toda-fluentd is Running.
NAME READY STATUS RESTARTS AGE f5-toda-fluentd-6fcdb48d8b-4dkcc 1/1 Running 0 9s
Feedback¶
Provide feedback to improve this document by emailing spkdocs@f5.com.