Questo documento descrive come installare Kf e le sue dipendenze su un cluster on-premise GKE on VMware o GKE on Bare Metal.
Se hai già familiarità con il processo di installazione di Kf su un cluster GKE in Google Cloud, le principali differenze per la procedura on-premise sono:
- Non è necessario installare Config Connector per un'installazione on-premise.
- La procedura on-premise utilizza le credenziali Docker anziché Workload Identity.
Prima di iniziare
Requisiti di GKE su VMware
Un cluster utente per GKE su VMware che soddisfa i requisiti di Anthos Service Mesh.
Configurata per il logging e il monitoraggio.
Registrato nel tuo parco risorse GKE Enterprise:
Scopri come registrare un cluster.
Requisiti Kf
Esamina e comprendi le autorizzazioni di accesso dei componenti in Kf nella pagina delle dipendenze e dell'architettura Kf.
Tekton per Kf. Questo non è un servizio rivolto agli utenti.
Un account di servizio Google dedicato.
Prepara un nuovo cluster GKE su VMware e i servizi correlati
Imposta le variabili di ambiente
Linux e Mac
export PROJECT_ID=YOUR_PROJECT_ID export CLUSTER_PROJECT_ID=YOUR_PROJECT_ID export CLUSTER_NAME=kf-cluster export COMPUTE_ZONE=us-central1-a export COMPUTE_REGION=us-central1 export CLUSTER_LOCATION=${COMPUTE_ZONE} # Replace ZONE with REGION to switch export NODE_COUNT=4 export MACHINE_TYPE=e2-standard-4 export NETWORK=default export CLUSTER_PROJECT_ID=YOUR_PROJECT_ID export CLUSTER_NAME=kf-cluster export DOCKER_SERVER=YOUR_DOCKER_SERVER_URL export SA_NAME=${CLUSTER_NAME}-sa export SA_EMAIL=${SA_NAME}@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com
Windows PowerShell
Set-Variable -Name PROJECT_ID -Value YOUR_PROJECT_ID Set-Variable -Name CLUSTER_PROJECT_ID -Value YOUR_PROJECT_ID Set-Variable -Name CLUSTER_NAME -Value kf-cluster Set-Variable -Name COMPUTE_ZONE -Value us-central1-a Set-Variable -Name COMPUTE_REGION -Value us-central1 Set-Variable -Name CLUSTER_LOCATION -Value $COMPUTE_ZONE # Replace ZONE with REGION to switch Set-Variable -Name NODE_COUNT -Value 4 Set-Variable -Name MACHINE_TYPE -Value e2-standard-4 Set-Variable -Name NETWORK -Value default Set-Variable -Name CLUSTER_PROJECT_ID -Value YOUR_PROJECT_ID Set-Variable -Name CLUSTER_NAME -Value kf-cluster Set-Variable -Name DOCKER_SERVER -Value YOUR_DOCKER_SERVER_URL Set-Variable -Name SA_NAME -Value ${CLUSTER_NAME}-sa Set-Variable -Name SA_EMAIL -Value ${SA_NAME}@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com
Configura account di servizio
Crea l'account di servizio Google Cloud (GSA) e la chiave dell'account di servizio utilizzati per le build in lettura/scrittura da Container Registry. Questo passaggio è diverso se utilizzi un Container Registry diverso, perché potrebbe avere un modo diverso per ottenere le credenziali per accedere al registry.
Crea l'account di servizio utilizzato da Kf:
gcloud beta iam service-accounts create ${SA_NAME} \ --project=${CLUSTER_PROJECT_ID} \ --description="gcr.io admin for ${CLUSTER_NAME}" \ --display-name="${CLUSTER_NAME}"
Assegna all'account di servizio il ruolo
storage.admin
necessario per la lettura/scrittura da Container Registry:gcloud projects add-iam-policy-binding ${CLUSTER_PROJECT_ID} \ --member="serviceAccount:${SA_NAME}@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com" \ --role="roles/storage.admin"
Crea la chiave dell'account di servizio:
temp_dir=$(mktemp -d)
key_path=${temp_dir}/key.json
gcloud iam service-accounts keys create --iam-account ${SA_EMAIL} ${key_path}
key_json=$(cat ${key_path})
rm -rf ${temp_dir}
Installa le dipendenze software sul cluster
Installa Anthos Service Mesh.
Segui la guida all'installazione di Anthos Service Mesh per installare Anthos Service Mesh.
Se utilizzi GKE su VMware, imposta
loadBalancerIP
su un IP allocato al cluster come descritto in Configurare gli indirizzi IP esterni per GKE su VMware.
Installa Tekton:
kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.26.0/release.yaml"
Installazione di Kf
Installa l'interfaccia a riga di comando Kf:
Linux
Questo comando installa l'interfaccia a riga di comando Kf per tutti gli utenti nel sistema. Segui le istruzioni nella scheda Cloud Shell per installarla in modo autonomo.
gsutil cp gs://kf-releases/v2.6.1/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
Mac
Questo comando installa
kf
per tutti gli utenti del sistema.gsutil cp gs://kf-releases/v2.6.1/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
Cloud Shell
Questo comando installa
kf
sulla tua istanza di Cloud Shell se utilizzibash
; potrebbe essere necessario modificare le istruzioni per altre shell.mkdir -p ~/bin
gsutil cp gs://kf-releases/v2.6.1/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc
Windows
Questo comando scarica
kf
nella directory attuale. Aggiungila al percorso se vuoi effettuare chiamate da qualsiasi posizione diversa dalla directory corrente.gsutil cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe
Installa l'operatore:
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.6.1/operator.yaml"
Configura l'operatore per Kf:
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.6.1/kfsystem.yaml"
Crea un secret Kubernetes per le credenziali Docker
Crea un secret Kubernetes nello spazio dei nomi Kf per le credenziali Docker che hai creato in precedenza in Configurazione dell'account di servizio. Quindi applica una patch al
secret di Kubernetes al deployment subresource-apiserver
per caricare il codice sorgente.
Abilita e aggiorna l'operatore Kf in modo che utilizzi Container Registry come registro dei container.
export CONTAINER_REGISTRY=gcr.io/${CLUSTER_PROJECT_ID}
kubectl patch kfsystem kfsystem \ --type='json' \ -p="[{'op': 'replace', 'path': '/spec/kf', 'value': {'enabled': true, 'config': {'spaceContainerRegistry':'${CONTAINER_REGISTRY}'}}}]"
Verifica che lo spazio dei nomi
kf
sia stato creato dall'operatore Kf. Il completamento dell'operazione potrebbe richiedere alcuni minuti.kubectl get namespace kf
Creare un secret Kubernetes da utilizzare con i registri Docker.
export secret_name=kf-gcr-key-${RANDOM}
kubectl -n kf create secret docker-registry ${secret_name} \ --docker-username=_json_key --docker-server ${DOCKER_SERVER} \ --docker-password="${key_json}"
Aggiorna l'operatore Kf per specificare il secret contenente le credenziali Docker.
kubectl patch kfsystem kfsystem \ --type='json' \ -p="[{'op': 'replace', 'path': '/spec/kf', 'value': {'config': {'secrets':{'build':{'imagePushSecrets':'${secret_name}'}}}}}]"
Convalida installazione
kf doctor --retries=20