{"id":18802338,"url":"https://github.com/oracle-quickstart/oci-ansible-awx","last_synced_at":"2025-04-13T18:31:35.698Z","repository":{"id":106379487,"uuid":"298418532","full_name":"oracle-quickstart/oci-ansible-awx","owner":"oracle-quickstart","description":"OCI Resource Manager stack to deploy Ansible AWX into a Compute instance under docker.","archived":true,"fork":false,"pushed_at":"2021-06-10T19:55:15.000Z","size":772,"stargazers_count":11,"open_issues_count":0,"forks_count":8,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-21T06:43:56.374Z","etag":null,"topics":["ansible","awx","oci","oracle-led"],"latest_commit_sha":null,"homepage":"","language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle-quickstart.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-24T23:30:04.000Z","updated_at":"2024-07-05T09:48:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"414f26bc-fae7-4a36-8587-33160361f804","html_url":"https://github.com/oracle-quickstart/oci-ansible-awx","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-ansible-awx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-ansible-awx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-ansible-awx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-ansible-awx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle-quickstart","download_url":"https://codeload.github.com/oracle-quickstart/oci-ansible-awx/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248760371,"owners_count":21157346,"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","awx","oci","oracle-led"],"created_at":"2024-11-07T22:27:32.686Z","updated_at":"2025-04-13T18:31:35.682Z","avatar_url":"https://github.com/oracle-quickstart.png","language":"HCL","funding_links":[],"categories":["ansible"],"sub_categories":[],"readme":"# Ansible AWX on Oracle Cloud Infrastructure\n\nAnsible AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is the upstream project for [Tower](https://www.ansible.com/products/tower), a commercial derivative of AWX.\n\nThis solution creates an OCI compute instance and deploys AWX on it. The solution can be deployed using OCI resource manager.\n\n# Quick Start\n\n[![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)](https://console.us-phoenix-1.oraclecloud.com/resourcemanager/stacks/create?region=home\u0026zipUrl=https://github.com/oracle-quickstart/oci-ansible-awx/archive/main.zip)\n\n# Table of Contents\n\n- Current Features\n- Requirements\n- Stack Deployment\n- Accessing AWX\n- Using AWX\n- License\n\n# Current Features\n\n- Installs user determined AWX release with support for N and N-1 released major versions\n- User determined credentials to manage AWX, PostgreSQL, and the AWX Secret key\n- Backup \u0026 Restore is supported by usage of tower-cli\n- AWX Version Upgrades may be performed via backup \u0026 restore process\n- Uses OCI Platform image Oracle Linux 7.8 from June 2020 is used and supported in all regions.\n- OCI OS Management agent is deployed (requires policy deployment)\n- Cloud Init used to enable the following: OS patch on first boot, Daily OS patch via yum-cron, OS Firewall enabled for ingress tcp/80 and tcp/443 via Firewall\n\n# Requirements\n\nAccess needed during the provisioning process: \n- https://github.com to deploy AWX via git clone\n- https://hub.docker.com to download required containers\n- https://pypi.org to download required Python2 based Ansible, Docker Compose, and supporting tools\n\n## OCI Policy Statements\n\nEnsure the user has access to OCI Resource Manager, Create VM, and Enumerate OCI VCN/Subnet resources.\n\n## OCI Networking configuration \n\nEnsure a pre-existing working VCN/Subnet/SecurityList configuration is in place with the following access:\n\n1.\tTo access AWX Web UI\n-\tIngress to 0.0.0.0/0 on tcp/80 *(If this is not enabled, the AWX website won't load)*\n-\tIngress to 0.0.0.0/0 on tcp/443 (TLS Certificate managed by LBaaS)\n\n2. To interact with OCI API, Ansible Galaxy, git repo, and other integrations\n-\tEgress to 0.0.0.0/0 on tcp/22\n-\tEgress to 0.0.0.0/0 on tcp/80\n-\tEgress to 0.0.0.0/0 on tcp/443\n\n3. To manage Linux OS (and Windows OS with native OpenSSH), recommend \n- Egress to 0.0.0.0/0 on tcp/22\n\n4. To manage Windows OS (via WinRM), recommend \n-\tEgress to 0.0.0.0/0 on tcp/5985-5986\n\n# Stack Deployment\n\n1.\tLogin to OCI, and select target Region and Compartment\n2.\tCreate VCN, Subnet, and Security List if required\n3.\tNavigate to Menu → Resource Manager → Stacks\n4.\tVerify the Region displayed in the top bar is correct, and the compartment on the left is correct for where to place the Instance, change as required\n5.\tSelect the \"Create\" button \n![Create Stack](images/awx-stack1.png)\n6. Download this github repo as a zip file (Click on Code from top right and select Download ZIP)\n7. Upload the oci-ansible-awx.zip file and fill out page 1 of the form \n![Upload zip](images/awx-stack2.png)\n\n8.\tPlease now go to next page\n9.\tPlease configure the networking parameters first. Compartment will be needed before you may select a VCN or Subnet, and they may be different values. This will accomodate the use case where network is managed by a dedicated team, and servers by a different dedicated team. If the subnet is Public, you may select the box for Public IP to be assigned. Firewall rules to lock this down will be required.\n![Network](images/awx-stack3.png)\n10.\tPlease configure the server details next. Here we select the availability domain, fault domain, shape, boot volume size, and optionally add the SSH key for \"opc\" user. It is recommended to NOT provide the SSH Key. \n![Server](images/awx-stack4.png)\n\n11.\tPlease configure the AWX values. Note that we currently have support for 3 versions of AWX, and this may change in the future. Note that these values once set, may NOT be changed for the life of this AWX instance. Changing them requires backup, destroy, create new, and restore operation.\n![AWX Config](images/awx-stack5.png)\n12.\tPlease go to the next page to review and confirm the values are as desired \n![Review](images/awx-stack6.png)\n13.\tNow press \"Create\" and the stack is ready to deploy\n14.\tNow you may \"Apply\" the configuration \n![Apply](images/awx-stack7.png)\n15.\t*Wait approximately 15-20 minutes after the apply operation completes*\n\n# Accessing AWX\n1.\tBrowse to http://\u003cpublic_ip\u003e:80 and you will now be able to access/configure users, projects, inventory, and more\nUsing AWX. For more info, check [Ansible Tower User Guide](https://docs.ansible.com/ansible-tower/latest/html/userguide/index.html).\n\n![AWX Login](images/awx-stack8.png)\n\n# License\nThe AWX source code is available under the Apache License 2.0.\n\nThe code and scripts in this solution are available under the UPL [license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-quickstart%2Foci-ansible-awx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle-quickstart%2Foci-ansible-awx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-quickstart%2Foci-ansible-awx/lists"}