Neste documento, descrevemos como implantar seus aplicativos nos clusters do Google Kubernetes Engine.
Com o Cloud Deploy, é possível implantar cargas de trabalho baseadas em contêiner em qualquer cluster do Google Kubernetes Engine. Todos os recursos do Cloud Deploy são compatíveis quando você implanta em destinos do GKE.
Antes de começar
Tenha um ou mais clusters do GKE para implantar.
Se você não tiver clusters do GKE para implantar, crie-os.
Verifique se a conta de serviço de execução tem os papéis e permissões necessárias.
Neste arquivo skaffold.yaml
, a estrofe deploy
inclui kubectl
, que indica que o Skaffold está renderizando e implantando no Kubernetes (GKE). Os manifestos que você usa para esse aplicativo estão
listados lá.
Criar a configuração de destino
Cada destino pode ser configurado no YAML do pipeline de entrega ou pode estar em
um arquivo separado. Além disso, é possível configurar mais de um destino no mesmo arquivo,
mas eles precisam estar em estrofes kind: Target
diferentes.
Na definição de destino, crie uma estrofe gke
para apontar para o
cluster do GKE:
A sintaxe para especificar um cluster do GKE é a seguinte:
gke:
cluster: projects/[project_name]/locations/[location]/clusters/[cluster_name]
Esse identificador de recurso do GKE usa os seguintes elementos:
[
project_name
] é o nome do projeto do Google Cloud em que você está executando o cluster.O cluster em que você está implantando não precisa estar no mesmo projeto que o pipeline de entrega.
[
location
] é a região em que o cluster foi criado.[
cluster_name
] é o nome dado ao cluster quando ele foi criado.Esse nome pode ser encontrado na lista de clusters do projeto no console do Google Cloud.
Veja a seguir um exemplo de configuração de destino que aponta para um cluster do GKE:
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name: dev
description: development cluster
gke:
cluster: projects/my-app/locations/us-central1/clusters/my-app-dev-cluster
Criar a configuração do Skaffold
Nesta seção, apresentamos e explicamos um exemplo de uma configuração simples do Skaffold a ser usada ao implantar em um cluster do GKE.
Veja a seguir um exemplo de arquivo skaffold.yaml
para implantação em um
cluster do GKE:
apiVersion: skaffold/v4beta7
kind: Config
metadata:
name: gke-application
manifests:
rawYaml:
- deployment.yaml
deploy:
kubectl: {}
Como usar o Skaffold com o Cloud Deploy descreve em mais detalhes como usar o Skaffold com seu pipeline de entrega.
Preparar manifestos do Kubernetes
Para implantar o aplicativo no GKE, forneça ao Cloud Deploy um ou mais manifestos do Kubernetes, que são renderizados e aplicados aos clusters de destino para implantar o aplicativo.
Se você não tiver esses manifestos, crie-os antes de tentar implantar usando um pipeline de entrega do Cloud Deploy.
Use o Kustomize ou o Helm para criar manifestos. Também será possível usar o Kustomize ou o Helm se os manifestos tiverem um modelo e precisarem ser renderizados.
Como tudo funciona em conjunto
Agora que você tem manifestos do Kubernetes, configuração skaffold.yaml
e definições de destino do Cloud Deploy e já
registrou seus destinos
como recursos do Cloud Deploy, é possível
invocar seu pipeline de entrega
para criar uma versão e avançar com a progressão de destinos definidos
no pipeline.
Implantar em um cluster particular
É possível implantar seu aplicativo em um cluster particular do GKE usando uma destas duas opções:
Usar uma rede de nuvem privada virtual
É possível configurar um destino para implantar em um cluster particular do GKE conectado a uma rede da nuvem privada virtual:
-
Trata-se de um cluster nativo de VPC em que os nós e os pods são isolados por padrão da Internet pública.
Se você planeja usar o IP interno do destino do cluster particular, defina
internalIp
comotrue
emgke
na configuração de destino. No Cloud Build, crie um pool de workers particulares que possa ser usado para implantar nesse cluster particular.
Configure o ambiente de execução para usar esse pool privado.
Use este pool para
RENDER
. Você também pode usá-lo paraDEPLOY
eVERIFY
. Confira um exemplo que usaRENDER
eDEPLOY
:executionConfigs: - usages: - RENDER - DEPLOY workerPool: "projects/p123/locations/us-central1/workerPools/wp123"
Consulte Acessar clusters particulares do GKE com pools particulares do Cloud Build usando o Identity Service para GKE e Acessar clusters particulares do GKE com pools particulares do Cloud Build para mais informações.
Considerações sobre projetos e permissões
Configure um destino para usar um pool de workers particulares que pode ser implantado em um cluster particular. Mas há alguns fatores a serem observados se os recursos estiverem em projetos diferentes.
- Quando o Cloud Deploy e o pool de workers estão em projetos separados
Para se comunicar com um pool privado que tenha acesso a uma VPC e que esteja em um projeto diferente do destino, o agente de serviço do Cloud Deploy precisa de permissões suficientes para se comunicar com esse projeto.
A conta de serviço de execução também precisa de permissões para acessar o bucket do Cloud Storage.
- Quando o pool de workers e o cluster estão em projetos separados
Se o cluster particular do GKE estiver em um projeto diferente do pool de workers particulares, a conta de serviço de execução exigirá permissões suficientes para se comunicar com o projeto em que o cluster está.
Usar destinos do GKE Enterprise e conectar o gateway
É possível configurar um destino para implantar em um cluster particular do GKE usando destinos do Anthos e gateway de conexão.
Essa abordagem não exige o uso de uma nuvem privada virtual ou conexões de rede privada virtual.
A seguir
Conheça o guia de início rápido: implantar um aplicativo no GKE.
Invoque o pipeline de entrega para criar uma versão
Saiba mais sobre como configurar destinos do Cloud Deploy.
Saiba mais sobre como usar o Skaffold com o Cloud Deploy.
Saiba mais sobre os ambientes de execução do Cloud Deploy.
Saiba mais sobre o GKE.