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

  1. 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.
  2. Enable the Google Kubernetes Engine API.

    Enable the API

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

  4. 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
    
  5. 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
    
  6. 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:

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

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

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

  2. 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
    
  3. 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.
    
  4. 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.
    
  5. 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.

  6. 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
    
  7. 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.
    
  8. 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
    
  9. 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.
    
  10. 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.
    

  11. 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.
    
  12. 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.

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

A seguir