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

Anexando um volume em blocos a uma instância do serviço Compute

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.

Ir para o exemplo no Oracle GitHub.

Serviço Compute

Iniciando uma instância de computação Always Free

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.

Vá até a amostra de Always Free no Oracle GitHub.

Iniciando uma instância de computação com o Catálogo de Aplicativos

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.

Ir para o exemplo no Oracle GitHub.

Criando um pool de instâncias

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.

Ir para o exemplo no Oracle GitHub.

Criando conexões da Console de instância e Capturando o histórico da Console

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.

Ir para o exemplo no Oracle GitHub.

Iniciando uma instância de computação

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.

Ir para o exemplo no Oracle GitHub.

Ativando o acesso à Internet em uma instância de computação com o Gateway NAT do OCI

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.

Ir para o exemplo no Oracle GitHub.

Ativando o acesso à Internet em uma instância de computação com uma Instância NAT do OCI

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.

Observação

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.

Ir para o exemplo no Oracle GitHub.

Acessando o Object Storage em uma instância privada usando um gateway de serviço

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.

Ir para o exemplo no Oracle GitHub.

Kubernetes Engine

Criando um cluster com o 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.

Ir para o exemplo no Oracle GitHub.

Banco de Dados

Criando um Autonomous Database Always Free

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.

Ir para o exemplo no Oracle GitHub.

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

Ir para o exemplo no Oracle GitHub.

Criando um sistema de BD Bare Metal e de Máquina Virtual

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.

Ir para o exemplo no Oracle GitHub.

Armazenamento de Arquivos

Criando e montando um sistema 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.

Ir para o exemplo no Oracle GitHub.

Exportando vários sistemas de arquivos e pontos de acesso NFS

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.

Ir para o exemplo no Oracle GitHub.

Identidade

Adicionando um usuário e grupo

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.

Ir para o exemplo no Oracle GitHub.

Load Balancing

Criando um balanceador de carga

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.

Ir para o exemplo no Oracle GitHub.

Networking

Provisionando uma VCN com sub-redes privadas

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.

Ir para o exemplo no Oracle GitHub.

Serviço Object Storage

Obtendo um namespace

Esta amostra de playbook mostra como usar a coleção do OCI Ansible para obter o namespace da tenancy no serviço Object Storage.

Ir para o exemplo no Oracle GitHub.

Listando objetos e buckets

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.

Ir para o exemplo no Oracle GitHub.

Excluindo objetos

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.

Ir para o exemplo no Oracle GitHub.

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.

Ir para a solução no Oracle GitHub.