開始

• Oracle Cloud Infrastructureアカウントが必要です。
• そのアカウントのユーザーを、アカウントのコンパートメントのリソースの操作に必要な権限を付与するポリシーがあるセキュリティ・グループに含めます。ガイダンスは、ポリシーの仕組みを参照してください。
• 必要な資格証明およびOCIDの情報が必要です。

Oracle Linux 7またはOracle Linux 8を実行している場合は、yumを使用してOracle Cloud Infrastructure AnsibleコレクションRPMをインストールできます。

AnsibleコレクションRPMでは、OCI Ansibleコレクションとそれに必要な依存関係(OCI SDK for PythonおよびAnsible)がインストールされます。

次のコマンドのいずれかを使用して、Oracle Linux開発者リポジトリを有効にし、ご使用のOracle Linuxのバージョンに応じてAnsibleコレクションRPMをインストールします。

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

RPMをインストールした後で、認証の構成の説明に従って、SDKおよびCLI構成ファイルを構成する必要があります。

ansible-3 localhost -m oracle.oci.oci_object_storage_namespace_facts

ansible localhost -m oracle.oci.oci_object_storage_namespace_facts

サンプル・プレイブックは、Oracle Cloud Infrastructure AnsibleコレクションGitHubプロジェクトで入手できます。サンプル・ライブラリは、定期的に新しいサンプルが追加されて更新されています。詳細は、Ansibleプレイブックの例を参照してください。

インストールが完了した後で、またはクラウド・シェルを使用している場合に、Ansibleモジュールを使用するサンプル・プレイブックを作成できます。次に示すプレイブックの例(list_buckets.yml)は、oci_bucket_factsモジュールを使用して、コンパートメントのバケットに関連する事実をフェッチします。

---
- 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}}'

次のコマンドを呼び出して、Pythonを使用してAnsibleプレイブックを実行します:

$ ansible-playbook list_buckets.yml

Ansibleモジュールの使用方法の詳細は、docs.oracle.comおよびreadthedocs.ioを参照してください。

CLIでのAnsibleモジュールの使用に関する詳細情報にアクセスするには、モジュールの名前に対してansible-docコマンドを使用します。たとえば、oci_object_storage_bucket_factsモジュールのドキュメントを取得するには、次のコマンドを実行します:

$ ansible-doc oracle.oci.oci_object_storage_bucket_facts

Oracle Cloud Infrastructureリソースを作成および構成するとき、Ansibleモジュールでは、SDKおよびCLIの構成ファイルに示されている認証情報を使用します。

Ansibleモジュールでは、モジュール・オプションと環境変数を使用して、SDK構成ファイルに指定された認証情報をオーバーライドできます。認証オーバーライドのドキュメントは、モジュール・ドキュメントの取得方法で説明されているように、内部で提供されます。ただし、環境変数およびAnsibleモジュール・オプションを使用した認証情報のオーバーライドは、本番シナリオでは避ける必要があります。

認証情報の指定にはOracle Cloud Infrastructure SDK構成ファイルの使用をお薦めします。複数のユーザーをサポートするには、SDK構成ファイルで「プロファイル」機能を使用します。Ansibleモジュールを使用するロールを配布するときは、IAM資格証明がロールに含まれていないことを確認します。

• コレクションの使用