Aprovisione recursos do Vertex AI Workbench com o Terraform

O HashiCorp Terraform é uma ferramenta de infraestrutura como código (IaC) que lhe permite aprovisionar e gerir a infraestrutura na nuvem. O Terraform oferece plug-ins denominados fornecedores que lhe permitem interagir com fornecedores de nuvem e outras APIs. Pode usar o fornecedor do Terraform para Google Cloud aprovisionar e gerir Google Cloud recursos, incluindo o Vertex AI Workbench.

Esta página apresenta a utilização do Terraform com o Vertex AI Workbench, incluindo uma introdução ao funcionamento do Terraform e alguns recursos para ajudar a começar a usar o Terraform com o Google Cloud. Também encontra links para documentos de referência do Terraform para o Vertex AI Workbench, exemplos de código e guias para usar o Terraform para aprovisionar recursos do Vertex AI Workbench.

Para obter instruções sobre como começar a usar o Terraform para o Google Cloud, consulte o artigo Instale e configure o Terraform ou o Início rápido do Terraform para o Google Cloud .

Como funciona o Terraform

O Terraform tem uma sintaxe declarativa e orientada para a configuração, que pode usar para descrever a infraestrutura que quer aprovisionar no seu Google Cloud projeto. Depois de criar esta configuração num ou mais ficheiros de configuração do Terraform, pode usar a CLI do Terraform para aplicar esta configuração aos seus recursos do Vertex AI Workbench.

Os passos seguintes explicam como funciona o Terraform:

  1. Descreve a infraestrutura que quer aprovisionar num ficheiro de configuração do Terraform. Não precisa de escrever código que descreva como aprovisionar a infraestrutura. O Terraform aprovisiona a infraestrutura por si.
  2. Executa o comando terraform plan, que avalia a sua configuração e gera um plano de execução. Pode rever o plano e fazer alterações conforme necessário.

  3. Executa o comando terraform apply, que realiza as seguintes ações:

    1. Aprovisiona a sua infraestrutura com base no seu plano de execução invocando as APIs do Vertex AI Workbench correspondentes em segundo plano.
    2. Cria um ficheiro de estado do Terraform, que é um ficheiro JSON que mapeia os recursos no seu ficheiro de configuração para os recursos na infraestrutura do mundo real. O Terraform usa este ficheiro para manter um registo do estado mais recente da sua infraestrutura e para determinar quando criar, atualizar e destruir recursos.

    3. Quando executa terraform apply, o Terraform usa o mapeamento no ficheiro de estado para comparar a infraestrutura existente com o código e fazer atualizações conforme necessário:

      • Se um objeto de recurso estiver definido no ficheiro de configuração, mas não existir no ficheiro de estado, o Terraform cria-o.
      • Se um objeto de recurso existir no ficheiro de estado, mas tiver uma configuração diferente da do ficheiro de configuração, o Terraform atualiza o recurso para corresponder ao ficheiro de configuração.
      • Se um objeto de recurso no ficheiro de estado corresponder ao seu ficheiro de configuração, o Terraform deixa o recurso inalterado.

Recursos do Terraform para o Vertex AI Workbench

Os recursos são os elementos fundamentais na linguagem Terraform. Cada bloco de recursos descreve um ou mais objetos de infraestrutura, como redes virtuais ou instâncias de computação.

A tabela seguinte indica os recursos do Terraform disponíveis para o Vertex AI Workbench:

Serviço Recursos do Terraform Origens de dados
Vertex AI Workbench google_workbench_instance_iam_policy

Guias baseados no Terraform para o Vertex AI Workbench

A tabela seguinte apresenta guias de instruções e tutoriais baseados no Terraform para o Vertex AI Workbench:

Guia Detalhes
Crie uma instância do Vertex AI Workbench Crie uma instância do Vertex AI Workbench com uma configuração básica.
Faça a gestão do encerramento por inatividade no Terraform Configure as definições de encerramento por inatividade numa instância do Vertex AI Workbench.
Atualize um contentor personalizado Altere o campo container_image na configuração do Terraform para atualizar a carga útil do contentor.
Crie uma instância com metadados específicos Crie uma instância do Vertex AI Workbench com metadados específicos.

Módulos e projetos do Terraform para o Vertex AI Workbench

Os módulos e os esquemas ajudam a automatizar o aprovisionamento e a gestão de Google Cloud recursos em grande escala. Um módulo é um conjunto reutilizável de ficheiros de configuração do Terraform que cria uma abstração lógica dos recursos do Terraform. Um projeto é um pacote de módulos implementáveis e reutilizáveis, bem como uma política que implementa e documenta uma solução específica.

A tabela seguinte lista os módulos e os planos relacionados com o Vertex AI Workbench:

Módulo ou planta Detalhes
ai-notebook Este módulo demonstra como proteger dados confidenciais numa instância do Vertex AI Workbench.

O que se segue?