Observação:

Este tutorial requer acesso ao Oracle Cloud. Para se inscrever em uma conta gratuita, consulte Conceitos Básicos do Oracle Cloud Infrastructure Free Tier.
Ele usa valores de exemplo para credenciais, tenancy e compartimentos do Oracle Cloud Infrastructure. Ao concluir seu laboratório, substitua esses valores por valores específicos do seu ambiente de nuvem.

QuickStart Oracle Database@Azure com Módulos Terraform ou OpenTofu

Introdução

O Oracle Database@Azure é um serviço do Oracle Database executado na Oracle Cloud Infrastructure (OCI), localizado em data centers da Microsoft, capacitando você a usar os serviços do Oracle Database com conexão mais rápida aos recursos do Azure. A integração multicloud envolve várias etapas de navegação entre o portal OCI e o Microsoft Azure. Este tutorial explica como simplificar o processo de provisionamento aproveitando nossa implementação de referência de módulos e modelos do Terraform ou OpenTofu, disponíveis no repositório GitHub da zona de destino multicloud da OCI para o Microsoft Azure: terraform-OCI-multicloud-azure.

Processo de Provisionamento

Depois de concluir a compra do serviço, você poderá começar a simplificar o processo de provisionamento com o Terraform ou o OpenTofu.

Há várias etapas que uma organização deve executar para comprar, configurar e usar o serviço em seu ambiente do Azure. Dependendo da configuração, das políticas e dos procedimentos do Azure da sua organização, você pode usar algumas ou todas as etapas descritas na figura abaixo. O diagrama abaixo ilustra oportunidades para o Terraform ou OpenTofu simplificar o processo de provisionamento, eliminando as etapas manuais executadas no Portal do Azure e no Console do OCI.

Processo de Provisionamento

Para obter um início rápido com o uso dos modelos e módulos do Terraform, geralmente você terá que passar por essas tarefas de alto nível.

Objetivos

Início rápido do Oracle Database@Azure com módulos Terraform ou OpenTofu

Pré-requisitos

Certifique-se de que seu ambiente tenha o software necessário instalado. Além do Terraform ou OpenTofu e da CLI do Azure/OCI, você também precisará do Python para operações que não são suportadas pelos provedores do Terraform no momento.

Tarefa 1: Forjar e Clonar o repositório GitHub

Clone o repositório terraform-oci-multicloud-azure e navegue até o diretório de modelo apropriado para começar. Como alternativa, você pode bifurcá-la primeiro, o que permite sincronizar sua cópia com nossas atualizações mais recentes posteriormente, ou opcionalmente contribuir com suas atualizações por meio de uma solicitação pull.

Tarefa 2: Inicializar o Terraform

Execute terraform init ou tofu init no seu terminal para configurar o ambiente Terraform local. Como alternativa, você pode configurar o Terraform com estado remoto consultando documentações do Terraform, do OCI ou do Azure para obter mais detalhes.

Tarefa 3: Configurar as Variáveis Obrigatórias do Terraform

Cada diretório de modelo contém um arquivo terraform.tfvars.template que facilita o preenchimento das variáveis de entrada necessárias. Você pode aproveitá-lo para construir seu próprio arquivo de definição de variável (por exemplo, terraform.tfvars) ou, alternativamente, usar outros métodos (por exemplo, variáveis de ambiente com prefixo TF_VAR_ ou CLI terraform com parâmetros -var) para configurar as variáveis necessárias.

Tarefa 4: Autenticar no Azure e no OCI

Alguns dos modelos terraform aproveitam os provedores terraform da OCI e do Azure. Você deve fazer log-in em cada ambiente antes do provisionamento.

Autenticação do OCI

O provedor Terraform do OCI suporta vários métodos de autenticação. Para obter mais informações, consulte Configuração do Provedor.

Recomendamos configurar o provedor Terraform do OCI usando Autenticação de Chave de API. Para obter mais informações, consulte Autenticação de Chave de API.

export TF_VAR_oci_tenancy_ocid="OCID of the OCI tenancy"
export TF_VAR_oci_user_ocid="<OCID of the OCI user>"
export TF_VAR_oci_private_key_path="<path (including filename) of the private key>"
export TF_VAR_oci_fingerprint="<Key's fingerprint>"

Você pode verificar a configuração usando a CLI do OCI.

export OCI_CLI_TENANCY=$TF_VAR_oci_tenancy_ocid
export OCI_CLI_USER=$TF_VAR_oci_user_ocid
export OCI_CLI_FINGERPRINT=$TF_VAR_oci_fingerprint
export OCI_CLI_KEY_FILE=$TF_VAR_oci_private_key_path
oci iam tenancy get --tenancy-id $TF_VAR_oci_tenancy_ocid --output table --query "data.{Name:name, OCID:id}" --auth api_key

Autenticação do Azure

Você pode Autenticar no Azure com o controlador de serviços e verificá-lo com a CLI do Azure. Para obter mais informações, consulte Autenticar o Terraform no Azure.

export ARM_CLIENT_ID="<service_principal_appid>"
export ARM_CLIENT_SECRET="<service_principal_password>"
export ARM_TENANT_ID="<azure_subscription_tenant_id>"
export ARM_SUBSCRIPTION_ID="<azure_subscription_id>"
az login --service-principal -u $ARM_CLIENT_ID -p $ARM_CLIENT_SECRET -t $ARM_TENANT_ID
az account show -o table

Tarefa 5: Revisar e Aplicar o Plano do Terraform

Depois de configurar suas variáveis e autenticação, execute terraform plan ou tofu plan para revisar as alterações. Quando estiver satisfeito com o plano, continue executando terraform apply ou tofu apply para provisionar as configurações.

Modelos do Terraform

A tabela a seguir descreve os modelos do Terraform disponíveis, descreve o que eles fazem e em qual Provedor Terraform eles confiam. Você pode usá-los individualmente de acordo com sua situação e personalizá-los ainda mais com a Zona de Destino do OCI e os Módulos Verificados do Azure (AVM) para uma configuração mais complexa. Para obter mais informações sobre os cenários conjuntos de uso de orientação da Microsoft e da HashiCorp de AzureRM e AzAPI, consulte Desbloqueando o Melhor do Azure com Provedores AzureRM e AzAPI.

Exadata e Autonomous Database

Oracle Database@Azure	AzureRM	AzAPI
Exadata	Início Rápido do Exadata com Módulos de Zona de Destino do OCI (azurerm-OCI-exadata-quickstart)	Início Rápido do Exadata com Módulos Verificados do Azure (avm-oci-exadata-quickstart)
Autonomous Database	Início Rápido do Autonomous Database com AzureRM (azurerm-oci-adbs-quickstart)	Início Rápido do Autonomous Database com AzAPI (az-oci-adbs)

Identidade

Próximas Etapas

Este tutorial explicou como você pode usar o Terraform ou o OpenTofu no provisionamento de serviços do Oracle Database@Azure. Consulte a seção Links Relacionados para obter detalhes sobre o Oracle Database@Azure, esforço de automação e muito mais.

Informe se você tiver alguma solicitação de recurso ou aprimoramento criando um problema GitHub em nosso repositório ou interaja com nosso Fórum OCI Multicloud. Estamos ansiosos para apoiar seu caso de uso a cada etapa do caminho.

Confirmações

Autor - Steven Chan (Gerente Sênior de Produtos, OCI Multicloud)
Contribuidores - Anwar Belayachi (Arquiteto de Soluções Sênior, OCI Multicloud), John Wargo (Gerente de Produtos Principal), Partha Srinivasan (Gerente de Produtos Principal), Wei Han (Gerente de Produtos Principal)

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.

Título e Informações de Copyright

QuickStart Oracle Database@Azure with Terraform or OpenTofu Modules

G13127-02

November 2024

Oracle e/ou suas empresas afiliadas.