{"id":13567116,"url":"https://github.com/oracle/oci-ansible-collection","last_synced_at":"2025-05-16T11:04:33.221Z","repository":{"id":38197344,"uuid":"258269984","full_name":"oracle/oci-ansible-collection","owner":"oracle","description":"Oracle Cloud Infrastructure Ansible Collection provides an easy way to provision and manage resources in Oracle Cloud using Ansible.","archived":false,"fork":false,"pushed_at":"2025-02-19T09:27:10.000Z","size":422968,"stargazers_count":178,"open_issues_count":29,"forks_count":99,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-09T07:01:37.734Z","etag":null,"topics":["ansible","cloud","oracle","oracle-cloud-infrastructure"],"latest_commit_sha":null,"homepage":"https://docs.cloud.oracle.com/iaas/Content/API/SDKDocs/ansible.htm","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-23T16:48:27.000Z","updated_at":"2025-04-04T04:32:26.000Z","dependencies_parsed_at":"2023-02-17T18:31:21.481Z","dependency_job_id":"65a31846-03d1-49f3-ada5-de754abac7e4","html_url":"https://github.com/oracle/oci-ansible-collection","commit_stats":null,"previous_names":[],"tags_count":115,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Foci-ansible-collection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Foci-ansible-collection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Foci-ansible-collection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Foci-ansible-collection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle","download_url":"https://codeload.github.com/oracle/oci-ansible-collection/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254518384,"owners_count":22084374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","cloud","oracle","oracle-cloud-infrastructure"],"created_at":"2024-08-01T13:02:24.075Z","updated_at":"2025-05-16T11:04:28.212Z","avatar_url":"https://github.com/oracle.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Oracle Cloud Infrastructure Ansible Collection\n\nOracle Cloud Infrastructure Ansible Collection provides an easy way to provision and manage resources in Oracle Cloud using Ansible.\n\n\u003e **This collection replaces the [legacy modules](https://github.com/oracle/oci-ansible-modules). Refer to the [Migration Guide](https://github.com/oracle/oci-ansible-collections/blob/master/MigrationGuide.md) for best migration practices.**\n\nAnsible [released Collections](https://www.ansible.com/blog/getting-started-with-ansible-collections) as part of the Ansible 2.9 release.\nAnsible recommends Collections as the recommended method of packaging and releasing modules. \nWith the creation of Oracle Cloud Ansible Collection, we are providing two user benefits:\n * **Faster Availability** - Oracle Cloud Ansible Modules will now be available to users at a faster pace on Ansible Galaxy. \n * **Wider Coverage** - Support for the majority of the Oracle Cloud services.\n\nWe have also added a new [User Guide](https://github.com/oracle/oci-ansible-collections/blob/master/UserGuide.md) to highlight new features and best practices for using the new modules.\n\n### Migration from Legacy Modules\n\nWe recommend migrating from the [legacy modules](https://github.com/oracle/oci-ansible-modules) since they will be deprecated in the near future.\nPlease expect a few breaking changes while migrating from legacy modules to the new collection modules.\nWe recommend you to refer to the [Migration Guide](https://github.com/oracle/oci-ansible-collections/blob/master/MigrationGuide.md) for breaking changes.\nAlso, the new modules are renamed to use the service name as a prefix.\n\n#### Currently Supported Services \nWe support almost all the of [OCI Cloud services](https://docs.cloud.oracle.com/en-us/iaas/Content/services.htm) with very few exceptions.\nFor the complete list of supported services, please check the [modules list](https://docs.oracle.com/en-us/iaas/tools/oci-ansible-collection/latest/collections/oracle/oci/index.html).\n\n## Installation\n\n### Pre-requisites\n**python\u003e=3.6**\n#### Oracle Linux 7\n\n```\nsudo yum-config-manager --enable ol7_developer\nsudo yum-config-manager --enable ol7_developer_EPEL\nsudo yum install oci-ansible-collection\n```\n#### Oracle Linux 8\n\n```\nsudo yum-config-manager --enable ol8_developer\nsudo yum-config-manager --enable ol8_developer_EPEL\nsudo yum install oci-ansible-collection\n```\n\n#### Linux/macOS\n\n```\ncurl -L https://raw.githubusercontent.com/oracle/oci-ansible-collection/master/scripts/install.sh | bash -s -- --verbose\n```\n#### For more info about installation and troubleshooting check the [Installation Guide](https://github.com/oracle/oci-ansible-collections/blob/master/InstallationGuide.md).\n\n## Samples and Solutions\n\nThe project includes a catalog of Oracle Cloud Infrastructure Ansible module samples that illustrate using the modules \nto carry out common infrastructure provisioning and configuration tasks.\n* The samples are organized in groups associated with Oracle Cloud Infrastructure services under [the samples directory on GitHub](https://github.com/oracle/oci-ansible-collections/tree/master/samples).\nBegin by reviewing the Readme.md file that you will find in each sample's root directory.\n* The solutions are available under [the solutions directory on GitHub](https://github.com/oracle/oci-ansible-collections/tree/master/solutions)\n\n## Documentation\n\nModule HTML documentation is available on [Oracle Docs](https://docs.oracle.com/en-us/iaas/tools/oci-ansible-collection/latest/collections/oracle/oci/index.html).\n\nTo view the module documentation, use this command:\n  ``` bash\nansible-doc oracle.oci.[module_name]\n  ```\nGeneral documentation can be found [here](https://docs.cloud.oracle.com/iaas/Content/API/SDKDocs/ansible.htm).\n\n## Ansible Tower and AWX\nOracle Cloud Infrastructure Ansible Collection supports Ansible Tower and AWX. For more information on how to setup the collection with Ansible Tower, follow the [instructions in this blog](https://blogs.oracle.com/cloud-infrastructure/using-oracle-cloud-infrastructure-with-ansible-tower-and-awx).\nTo install the Ansible Tower free version (AWX) on an OCI instance, use this [solution](https://github.com/oracle-quickstart/oci-ansible-awx).\n\n## Help\n- For FAQs, check the [Frequently Asked Questions](https://github.com/oracle/oci-ansible-collections/blob/master/FAQ.md) page.\n- For commmon issues, check the [Common Issues](https://github.com/oracle/oci-ansible-collections/blob/master/COMMON_ISSUES.md) page.\n- To file bugs or feature requests, use [GitHub issues](https://github.com/oracle/oci-ansible-collections/issues).\n- For other channels, check the [\"Questions or Feedback\"](https://docs.cloud.oracle.com/en-us/iaas/Content/API/SDKDocs/ansible.htm#questions) section.\n\n## Changes\n\nSee [CHANGELOG](https://github.com/oracle/oci-ansible-collections/blob/master/CHANGELOG.md).\n\n## Contributing\n\nThis project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)\n\n## Security\n\nPlease consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process\n\n## Known Issues\n\nYou can find information on any known issues on [Known Issues](https://github.com/oracle/oci-ansible-collections/blob/master/KNOWN_ISSUES.md) or [GitHub issues](https://github.com/oracle/oci-ansible-collections/issues) page.\n\n## License\n\nCopyright (c) 2020,  2023 Oracle and/or its affiliates.\n\nThis software is made available to you under the terms of the GPL 3.0 license or the Apache 2.0 license.\n\nSee [LICENSE.txt](https://github.com/oracle/oci-ansible-collections/blob/master/LICENSE.txt) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Foci-ansible-collection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle%2Foci-ansible-collection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Foci-ansible-collection/lists"}