Playbooks de Exemplo do Ansible
Este tópico fornece um catálogo de exemplos de playbooks do Ansible para o OCI (Oracle Cloud Infrastructure) que ilustram como executar tarefas comuns de configuração e provisionamento de infraestrutura usando nossa coleção doAnsible.
Essas amostras e soluções são organizadas em seções associadas aos serviços da OCI. Você encontra uma breve descrição de cada playbook com links para cada amostra no repositório do Oracle GitHub. Certifique-se de revisar o arquivo Readme.md
incluído no diretório raiz de cada playbook para obter instruções adicionais.
Consulte Conceitos Básicos para começar a usar nossa coleção do Ansible.
Amostras
Volume em Blocos
Este exemplo de playbook mostra como anexar um volume em blocos a uma instância de computação usando o tipo de anexo de volume iSCSI e como conectá-lo com a instância de computação usando iscsiadm
. O exemplo mostra como fazer o seguinte:
- Gerar um par de chaves SSH temporárias específicas para o host.
- Especificar a chave pública do par de chaves para estabelecer conexão com a instância e iniciá-la.
- Criar um novo Volume em Blocos para a instância, anexar o volume à instância e especificar iSCSI como o tipo de anexo do volume.
- Estabeleça conexão e, em seguida, monte o volume da instância do serviço Compute executando comandos
iscsiadm
por SSH usando um módulo Ansible.
Serviço Compute
Esta amostra mostra como iniciar e acessar uma instância de computação Always Free pela internet usando SSH usando coleções do OCI Ansible.
Esta amostra indica como fazer o seguinte:
- Gerar um par de chaves SSH temporárias específicas para o host.
- Especifique a chave pública desse par de chaves para estabelecer conexão com a instância durante a inicialização da instância.
- Estabelecer conexão com a instância recém-iniciada usando SSH.
Esta amostra mostra como uma instância de computação pública pode ser iniciada usando app_catalog e acessada pela internet usando coleções do SSH com o OCI Ansible.
Esta amostra indica como fazer o seguinte:
- Gerar um par de chaves SSH temporárias específicas para o host.
- Especifique a chave pública desse par de chaves para estabelecer conexão com a instância durante a inicialização da instância.
- Extraia o app_catalog e suas versões e crie uma assinatura para ele.
- Inicie a instância usando o app_catalog e estabeleça conexão com ela usando SSH.
Esta amostra mostra como gerenciar suas instâncias de computação usando recursos como configurações de instância e pools de instância que são fornecidos usando coleções do OCI Ansible. Os pools de instâncias ajudam a criar e provisionar várias instâncias de computação dentro da mesma região com base em uma configuração de instância única.
Esta amostra indica como fazer o seguinte:
- Gerar um par de chaves SSH temporárias específicas para o host.
- Especifique a chave pública desse par de chaves para estabelecer conexão com a instância durante a inicialização da instância.
- Crie uma configuração de instância que determine definições para a criação de uma instância de computação como parte do pool de instâncias. A configuração fornece detalhes como, por exemplo, imagem base, forma e metadados.
- Use o pool de instâncias para iniciar instâncias de computação com base na configuração da instância.
- Estabeleça conexão com uma das instâncias de computação usando SSH.
Esta amostra mostra como uma conexão da console de série e VNC pode ser criada para uma instância da computação e como os dados da console de série podem ser capturados e extraídos de uma instância da computação usando coleções do OCI Ansible. Para obter mais informações sobre conexões da Console, consulte Diagnosticando e Solucionando Problemas de Instâncias Usando Conexões da Console de Instâncias.
Esta amostra indica como fazer o seguinte:
- Gerar um par de chaves SSH temporárias para a conexão com a Console serial.
- Crie uma conexão da Console de instância para uma instância de computação.
- Capture dados da Console serial para uma instância de computação e, em seguida, salve os dados em uma máquina local para que você possa diagnosticar, solucionar e depurar problemas.
Esta amostra mostra como iniciar e acessar uma instância de computação pública pela internet usando as coleções SSH com o OCI Ansible.
Esta amostra indica como fazer o seguinte:
- Gerar um par de chaves SSH temporárias específicas para o host.
- Especificar a chave pública do par de chaves para estabelecer conexão com a instância e iniciá-la.
- Estabelecer conexão com a instância recém-iniciada usando SSH.
Esta amostra mostra como você pode usar as coleções do OCI Ansible para permitir o acesso da internet em instâncias de computação em uma sub-rede privada usando um Gateway NAT em uma sub-rede pública. Para obter mais informações sobre gateways NAT, consulte Gateway NAT e Recursos de Acesso na Internet Pública por Meio de um Gateway NAT do Oracle Cloud Infrastructure.
Esta amostra indica como fazer o seguinte:
- Configurar a VCN, o gateway NAT, o gateway de Internet, as sub-redes pública e privada, além das listas de segurança e regras de roteamento necessárias.
- Provisionar uma instância bastion na sub-rede pública e uma instância privada na sub-rede privada.
Depois de configurada, a instância privada terá acesso à Internet de saída por meio do gateway NAT e será acessível usando SSH da instância bastion.
Esta amostra mostra como você pode usar as coleções do OCI Ansible para permitir o acesso pela internet em instâncias de computação em uma sub-rede privada usando uma instância NAT em uma sub-rede pública, conforme discutido aqui e no whitepaper aqui.
Um gateway NAT está disponível como solução confiável e altamente disponível no serviço OCI Networking. Consulte a amostra para obter mais detalhes.
Esta amostra indica como fazer o seguinte:
- Configure a topologia descrita no white paper criando a VCN, o gateway de internet, as sub-redes públicas e privadas e as listas de segurança e regras de roteamento necessárias. Uma instância NAT é provisionada na sub-rede pública e uma instância privada é provisionada na sub-rede privada.
- Após a configuração, a instância privada tem acesso à Internet de saída por meio da instância NAT na sub-rede pública.
Este playbook de amostra mostra como você pode usar coleções do OCI Ansible para permitir o acesso privado a um serviço Object Storage em uma instância de computação usando um gateway do serviço. Para obter mais informações sobre gateways de serviço, consulte Acesso a Serviços Oracle: Gateway de Serviço. Para ler uma postagem no blog que explica como conectar instâncias de computação usando o gateway de serviço, consulte Conectar Instâncias Privadas com Serviços Oracle por meio de um Gateway de Serviços do Oracle Cloud Infrastructure.
Esta amostra indica como fazer o seguinte:
- Configure um usuário, um grupo e as políticas necessárias para gerenciar buckets.
- Criar e carregar as chaves necessárias da API para o usuário.
- Configure a VCN, o gateway NAT, o gateway de Internet, as sub-redes públicas e privadas, bem como as listas de segurança e as tabelas de roteamento necessárias. Uma instância bastion é provisionada na sub-rede pública e uma instância privada é provisionada na sub-rede privada.
- Provisione uma instância de computação na sub-rede privada
- Instale a CLI (Command Line Interface, Interface de Linha de Comando) do OCI e configure a CLI usando o script cloud init.
- Desativar o gateway NAT para restringir o acesso público à instância privada.
- Crie um bucket da instância privada usando a CLI do OCI e verifique se o bucket foi criado.
Após essa configuração, a instância privada tem acesso privado ao serviço Object Storage.
Kubernetes Engine
Esta amostra cria um cluster com o Oracle Cloud Infrastructure Kubernetes Engine (OKE) usando coleções do OCI Ansible.
Esta amostra indica como fazer o seguinte:
- Crie e configure uma VCN e os recursos relacionados necessários para configurar um cluster do OKE.
- Crie um cluster.
- Crie um pool de nós.
- Faça download do arquivo kubeconfig para o cluster.
Banco de Dados
Esta amostra mostra como você pode usar a coleção do OCI Ansible para criar um Always Free Autonomous Database com Autonomous Database para Transaction Processing e Cargas de Trabalho Mistas e gerenciar seu Ciclo de Vida. Consulte Usar o Autonomous Database Gratuitamente para obter mais informações.
Esta amostra indica como fazer o seguinte:
- Configure um Autonomous Database com o Autonomous Database para Processamento de Transações e Cargas de Trabalho Mista.
- Liste todas as instâncias do Autonomous Database for Transaction Processing e de Cargas de Trabalho Mistas disponíveis em um compartimento, filtradas pelo nome de exibição.
- Obtenha os "fatos" de um banco de dados especificado.
- Interrompa e inicie um Autonomous Database.
- Exclua um Autonomous Database.
Esta amostra mostra como você pode usar a coleção do OCI Ansible para criar um Autonomous Database com Autonomous Database para Transações de Processamento e Cargas de Trabalho Mistas e gerenciar seu ciclo da vida. Consulte Autonomous Database for Transaction Processing and Mixed Workloads para obter mais informações.
Esta amostra indica como fazer o seguinte:
- Configure um Autonomous Database com o Autonomous Database para Processamento de Transações e Cargas de Trabalho Mista.
- Liste todas as instâncias do Autonomous Database for Transaction Processing e de Cargas de Trabalho Mistas disponíveis em um compartimento, filtradas pelo nome de exibição.
- Obtenha os "fatos" de um banco de dados especificado.
- Interrompa e inicie um Autonomous Database.
- Exclua um Autonomous Database.
Esta amostra mostra como você pode usar a coleção do OCI Ansible para criar um Sistema de BD. Para obter mais informações sobre Sistemas de BD cogerenciados da OCI, consulte Sobre Sistemas de Banco de Dados Bare Metal e de Máquina Virtual.
Esta amostra indica como fazer o seguinte:
- Configure um Sistema de BD de Máquina Virtual.
- Obtenha fatos de um Sistema de BD específico e liste Homes de BD disponíveis.
- Liste todos os bancos de dados disponíveis no Home de BD especificado e obtenha fatos de um banco de dados específico.
- Colete informações de VNIC do Nó de BD de um sistema de BD especificado.
- Extraia da VNIC os IPs Públicos e Privados do Nó de BD.
- Crie um backup com base no banco de dados inicial.
- Restaure um banco de dados do backup mais recente.
- Criar um novo banco de dados com base em um backup.
- Atualize os campos do banco de dados.
Armazenamento de Arquivos
Esta amostra mostra como você pode usar a coleção do OCI Ansible para criar e acessar um sistema de arquivos do serviço File Storage por meio de instâncias de computação.
Esta amostra indica como fazer o seguinte:
- Gere todas as dependências relacionadas à rede (por exemplo, a VCN, as sub-redes) e as listas da segurança com a configuração exigida pelo serviço File Storage.
- Gere os certificados exigidos pelas instâncias.
- Crie componentes do serviço File Storage, como ponto de acesso NFS, sistema de arquivo, exportação e snapshot.
- Monte o sistema de arquivos por meio de uma instância de computação e acesse o conteúdo por meio de outra instância de computação.
Esta amostra mostra como você pode usar a coleção do OCI Ansible para exportar um sistema de arquivo usando dois caminhos de exportação diferentes em dois destinos de montagem diferentes. É demonstrado também como um único ponto de acesso NFS pode exportar caminhos de dois sistemas de arquivos distintos.
Esta amostra indica como fazer o seguinte:
- Gere todas as dependências relacionadas à rede (por exemplo, a VCN, as sub-redes) e as listas da segurança com a configuração exigida pelo serviço File Storage.
- Gere os certificados exigidos pelas instâncias.
- Crie componentes do serviço File Storage, como ponto de acesso NFS, sistema de arquivo, exportação e snapshot.
- Exporte um sistema de arquivos para dois pontos de acesso NFS diferentes.
- Exporte caminhos de um único ponto de acesso NFS para dois sistemas de arquivos diferentes.
- Monte o sistema de arquivos por meio de uma instância de computação.
Identidade
Esta amostra mostra como você pode usar a coleção do OCI Ansible para executar tarefas básicas do Oracle Cloud Infrastructure Identity and Access Management (IAM). A amostra pressupõe que o usuário padrão configurado na configuração da OCI esteja no grupo Administrador ou tenha o acesso necessário para gerenciar usuários, grupos, políticas.
Esta amostra indica como fazer o seguinte:
- Criar um novo grupo.
- Crie uma política.
- Crie um usuário e depois adicione-o ao grupo e à política.
- Crie a senha do usuário.
- Gere chaves SSH e designe-as ao usuário.
Load Balancing
Esta amostra mostra como você pode usar a coleção do OCI Ansible para criar um balanceador de carga público.
Esta amostra indica como fazer o seguinte:
- Gere todas as dependências relacionadas à rede, como uma VCN e as sub-redes.
- Gere os certificados exigidos pelo balanceador de carga.
- Crie um balanceador de carga público.
Networking
Esta amostra mostra como você pode usar a coleção do OCI Ansible para provisionar uma rede virtual em nuvem (VCN) com duas sub-redes privadas em diferentes domínios da disponibilidade e uma VPN Site a Local. A VPN Site a Local usa um gateway de roteamento dinâmico (DRG), um equipamento do cliente (CPE) e uma conexão IPSec. Os recursos provisionados são ilustrados neste cenário de rede.
Esta amostra indica como provisionar os seguintes recursos:
- Uma VCN
- Duas sub-redes privadas
- Um gateway de roteamento dinâmico
- CPE (Customer Premises Equipment)
- Uma conexão IPSec entre DRG e CPE
Finalmente, ele recupera as informações e o status da configuração da conexão IPSec.
Serviço Object Storage
Esta amostra de playbook mostra como usar a coleção do OCI Ansible para obter o namespace da tenancy no serviço Object Storage.
Esta amostra de playbook mostra como usar a coleção do OCI Ansible para listar todos os objetos do serviço Object Storage em todos os buckets de um namespace.
Esta amostra de playbook mostra como usar a coleção do OCI Ansible para excluir objetos criados dentro de um intervalo especificado de dias de todos os buckets de um namespace. Você pode modificar a amostra para que ela exclua objetos com mais de um número especificado de dias, o que ajuda a eliminar objetos antigos ou indesejados armazenados no serviço Object Storage.
Soluções
MuShop
MuShop é uma mostra de vários serviços da Oracle Cloud Infrastructure (OCI) em um aplicativo unificado de referência. O aplicativo de amostra implementa uma plataforma de e-commerce criada como conjunto de microsserviços. O conteúdo que acompanha pode ser usado para começar a usar o desenvolvimento de aplicativos nativos da nuvem no OCI.
O MuShop pode ser implantado de diferentes maneiras para explorar o OCI com base em sua assinatura. O OCI oferece camada Always Free com recursos que podem ser usados indefinidamente.
Este projeto é um exemplo de como você pode criar uma infraestrutura de OCI usando a coleção do OCI Ansible.