Installa Kf al di fuori di Google Cloud

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questo documento descrive come installare Kf e le relative dipendenze su un cluster on-premise creato nell'ambito di Google Distributed Cloud, su VMware o su bare metal.

Se hai già familiarità con la procedura di installazione di Kf su un cluster GKE in Google Cloud, le principali differenze 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 Google Distributed Cloud

• Un cluster utente che soddisfa Requisiti di Cloud Service Mesh.

• Configurato per il logging e il monitoraggio.

  • VMware.
  • Bare metal.

• Registrato in un parco risorse:

  Vai ai cluster GKE

Requisiti di kf

• Cloud Service Mesh.

• Tekton da utilizzare con Kf. Non si tratta di un servizio rivolto agli utenti.

• Un account di servizio Google dedicato.

Preparare un nuovo cluster on-premise e i servizi correlati

Imposta le variabili di ambiente

Nota: esporta queste variabili di ambiente nel terminale o in Cloud Shell per consentire il funzionamento dei comandi successivi. Se ti disconnetti dall'ambiente shell e ti riconnetti in un secondo momento, devi configurare di nuovo le variabili.

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

Creare l'account di servizio Google Cloud (GSA) e la chiave dell'account di servizio utilizzati per leggere/scrivere le build da Container Registry. Questo passaggio è diverso se stai usando un altro Container Registry perché potrebbe avere un modo diverso di ottenere le credenziali per accedere al registro.

1. 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}"

2. Assegna all'account di servizio il ruolo storage.admin necessario per leggere/scrivere 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"

3. 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

1. Installa Cloud Service Mesh.

   1. Per installare Cloud Service Mesh, segui la guida all'installazione di Cloud Service Mesh.

   2. Se utilizzi Google Distributed Cloud, imposta loadBalancerIP su un IP allocato al cluster come descritto in Configurare gli indirizzi IP esterni per Google Distributed Cloud.

2. Installazione di Tekton:

   kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.47.1/release.yaml"

Installazione di kf

1. Installa l'interfaccia a riga di comando Kf:

   Linux

   Questo comando installa l'interfaccia a riga di comando Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarlo solo per te.

   gcloud storage cp gs://kf-releases/v2.11.21/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.

   gcloud storage cp gs://kf-releases/v2.11.21/kf-darwin /tmp/kf
   chmod a+x /tmp/kf
   sudo mv /tmp/kf /usr/local/bin/kf

   Cloud Shell

   Questo comando installa kf nell'istanza Cloud Shell. Se utilizzi bash, le istruzioni potrebbero dover essere modificate per altre shell.

   mkdir -p ~/bin
   gcloud storage cp gs://kf-releases/v2.11.21/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 corrente. Aggiungila al percorso se voglio chiamare se da una posizione diversa dalla directory attuale.

   gcloud storage cp gs://kf-releases/v2.11.21/kf-windows.exe kf.exe

2. Installa l'operatore:

   kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.11.21/operator.yaml"

3. Configura l'operatore per Kf:

   kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.11.21/kfsystem.yaml"

Crea un secret di Kubernetes per le credenziali Docker

Crea un secret Kubernetes nello spazio dei nomi Kf per le credenziali Docker creato in precedenza in Creazione dell'account di servizio. Quindi applica la patch Secret di Kubernetes al deployment subresource-apiserver per i caricamenti dell'origine.

1. Attiva e aggiorna l'operatore Kf in modo che utilizzi Container Registry come registry dei container.

   Nota: il comando riportato di seguito utilizza il seguente Container Registry come registry dei container: gcr.io/${CLUSTER_PROJECT_ID}. In alternativa, puoi utilizzare il tuo registry dei container personalizzato. Modifica questo comando se necessario se utilizzi un registry dei contenitori personalizzato.

   export CONTAINER_REGISTRY=${COMPUTE_REGION}-docker.pkg.dev/${CLUSTER_PROJECT_ID}/${CLUSTER_NAME}
   
   kubectl patch \
   kfsystem kfsystem \
   --type='json' \
   -p="[{'op': 'replace', 'path': '/spec/kf', 'value': {'enabled': true, 'config': {'featureFlags': {'enable_appdevexperience_builds': true}, 'spaceContainerRegistry': '${CONTAINER_REGISTRY}', 'secrets':{'workloadidentity':{'googleserviceaccount':'${CLUSTER_NAME}-sa', 'googleprojectid':'${CLUSTER_PROJECT_ID}'}}}}}]"
   

   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}'}}}]"
   

2. Verifica che lo spazio dei nomi kf sia stato creato dall'operatore Kf. L'operazione potrebbe richiedere alcuni minuti.

   kubectl get namespace kf

3. Crea un secret Kubernetes da utilizzare con i registry 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}"
   

4. 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 l'installazione

kf doctor --retries=20

Nota: questo comando ispeziona il cluster per assicurarsi che Kf e le relative dipendenze siano installati e funzionanti. Verrà eseguito fino a 20 volte per dare al cluster Kubernetes il tempo di eseguire la riconciliazione e dovrebbe generare una serie di risultati PASS. Se, dopo i nuovi tentativi, lo stato di un componente risulta FAIL, consulta alla pagina Risoluzione dei problemi Kf.