Conceitos Básicos

• Você deve ter uma conta no Oracle Cloud Infrastructure.
• Você deve ter um usuário nessa conta, em um grupo de segurança com uma política que conceda as permissões necessárias para trabalhar com recursos nos compartimentos de contas. Para obter orientação, consulte Como as Políticas Funcionam.
• Você deve ter as credenciais e as informações necessárias do OCID.

Se você estiver executando Oracle Linux 7 ou Oracle Linux 8, poderá usar a yum para instalar o RPM de coleção da Oracle Cloud Infrastructure Ansible.

O RPM de coleção Ansible instala a coleção do OCI Ansible e suas dependências necessárias: o OCI SDK para Python e Ansible.

Use um dos comandos a seguir para ativar o repositório do desenvolvedor do Oracle Linux e instalar o RPM da coleção do Ansible, dependendo da sua versão do Oracle Linux.

Oracle Linux 7:

yum install -y oci-ansible-collection --enablerepo ol7_developer --enablerepo ol7_developer_EPEL

Oracle Linux 8:

yum install -y oci-ansible-collection --enablerepo ol8_developer --enablerepo ol8_developer_EPEL

Após a instalação do RPM, configure o arquivo de configuração do SDK e da CLI, conforme explicado em Configurando a Autenticação.

ansible-3 localhost -m oracle.oci.oci_object_storage_namespace_facts

ansible localhost -m oracle.oci.oci_object_storage_namespace_facts

Os playbooks de exemplo estão disponíveis no projeto GitHub da coleção de Ansible do Oracle Cloud Infrastructure. A biblioteca de amostras é atualizada regularmente com a adição de novas amostras. Consulte Playbooks do Ansible de Exemplo para obter mais informações.

Após a conclusão da instalação, ou se você estiver usando o Cloud Shell, poderá criar um playbook de amostra que use módulos Ansible. Segue um playbook de exemplo (chamado list_buckets.yml) que usa o módulo oci_object_storage_bucket_facts para extrair fatos pertencentes aos buckets do compartimento.

---
- name : List summary of existing buckets in OCI object storage
  collections:
    - oracle.oci
  connection: local
  hosts: localhost
  tasks:
    - name: List bucket facts
      oci_object_storage_bucket_facts:
         namespace_name: '<yournamespace>'
         compartment_id: '<yourcompartmentocid>'
      register: result
    - name: Dump result
      debug: 
        msg: '{{result}}'

Execute o playbook Ansible usando o Python com este comando:

$ ansible-playbook list_buckets.yml

Informações detalhadas sobre como usar nossos módulos Ansible estão disponíveis em docs.oracle.com e readthedocs.io.

Para obter acesso a informações detalhadas sobre o uso de módulos Ansible na CLI, use o comando ansible-doc no nome do módulo. Por exemplo, para obter a documentação do módulo oci_object_storage_bucket_facts, execute o seguinte comando:

$ ansible-doc oracle.oci.oci_object_storage_bucket_facts

Ao criar e configurar recursos da Oracle Cloud Infrastructure, os módulos do Ansible usam informações de autenticação descritas no Arquivo de Configuração da CLI e do SDK.

Os módulos Ansible permitem que você substitua as informações de autenticação especificadas no arquivo de configuração do SDK usando as opções do módulo e as variáveis de ambiente. A documentação para substituições de autenticação é fornecida internamente, conforme descrito em Como Obter a Documentação do Módulo. No entanto, o uso de variáveis de ambiente e de opções de módulo Ansible para substituir informações de autenticação deve ser evitado em cenários de produção.

Recomendamos o uso de arquivos para especificar informações de autenticação do Oracle Cloud Infrastructure SDK. Para suportar vários usuários, use o recurso "perfis" no arquivo de configuração do SDK. Ao distribuir atribuições que usam módulos Ansible, certifique-se de que nenhuma credencial do serviço IAM esteja incluída com as atribuições.

• Usando coleções