Versão 2.2

Versões disponíveis

2.11: versão mais recente
2.10
2.9
2.7: EOL/não aceita
2.6: EOL/não aceita
2.8: EOL/não aceita
2.5: EOL/não aceita
2.4: EOL/não aceita
2.3: EOL/não aceita
2.2: EOL/não aceita
2.1: EOL/não aceita

Instalar o Kf

Neste documento, você vai aprender a configurar um cluster do GKE e instalar o Kf e as dependências dele.

Antes de começar

Visão geral

O cluster do GKE precisa atender aos seguintes requisitos:
- Opcional, mas é recomendado que o cluster seja dedicado ao Kf. Recomendamos que você instale apenas o Kf e as dependências dele para garantir que a matriz de compatibilidade seja mantida.
- No mínimo, quatro nós. Se for preciso adicionar nós, confira Como redimensionar um cluster.
- O tipo de máquina mínimo que tem pelo menos quatro vCPUs, como e2-standard-4. Se o tipo de máquina do cluster não tiver pelo menos quatro vCPUs, altere o tipo de máquina conforme descrito em Como migrar cargas de trabalho para diferentes tipos de máquina.
- Como opção recomendada, inscreva o cluster em um canal de lançamento. Siga as instruções em Como registrar um cluster atual em um canal de lançamento se você tiver uma versão estática do GKE.
- Identidade da carga de trabalho ativada.
- Artifact Registry ativado.
- Cloud Service Mesh (ASM).
- Tekton instalado. Confira a versão na matriz de dependências.
- Uma conta de serviço do Google com a seguinte política do IAM (link abaixo com as instruções de criação):
  - roles/iam.serviceAccountAdmin
  - serviceAccount:${CLUSTER_PROJECT}.[kf/controller] (para membro serviceAccount:${CLUSTER_PROJECT}.[kf/controller])

Ativar o suporte ao Compute Engine

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Verify that billing is enabled for your Google Cloud project.
Ative a API Compute Engine.
Ative a API

Ativar e configurar o GKE

Antes de começar, verifique se você realizou as tarefas a seguir:

Ativar a API Google Kubernetes Engine.

Ativar a API Google Kubernetes Engine

Se você quiser usar a CLI do Google Cloud para essa tarefa, instale e inicialize a gcloud CLI. Se você instalou a gcloud CLI anteriormente, instale a versão mais recente executando o comando gcloud components update. Talvez as versões anteriores da gcloud CLI não sejam compatíveis com a execução dos comandos neste documento.
Observação: em instalações prévias da gcloud CLI, defina a propriedade compute/region. Se você usa principalmente clusters zonais, defina compute/zone. Ao definir um local padrão, é possível evitar erros na gcloud CLI como: One of [--zone, --region] must be supplied: Please specify location. Talvez seja necessário especificar o local em determinados comandos se o local do cluster for diferente do padrão definido.

Criar e preparar um cluster do GKE

Configurar as variáveis de ambiente.

Linux

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}
export NODE_COUNT=4
export MACHINE_TYPE=e2-standard-4
export NETWORK=default
export KF_VERSION=v2.2.0
export TEKTON_VERSION=v0.19.0

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
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 KF_VERSION -Value v2.2.0
Set-Variable -Name TEKTON_VERSION -Value v0.19.0

Configuração da conta de serviço

Crie uma conta de serviço do GCP (GSA, na sigla em inglês) que será associada a uma conta de serviço do Kubernetes pela identidade da carga de trabalho. Assim não é preciso criar e injetar uma chave de conta de serviço.

Crie a conta de serviço que o Kf usará.

gcloud iam service-accounts create ${CLUSTER_NAME}-sa \
  --project=${CLUSTER_PROJECT_ID} \
  --description="GSA for Kf ${CLUSTER_NAME}" \
  --display-name="${CLUSTER_NAME}"

Permita que a conta de serviço modifique sua própria política. O controlador Kf usará esse parâmetro para adicionar novos (name)spaces espaços à política, permitindo a reutilização da Identidade da carga de trabalho.

gcloud iam service-accounts add-iam-policy-binding ${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}. \
  --project=${CLUSTER_PROJECT_ID} \
  --role="roles/iam.serviceAccountAdmin" \
  --member="serviceAccount:${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}."

Dê o papel de métricas de monitoramento para acesso de gravação ao Cloud Monitoring.

gcloud projects add-iam-policy-binding ${CLUSTER_PROJECT_ID} \
  --member="serviceAccount:${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}." \
  --role="roles/monitoring.metricWriter"

Dê o papel de geração de registros para acesso de gravação no Cloud Logging.

gcloud projects add-iam-policy-binding ${CLUSTER_PROJECT_ID} \
  --member="serviceAccount:${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}." \
  --role="roles/logging.logWriter"

Criar cluster do GKE

gcloud container clusters create ${CLUSTER_NAME} \
  --project=${CLUSTER_PROJECT_ID} \
  --zone=${CLUSTER_LOCATION} \
  --num-nodes=${NODE_COUNT} \
  --machine-type=${MACHINE_TYPE} \
  --network=${NETWORK} \
  --addons=HttpLoadBalancing,HorizontalPodAutoscaling,NetworkPolicy \
  --enable-stackdriver-kubernetes \
  --enable-ip-alias \
  --enable-network-policy \
  --enable-autorepair \
  --enable-autoupgrade \
  --scopes=https://www.googleapis.com/auth/cloud-platform \
  --release-channel=regular \
  --workload-pool="${CLUSTER_PROJECT_ID}." \
  --service-account="${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}."

Definir regras de firewall

O Kf requer a abertura de algumas portas de firewall. O nó mestre precisa se comunicar com pods nas portas 80, 443, 8080, 8443 e 6443.

Ativar a identidade da carga de trabalho

Agora que você tem uma conta de serviço e um cluster do GKE, associe o namespace de identidade do cluster ao cluster.

gcloud iam service-accounts add-iam-policy-binding \
  "${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}." \
  --project=${CLUSTER_PROJECT_ID} \
  --role="roles/iam.workloadIdentityUser" \
  --member="serviceAccount:${CLUSTER_PROJECT_ID}.[kf/controller]"

Cluster do GKE de destino

Use o comando a seguir para configurar o acesso à linha de comando kubectl.

gcloud container clusters get-credentials ${CLUSTER_NAME} \
    --project=${CLUSTER_PROJECT_ID} \
    --zone=${CLUSTER_LOCATION}

Crie um repositório do Artifact Registry

Crie um Artifact Registry para armazenar as imagens de contêiner.

gcloud artifacts repositories create ${CLUSTER_NAME} \
  --repository-format=docker \
  --location=${COMPUTE_REGION}

Conceda permissão à conta de serviço no repositório do Artifact Registry.

gcloud artifacts repositories add-iam-policy-binding ${CLUSTER_NAME} \
  --location=${COMPUTE_REGION} \
  --member="serviceAccount:${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}." \
  --role='roles/artifactregistry.writer'

Configure a autenticação local.

gcloud auth configure-docker ${COMPUTE_REGION}-docker.pkg.dev

Instalar dependências de software no cluster

Instale o Service Mesh.

Observação: confira qual é a versão correta na matriz de dependências.

Instale o Tekton:

kubectl apply -f "https://github.com/tektoncd/pipeline/releases/download/${TEKTON_VERSION}/release.yaml"

Instalar o Kf

Consulte Criar e preparar um cluster do GKE para Kf para criar um cluster preparado para executar o Kf.
Selecione e anote a versão do Kf desejada. Consulte a página Downloads do Kf para ver as versões disponíveis

Observação: muitos dos comandos deste guia dependem dessas variáveis de ambiente. Se você se desconectar do ambiente shell e se reconectar posteriormente, será necessário configurar as variáveis novamente.

Instale a CLI:

Linux

Isso instalará kf para todos os usuários no sistema. Siga as instruções na guia do Cloud Shell para instalá-lo só para você.

gcloud storage cp gs://kf-releases/${KF_VERSION}/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

Mac

Isso instalará kf para todos os usuários no sistema.

gcloud storage cp gs://kf-releases/${KF_VERSION}/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

Cloud Shell

kf será instalado na instância do Cloud Shell caso você use bash. Talvez seja preciso mudar as instruções para outros shells.

mkdir -p ~/bin
gcloud storage cp gs://kf-releases/${KF_VERSION}/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

Windows

O arquivo kf será baixado para o diretório atual. Adicione o arquivo ao caminho se você quiser chamar de outro local que não seja o diretório atual.

gcloud storage cp gs://kf-releases/${KF_VERSION}/kf-windows.exe kf.exe

Instale os componentes do servidor:

Linux e Mac

O arquivo kf.yaml será baixado para o diretório atual.

gcloud storage cp gs://kf-releases/${KF_VERSION}/kf.yaml /tmp/kf.yaml
kubectl apply -f /tmp/kf.yaml

Windows

O arquivo kf.yaml será baixado para o diretório atual.

gcloud storage cp gs://kf-releases/${KF_VERSION}/kf.yaml kf.yaml
kubectl apply -f kf.yaml

Configurar Secrets:

export WI_ANNOTATION=iam.gke.io/gcp-service-account=${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.

kubectl annotate serviceaccount controller ${WI_ANNOTATION} \
--namespace kf \
--overwrite

echo "{\"apiVersion\":\"v1\",\"kind\":\"ConfigMap\",\"metadata\":{\"name\":\"config-secrets\", \"namespace\":\"kf\"},\"data\":{\"wi.googleServiceAccount\":\"${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.\"}}" | kubectl apply -f -

Defina os padrões Kf, esses valores podem ser alterados posteriormente. O exemplo abaixo usa modelos de domínio com um provedor de DNS curinga para fornecer a cada espaço seu próprio nome de domínio:

export CONTAINER_REGISTRY=${COMPUTE_REGION}-docker.pkg.dev/${CLUSTER_PROJECT_ID}/${CLUSTER_NAME}
export DOMAIN='$(SPACE_NAME).$(CLUSTER_INGRESS_IP).nip.io'

kubectl patch configmaps config-defaults \
-n=kf \
-p="{\"data\":{\"spaceContainerRegistry\":\"${CONTAINER_REGISTRY}\",\"spaceClusterDomains\":\"- domain: ${DOMAIN}\"}}"

Valide a instalação:
```
kf doctor --retries 10
```
Observação: esse comando vai inspecionar o cluster para garantir que o Kf e as dependências dele estejam instalados e funcionando. Ele será executado até 10 vezes para que o cluster do Kubernetes tenha tempo de reconciliação e isso deve resultar em uma série de resultados PASS. Se o status de qualquer componente gerar FAIL depois de novas tentativas, consulte a página Solução de problemas do Kf.

Instalar o Kf Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Visão geral

Ativar o suporte ao Compute Engine

Ativar e configurar o GKE

Criar e preparar um cluster do GKE

Configurar as variáveis de ambiente.

Linux

Windows Powershell

Configuração da conta de serviço

Criar cluster do GKE

Definir regras de firewall

Ativar a identidade da carga de trabalho

Cluster do GKE de destino

Crie um repositório do Artifact Registry

Instalar dependências de software no cluster

Instalar o Kf

Linux

Mac

Cloud Shell

Windows

Linux e Mac

Windows

Instalar o Kf