Esta página foi traduzida pela API Cloud Translation.

Crie um build particular com o Gemini para receber assistência do Google Cloud

Neste tutorial, mostramos como usar Gemini para Google Cloud, uma solução com tecnologia de IA colaborador no Google Cloud, para navegar pelos registros e configurar um ambiente de build para um conjunto de microsserviços no Google Kubernetes Engine.

Este tutorial é destinado a engenheiros de DevOps de qualquer nível de experiência.

Objetivos

Solicitar ao Gemini uma consulta de geração de registros para que você possa observar os registros dos pods.
Entender como estabelecer um ambiente de build particular com solicitações Gemini com perguntas contextuais.
Use o Gemini para aprender a armazenar imagens de contêiner de forma privada e segura.

Produtos do Google Cloud usados

Neste tutorial, usamos os seguintes produtos faturáveis do Google Cloud. Use o calculadora de preços para gerar uma estimativa de custo baseada na projeção de uso.

Google Kubernetes Engine (GKE). O GKE é um serviço gerenciado que permite implantar e gerenciar aplicativos conteinerizados em escala.
Cloud Logging: O Logging é um sistema de gerenciamento com suporte para armazenamento, pesquisa, análise e monitoramento.
Cloud Build. O Cloud Build é um serviço que executa se baseia na infraestrutura do Google Cloud. O Cloud Build pode importar o código-fonte de vários repositórios ou do Cloud Storage executar um build de acordo com suas especificações e produzir artefatos, como contêineres Docker ou arquivos Java.
Artifact Registry O Artifact Registry é um local único para você gerenciar imagens de contêiner e pacotes de linguagens. Ele permite que você centralize armazenar artefatos e criar dependências como parte de um ambiente Google Cloud.
Gemini (em inglês). O Gemini está sempre ativo colaboradora do Google Cloud que oferece modelos de IA generativa a uma ampla gama de usuários, incluindo desenvolvedores e dados os cientistas de dados. Para oferecer uma experiência de assistência integrada, O Gemini está incorporado em muitos produtos do Google Cloud.

Antes de começar

Verifique se o Gemini está configurado para sua conta de usuário e projeto do Google Cloud. Além disso, verifique se você tem instalou o plug-in do Cloud Code no seu ambiente de desenvolvimento integrado preferido. Se você preferir usar o Cloud Shell Editor ou Cloud Workstations como seu IDE, depois o Cloud Code e O Gemini Code Assist já está disponível por padrão.
Enable the Google Kubernetes Engine API.
Enable the API
In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

Criar um cluster do GKE usando o Comando gcloud container clusters create:

gcloud container clusters create test --region us-central1

O comando leva alguns minutos para ser executado. O resultado será assim:

Creating cluster test in us-central1... Cluster is being health-checked (master is healthy)...done.

Created https://container.googleapis.com/v1/projects/agmsb-gke-lab/zones/us-central1/clusters/test.

To inspect the contents of your cluster, go to: https://console.cloud.google.com/kubernetes/workload_/gcloud/us-central1/test?project=agmsb-gke-lab
kubeconfig entry generated for test.

NAME: test
LOCATION: us-central1
MASTER_VERSION: 1.27.3-gke.100
MASTER_IP: 34.72.99.149
MACHINE_TYPE: e2-medium
NODE_VERSION: 1.27.3-gke.100
NUM_NODES: 9
STATUS: RUNNING

Clonar um repositório e usar kubectl para implantar um conjunto de microsserviços que compõem um app da Web de e-commerce ao cluster do GKE:

git clone https://github.com/GoogleCloudPlatform/microservices-demo && cd microservices-demo

kubectl apply -f ./release/kubernetes-manifests.yaml

Após alguns minutos, consiga o endereço IP externo para acessar seu app da Web em um navegador:
```
kubectl get service frontend-external | awk '{print $4}'
```

Entenda os registros de cargas de trabalho no GKE

Para o exemplo a seguir, considere que você é um engenheiro de DevOps encarregado herdar um conjunto existente de microsserviços em execução em um cluster. Para entender o ambiente, você decide inspecionar os registros de vários microsserviços.

Na sua preferência Ambiente de desenvolvimento integrado integrado ao Gemini Code Assist, converse com o Gemini para receber ajuda. Usando o painel Gemini, você digita comandos, que são perguntas ou declarações que descrevem a ajuda de acordo com sua necessidade, e o Gemini retorna respostas.

Saiba como e quando o Gemini do Google Cloud usa seus dados.

Você sabe que os microsserviços foram implantados no namespace default. Para solicitar que o Gemini ajude você a inspecionar registros, siga estas etapas:

Na barra de atividades do seu ambiente de desenvolvimento integrado, clique em chat_spark no Gemini Code Assist para abra o painel Gemini Code Assist.

No painel Gemini Code Assist, insira o seguinte comando:

How can I write a Cloud Logging query to search for logs from Pods in
a namespace called "default" in a Google Kubernetes Engine cluster named "test"?

O Gemini retorna uma resposta parecida com:

To write a Cloud Logging query to search for logs from Pods in a
namespace called "default" in GKE cluster called "test", you
can use the following query:

resource.type="k8s_container"
resource.labels.namespace_name="default"
resource.labels.cluster_name="test"

This query will search for all logs from Pods in the "default"
namespace in the "test" GKE cluster. You can also use the
Cloud Logging console to search for logs from Pods in a specific
namespace and cluster. To do this, follow these steps:

1. Go to the Cloud Logging console.
2. In the Query builder pane, click
   Resource.
3. In the Resource type list, select Kubernetes
   Container.
4. In the Namespace name field, enter default.
5. In the Cluster name field, enter test.
6. Click Add.
7. In the Query results pane, you will see a list of logs
   from Pods in the "default" namespace in the "test" GKE
   cluster.

Para inspecionar esses registros, clique em cada um retornado da consulta. Em uma registro individual. Se você clicar em Explicar esta consulta, a resposta será semelhante para o seguinte:

Sure. Here are the bullet points that explain the log entry:

• The log entry is about a GET request to the /_healthz path.
• The request was successful and returned a 200 status code.
• The request took 0 milliseconds to complete.
• The request was made by the x-liveness-probe session.
• The request was made from the frontend-755cdc7957-pv8x5 pod
  in the default namespace.

Criar um ambiente de build particular para imagens de contêiner

Agora que você entende melhor as cargas de trabalho, observando os você decide configurar a infraestrutura e criar o futuro contêiner imagens em um conjunto de workers privados. Nesta seção, você vai fazer Gemini para ajudar você a entender como executar um build para migrar os builds para o projeto do Google Cloud.

Na barra de atividades do seu ambiente de desenvolvimento integrado, clique em chat_spark no Gemini Code Assist para abra o painel Gemini Code Assist.

No painel Gemini Code Assist, insira o seguinte comando:

How can I build a private build environment that is not connected to
the internet in Google Cloud? I want to be able to use Docker to
build my container images in this environment.

O Gemini retorna uma resposta parecida com:

To build a private build environment that is not connected to the internet
in Google Cloud, you can use a Cloud Build private pool. A private pool
is a group of build workers that are not connected to the public internet.
You can create a private pool in a Virtual Private Cloud (VPC) network,
which provides an additional layer of security for your build environment.

To create a private pool, you will need to:

1. Create a VPC network.
2. Create a private pool in the VPC network.
3. Configure your build config file to use the private pool.

Once you have created a private pool, you can use it to build your
container images using Docker. To do this, you will need to:

1. Create a Dockerfile.
2. Create a build config file.
3. Run the `gcloud builds submit` command.

The `gcloud builds submit` command will build your container image
using the private pool.

Find more information for your question here:

• https://cloud.google.com/build/docs/private-pools/create-manage-private-pools

Os pools particulares do Cloud Build parecem ser um caminho viável, então você pergunta Gemini para receber ajuda na criação do seu primeiro pool privado. Insira o seguinte comando:

Can you give me a gcloud command to create my first Cloud Build
private worker pool?

O Gemini retorna uma resposta parecida com:

Here's how you can create your first private worker pool using the gcloud
command:

1. Define your pool configuration:

First, you need to define the configuration of your private pool. This
includes details like the pool name, region, machine type, disk size, and
network settings. You can do this by creating a JSON file named
workerpool.json with the following structure:

{
  "name": "my-first-privatepool",
  "location": "us-central1",
  "machineType": "e2-standard-2",
  "diskSizeGb": 800,
  "network": "projects/your-project-id/global/networks/default",
  "assignExternalIP": true
}

2. Create the pool using gcloud:

Once you have the configuration file ready, you can use the following gcloud
command to create the private worker pool:

gcloud builds worker-pools create \
  --project=gsm-project-382212 \
  --location=us-central1 \
  --worker-pool-id=my-first-privatepool \
  --file=workerpool.json

Explanation of the command:

- gcloud builds worker-pools create : This is the command to create a new worker pool.
- --project=gsm-project-382212 : This specifies the project ID where you want to create the pool.
- --location=us-central1 : This specifies the region where you want to create the pool.
- --worker-pool-id=my-first-privatepool : This specifies the ID for your private pool.
- --file=workerpool.json : This specifies the path to your configuration file.

3. Verify the pool creation:

After running the command, you can verify that the pool has been created by
running the following command:

gcloud builds worker-pools list

Additional notes:

- You can customize the configuration file to meet your specific needs. For
example, you can change the machine type, disk size, or network settings.
- You can also create private worker pools using the Cloud Build API or th
 Cloud Console.

I hope this helps! Let me know if you have any other questions.

Com base na resposta anterior, parece que você precisa transmitir um arquivo de configuração para substituir a variável PRIVATEPOOL_CONFIG_FILE, então você pede para o Gemini para criar um arquivo de configuração. Insira o seguinte comando:

Can you show me an example of a Cloud Build private pool config file?

O Gemini retorna uma resposta parecida com:

Sure. Here is an example of a Cloud Build private pool config file:

privatePoolV1Config:
   networkConfig:
     egressOption: NO_PUBLIC_EGRESS<br>
     peeredNetwork: 'projects/my-project/global/networks/my-network'
     peeredNetworkIpRange: '10.1.2.0/24'
   workerConfig:
     diskSizeGb: '100'
     machineType: 'e2-standard-4'

This config file creates a private pool with the following
properties:

• The pool is not connected to the public internet.
• The pool is connected to the `my-network` VPC network.
• The pool's workers have a `100GB` boot disk and a
  `e2-standard-4` machine type.

For more information, see the Cloud Build documentation.

Você começa a criar seu próprio arquivo de configuração em que os workers de build sem acesso à Internet pública. Navegue até o console do Google Cloud e Inicie o Cloud Shell Editor.

No Cloud Shell, execute o comando a seguir, configurando egressOption a NO_PUBLIC_EGRESS`:

cat << EOF >> cloudbuild-privatepool-config.yaml

privatePoolV1Config:
  networkConfig:
    egressOption: NO_PUBLIC_EGRESS

EOF

Você não tiver certeza sobre as outras opções disponíveis na configuração e você pede ajuda ao Gemini:

Is there a default value for any of these options?

O Gemini retorna uma resposta parecida com:

Yes, there are default values for some of the options in the private
pool config file. For example, the default value for egressOption is
ALLOW_PUBLIC_EGRESS, which means that the private pool will have
access to the public internet. The default value for diskSizeGb is
100, and the default value for machineType is e2-medium.

For a full list of the default values, see the Cloud Build documentation.

Note que o Gemini oferece alguns dos valores padrão definido no arquivo de configuração e, ao ler a documentação, decidir se o arquivo de configuração está bom. No Cloud Shell, transmita o comando gcloud que o Gemini forneceu anteriormente no seu arquivo de configuração recém-criado:
```
gcloud builds worker-pools create max-pool-test \
    --config-from-file cloudbuild-privatepool-config.yaml \
    --region us-central1
```

Após a criação dos workers, você percebe que os contêineres não terá acesso a gerenciadores de pacotes públicos, como pip. Você quer confirme seu conhecimento sobre a hospedagem de pacotes privados. Digite o seguinte prompt:

If I create a private pool with NO_PUBLIC_EGRESS enabled, can I use
Artifact Registry to host my packages privately and access them from
a private pool?

O Gemini retorna uma resposta parecida com:

Yes, you can use Artifact Registry to host your packages privately
and access them from a private pool. To do this, you will need to
create a private pool with NO_PUBLIC_EGRESS enabled and then
configure your Artifact Registry repository to use the private pool.
For more information, see the Cloud Build documentation.

Você decide prosseguir com a criação de um Artifact Registry repositório de dados. No painel Gemini, insira o seguinte comando:

How can I use gcloud to create a private Docker repository for
container images in Artifact Registry?

O Gemini retorna uma resposta parecida com:

To create a private Docker repository for container images in
Artifact Registry, you can use the following command:

gcloud artifacts repositories create REPOSITORY_NAME \\\
    --repository-format=docker \\\
    --location=LOCATION \\\
    --description="DESCRIPTION" \\\
    --kms-key=KMS_KEY

Where:

• REPOSITORY_NAME is the name of your repository.
• LOCATION is the location of your repository.
• DESCRIPTION is a description of your repository.
• KMS_KEY is the name of your Cloud Key Management Service key that
  you want to use to encrypt your repository data.

For more information, see the gcloud artifacts repositories create
documentation.

Ao observar a variável KMS_KEY, você percebe que não criou um a chave do Cloud KMS. Insira o seguinte comando:

Do I need a KMS_KEY?

O Gemini retorna uma resposta parecida com:

No, you don't need a KMS_KEY to create a private Docker repository
for container images in Artifact Registry. However, if you want to
encrypt your container images, you can use a Cloud Key Management Service key. For more
information, see the Artifact Registry CMEK documentation.

Depois de responder às perguntas, execute o comando gcloud no Cloud Shell que o Gemini forneceu para você:

gcloud artifacts repositories create max-docker-repo-test \
    --repository-format=docker \
    --location=us-central1 \
    --description="test container repository"

Com a ajuda do Gemini, você criou a campanha conjunto de workers e o repositório privado para criar e hospedar os artefatos.

Limpar

Para evitar cobranças dos recursos na sua conta do Google Cloud neste tutorial, é possível excluir o projeto do Google Cloud criados para este tutorial. A outra opção é excluir os recursos individuais.

Cuidado: excluir um projeto tem os seguintes efeitos:

Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

A seguir

Leia as Informações gerais do Gemini para Google Cloud.
Saiba mais sobre Cotas e limites do Gemini.
Saiba mais sobre locais do Gemini.