Oracle Cloud Infrastructure Ansible Collection provides an easy way to provision and manage resources in Oracle Cloud using Ansible.

This collection replaces the legacy modules. Refer to the Migration Guide for best migration practices.

Ansible released Collections as part of the Ansible 2.9 release. Ansible recommends Collections as the recommended method of packaging and releasing modules. With the creation of Oracle Cloud Ansible Collection, we are providing two user benefits:

• Faster Availability - Oracle Cloud Ansible Modules will now be available to users at a faster pace on Ansible Galaxy.
• Wider Coverage - This summer, we aim to provide support for all the Oracle Cloud resources

Please expect a few breaking changes as we transition from legacy modules to the new collection modules. Also, the new modules are renamed to use the service name as a prefix. We recommend you to refer to the Migration Guide as you plan to migrate.

As we gradually make progress to provide full coverage of Oracle Cloud resources, you might not find all the familiar modules (that we support in the legacy modules) in the new collection. In that case, you may choose to use the legacy modules as a workaround for the time being.

We have also added a new User Guide to highlight new features and best practices for using the new modules.

• Block Volume
• Compute/Compute Management
• Database
• Networking
• Container Engine for Kubernetes Service (OKE)
• Identity and Access Management (IAM)
• Load Balancing
• Object Storage
• File Storage
• Audit
• Autoscaling
• Budget/Account management
• Health Checks
• Vault Secret and Key Management (KMS)
• Domain Name System (DNS)
• Email
• Marketplace
• Monitoring
• Notifications
• Streaming
• Functions
• OS Management
• Resource Manager
• Announcement
• Integration
• NoSQL
• Events
• Service Limits
• API Gateway
• Content and Experience
• Analytics
• Web Application Acceleration and Security Services
• Limits
• Data Science
• Data Safe
• Data Catalog
• Data Flow
• Search
• Digital Assistant Instance
• MySQL
• Big Data
• Usage

You can install it from Ansible Galaxy using the command:

$ ansible-galaxy collection install oracle.oci

Notes:

• Collections is supported in Ansible 2.9+.
• For more information about collections, please check Ansible Collections
• To update the modules to latest version, use the install --force flag.

The Oracle Cloud Ansible modules are built using the Oracle Cloud Infrastructure Python SDK.

Install OCI Python SDK:

$ yum -y install oraclelinux-developer-release-el7 && yum -y install python-oci-sdk
or
$ pip install oci

The modules honor the SDK configuration when available.

The project includes a catalog of Oracle Cloud Infrastructure Ansible module samples that illustrate using the modules to carry out common infrastructure provisioning and configuration tasks. The samples are organized in groups associated with Oracle Cloud Infrastructure services under the samples directory on GitHub. Begin by reviewing the Readme.md file that you will find in each sample's root directory.

Module documentation is found here
To view the module documentation, use this command:

ansible-doc oracle.oci.[module_name]

General documentation for legacy and new modules can be found here.

See the "Questions or Feedback" section.

See CHANGELOG.

This is an open source project. See CONTRIBUTING for details.

Oracle gratefully acknowledges the contributions to oci-ansible-collections that have been made by the community.

You can find information on any known issues on GitHub issues page.

Copyright (c) 2020, Oracle and/or its affiliates.

This software is made available to you under the terms of the GPL 3.0 license or the Apache 2.0 license.

See LICENSE.txt for more details.