Observação:

Instalar e Configurar a Ferramenta Pulumi Infrastructure as Code no Oracle Cloud Infrastructure

Introdução

Vamos simplificar seu gerenciamento de infraestrutura da Oracle Cloud (OCI) com a ferramenta Pulumi Infrastructure as Code (IaC). Este tutorial irá discutir como instalar e configurar o Pulumi, garantindo que ele se encaixa perfeitamente no seu fluxo de trabalho. Se você tem experiência ou está começando com IaC, este tutorial tem instruções passo a passo. Prepare-se para atualizar seu gerenciamento de infraestrutura com a Pulumi na OCI.

Depois que a Pulumi estiver em execução na configuração da OCI, você verá uma melhoria notável na eficiência. A interface direta facilita a implementação e o gerenciamento de recursos e simplifica o gerenciamento da infraestrutura da OCI.

Objetivo

Pré-requisitos

Tarefa 1: Baixar e instalar Pulumi

Baixe e instale o Pulumi em seu sistema ou máquina virtual (VM). Para obter mais informações, consulte Download e instalação do Pulumi.

Por exemplo, os usuários do macOS podem instalar o Pulumi executando o comando a seguir.

brew install pulumi/tap/pulumi

Tarefa 2: Instalar o Pacote do Provedor do OCI para Pulumi

Os provedores da OCI atuam como a conexão entre o código Pulumi e os serviços da OCI que você deseja supervisionar. Os provedores da OCI permitem que a Pulumi crie, gerencie e configure recursos dentro do seu ambiente OCI por meio de código.

Para instalar os provedores do OCI para Pulumi, vá para a CLI (Command Line Interface) e execute o comando de instalação. Para este tutorial, usaremos o Python como a linguagem Pulumi para implementar serviços da OCI.

python3 -m pip install pulumi_oci

Para instalar provedores OCI usando outros idiomas, consulte Provedor OCI para Pulumi.

Tarefa 3: Configurar Variáveis de Ambiente

Configure as variáveis de ambiente necessárias para conectar o Pulumi ao seu ambiente OCI. Essas variáveis incluem o OCID (Oracle Cloud Identifier) da tenancy, o OCID do usuário, a impressão digital, a região e o caminho para sua chave de API do OCI.

Modifique os valores de acordo com o arquivo de configuração da tenancy e execute os comandos a seguir.

export TF_VAR_tenancy_ocid="ocid1.tenancy.oc1..<unique_ID>"

export TF_VAR_user_ocid="ocid1.user.oc1..<unique_ID>"

export TF_VAR_fingerprint="<key_fingerprint>"

export TF_VAR_region="us-ashburn-1"

export TF_VAR_private_key_path="/path/to/oci_api_key.pem"

Tarefa 4: Criar uma Pilha Pulumi

Organize seu projeto criando um diretório para sua pilha Pulumi. Inicialize-o com a linguagem de programação de sua preferência. Para este tutorial, estamos usando a pilha Python.

  1. Criar um diretório de pilha Pulumi. Para criar um novo diretório para sua pilha Pulumi, execute o comando a seguir.

    mkdir OCI_Pulumi_Stack && cd OCI_Pulumi_Stack

  2. Inicialize o projeto Pulumi com um modelo OCI Python: pulumi new oci-python.

  3. Informe os detalhes do projeto, como nome do projeto, descrição e nome da pilha (por exemplo, desenvolvimento, preparação, prod). Essa etapa inicia o processo de configuração, incluindo a adição de dependências necessárias e o carregamento do código de amostra no arquivo main.py.

  4. Verifique a configuração do código verificando o conteúdo do diretório OCI_Pulumi_Stack. É aqui que você encontrará o código de amostra e quaisquer arquivos adicionais criados durante o processo de inicialização.

Tarefa 5: Personalizar uma Pilha Pulumi

Personalize uma pilha de acordo com seus requisitos específicos. Abra o arquivo de implantação principal main.py e adicione o código necessário para definir os recursos do OCI que você deseja implantar. Neste tutorial, mostraremos como recuperar os domínios de disponibilidade na tenancy do OCI.

"""A OCI Python Pulumi program"""

import pulumi

import pulumi_oci as oci

test_availability_domains = oci.identity.get_availability_domains(compartment_id="ocid1.tenancy.oc1..xxxxx")

# Output availability domains

pulumi.export("availability_domain_1", test_availability_domains.availability_domains[0].name)

pulumi.export("availability_domain_2", test_availability_domains.availability_domains[1].name)

pulumi.export("availability_domains_3", test_availability_domains.availability_domains[2].name)

Este código demonstra como extrair os domínios de disponibilidade da tenancy do OCI e exportar seus nomes como saída. Quando você executa esse código usando o Pulumi, ele interage com a OCI para recuperar os domínios de disponibilidade e exibir seus nomes como saída. Isso permite garantir que seu código recupere com precisão as informações necessárias do OCI.

Tarefa 6: Implantar o Código Pulumi na OCI

Execute o comando a seguir para implantar recursos no OCI.

pulumi up

Tarefa 7: Verificar a Saída do Comando

Após a implantação, o comando executará o programa Pulumi e recuperará os domínios de disponibilidade em sua tenancy do OCI, conforme definido no código.

Pulumi_OCI_Output

Confirmação

Mais Recursos de Aprendizagem

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal Oracle Learning YouTube. Além disso, visite education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.