{"id":188,"date":"2019-03-11T21:07:17","date_gmt":"2019-03-11T21:07:17","guid":{"rendered":"http:\/\/tonysbit.blog\/?p=188"},"modified":"2019-03-11T21:07:17","modified_gmt":"2019-03-11T21:07:17","slug":"friendly-guide-to-deploying-awx-upstream-project-to-ansible-tower","status":"publish","type":"post","link":"https:\/\/tonysbit.blog\/?p=188","title":{"rendered":"Friendly Guide to deploying AWX (Upstream project to Ansible Tower)"},"content":{"rendered":"\n<div class=\"wp-block-jetpack-markdown\"><h1>Summary<\/h1>\n<p>AWX is a web-based task engine built on top of ansible. This guide will walk you through installing AWX on a fresh CentOS7 machine. In this guide Docker is used without Docker-compose and the bare-minimum options were selected to get the application up and running. Please refer to the <a href=\"https:\/\/github.com\/ansible\/awx\/blob\/devel\/INSTALL.md\">official guide<\/a> for more information or options.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-jetpack-markdown\"><h1>Prerequisites<\/h1>\n<p><strong>Virtual Machine Specs<\/strong><\/p>\n<ul>\n<li>At least 4GB of memory<\/li>\n<li>At least 2 cpu cores<\/li>\n<li>At least 20GB of space<\/li>\n<li>Centos7 Image<\/li>\n<\/ul>\n<\/div>\n\n\n\n<div class=\"wp-block-jetpack-markdown\"><h1>Checklist<\/h1>\n<ol>\n<li>Operating System\n<ul>\n<li>[ ] Update OS<\/li>\n<li>[ ] Install Git<\/li>\n<li>[ ] Clone AWX<\/li>\n<li>[ ] Install Ansible<\/li>\n<li>[ ] Install Docker<\/li>\n<li>[ ] Install Docker-py<\/li>\n<li>[ ] Install GNU Make<\/li>\n<\/ul>\n<\/li>\n<li>Config File\n<ul>\n<li>[ ] Edit Postgres settings<\/li>\n<\/ul>\n<\/li>\n<li>Build and Run\n<ul>\n<li>[ ] Start Docker<\/li>\n<li>[ ] Run Installer<\/li>\n<\/ul>\n<\/li>\n<li>Access AWX\n<ul>\n<li>[ ] Open up port 80<\/li>\n<li>[ ] Enjoy<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<\/div>\n\n\n\n<div class=\"wp-block-jetpack-markdown\"><h1>1. Operating System<\/h1>\n<p>All commands are assumed to be run as root.<\/p>\n<p>If you are not already logged in as root, sudo before getting started<\/p>\n<p><code>sudo su -<\/code><\/p>\n<h2>Update OS<\/h2>\n<ol>\n<li>\n<p>Make sure your &#8216;\/etc\/resolv.conf&#8217; file can resolve dns. Example resolv.conf file<\/p>\n<pre><code>nameserver 8.8.8.8\n<\/code><\/pre>\n<\/li>\n<li>\n<p>Run<\/p>\n<p><code>yum update<\/code><\/p>\n<p><em>Note<\/em>: If you are still unable to run a update you may need to clear your local cache.<\/p>\n<p><code>yum clean all &amp;&amp; yum makecache<\/code><\/p>\n<\/li>\n<\/ol>\n<\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" width=\"374\" height=\"267\" src=\"https:\/\/tonysbit.files.wordpress.com\/2019\/03\/os-info.png?resize=374%2C267\" alt=\"\" class=\"wp-image-189\" srcset=\"https:\/\/i0.wp.com\/tonysbit.blog\/wp-content\/uploads\/2019\/03\/os-info.png?w=374&amp;ssl=1 374w, https:\/\/i0.wp.com\/tonysbit.blog\/wp-content\/uploads\/2019\/03\/os-info.png?resize=300%2C214&amp;ssl=1 300w\" sizes=\"auto, (max-width: 374px) 100vw, 374px\" \/><\/figure><\/div>\n\n\n\n<div class=\"wp-block-jetpack-markdown\"><h2>Install Git<\/h2>\n<ol start=\"3\">\n<li>\n<p>Install Git<\/p>\n<p><code>yum install git<\/code><\/p>\n<\/li>\n<\/ol>\n<h2>Clone AWX<\/h2>\n<ol start=\"4\">\n<li>\n<p>Make a new directory and change to that directory<\/p>\n<p><code>cd \/usr\/local<\/code><\/p>\n<\/li>\n<li>\n<p>Clone the official git repository to the working directory<\/p>\n<p><code>git clone https:\/\/github.com\/ansible\/awx.git<\/code><\/p>\n<p><code>cd \/usr\/local\/awx<\/code><\/p>\n<\/li>\n<\/ol>\n<h2>Install Ansible<\/h2>\n<ol start=\"6\">\n<li>\n<p>Download and install ansible<\/p>\n<p><code>yum install ansible<\/code><\/p>\n<p><a href=\"https:\/\/www.cyberciti.biz\/python-tutorials\/linux-tutorial-install-ansible-configuration-management-and-it-automation-tool\/\">Unofficial Reference Documentation<\/a><\/p>\n<\/li>\n<\/ol>\n<h2>Install Docker<\/h2>\n<ol start=\"7\">\n<li>\n<p>Download yum-utils<\/p>\n<pre><code>sudo yum install -y yum-utils \\\ndevice-mapper-persistent-data \\\nlvm2\n<\/code><\/pre>\n<\/li>\n<li>\n<p>Set up the repository<\/p>\n<pre><code>sudo yum-config-manager \\\n\t--add-repo \\\n\thttps:\/\/download.docker.com\/linux\/centos\/docker-ce.repo\n<\/code><\/pre>\n<\/li>\n<li>\n<p>Install the latest version of Docker CE<\/p>\n<p><code>sudo yum install docker-ce docker-ce-cli containerd.io<\/code><\/p>\n<p><a href=\"https:\/\/docs.docker.com\/install\/linux\/docker-ce\/centos\/\">Official Reference Documentation<\/a><\/p>\n<\/li>\n<\/ol>\n<h2>Install Docker-py<\/h2>\n<ol start=\"10\">\n<li>\n<p>Enable the EPEL repository<\/p>\n<p><code>yum install epel-release<\/code><\/p>\n<\/li>\n<li>\n<p>Install PIP<\/p>\n<p><code>yum install python-pip<\/code><\/p>\n<p><a href=\"https:\/\/www.tecmint.com\/install-pip-in-linux\/\">Unofficial Reference Documentation<\/a><\/p>\n<\/li>\n<li>\n<p>Using pip install docker-py<\/p>\n<p><code>pip install docker-py<\/code><\/p>\n<p><a href=\"https:\/\/pypi.org\/project\/docker-py\/\">Official Reference Documentation<\/a><\/p>\n<\/li>\n<\/ol>\n<h2>Install GNU Make<\/h2>\n<ol start=\"13\">\n<li>\n<p>Make should already be included in the OS, this can be verified using<\/p>\n<p><code>make --version<\/code><\/p>\n<p>If it has not been installed you can run<\/p>\n<p><code>yum install make<\/code><\/p>\n<\/li>\n<\/ol>\n<\/div>\n\n\n\n<div class=\"wp-block-jetpack-markdown\"><h1>2. Config File<\/h1>\n<h2>Edit Postgres Settings<\/h2>\n<p><em>Note<\/em>: We will persist the PostgresDB to a custom directory.<\/p>\n<ol start=\"15\">\n<li>\n<p>Make the directory<\/p>\n<p><code>mkdir \/etc\/awx<\/code><\/p>\n<p><code>mkdir \/etc\/awx\/db<\/code><\/p>\n<\/li>\n<li>\n<p>Edit the inventory file<\/p>\n<p><code>vi \/usr\/local\/awx\/installer\/inventory<\/code><\/p>\n<p>Find the entry that says &quot;#postgres_data_dir&quot; and replace it with<\/p>\n<p><code>postgres_data_dir=\/etc\/awx\/db<\/code><\/p>\n<p>Save changes<\/p>\n<p><em>Note<\/em>: As of 12\/03\/2019, there is a <a href=\"https:\/\/github.com\/ansible\/awx\/issues\/3304\">bug<\/a> running with docker, to overcome the bug you need to find in the inventory &quot;#pg_sslmode=require&quot; and replace it with<\/p>\n<p><code>pg_sslmode=disable<\/code><\/p>\n<\/li>\n<\/ol>\n<h1>3. Build<\/h1>\n<h2>Start docker<\/h2>\n<ol start=\"17\">\n<li>\n<p>Start the docker service<\/p>\n<p><code>systemctl start docker<\/code><\/p>\n<\/li>\n<\/ol>\n<h2>Run installer<\/h2>\n<ol start=\"18\">\n<li>\n<p>Change to the right path<\/p>\n<p><code>cd \/usr\/local\/awx\/installer\/<\/code><\/p>\n<\/li>\n<li>\n<p>Run the installer<\/p>\n<p><code>ansible-playbook -i inventory install.yml<\/code><\/p>\n<p><em>Note<\/em>: You can track progress by running<\/p>\n<p><code>docker logs -f awx_task<\/code><\/p>\n<\/li>\n<\/ol>\n<\/div>\n\n\n\n<figure class=\"wp-block-image\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" width=\"640\" height=\"78\" src=\"https:\/\/tonysbit.files.wordpress.com\/2019\/03\/ansible-confirmation.png?resize=640%2C78\" alt=\"\" class=\"wp-image-191\" srcset=\"https:\/\/i0.wp.com\/tonysbit.blog\/wp-content\/uploads\/2019\/03\/ansible-confirmation.png?w=722&amp;ssl=1 722w, https:\/\/i0.wp.com\/tonysbit.blog\/wp-content\/uploads\/2019\/03\/ansible-confirmation.png?resize=300%2C37&amp;ssl=1 300w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/figure>\n\n\n\n<div class=\"wp-block-jetpack-markdown\"><h1>4. Access AWX<\/h1>\n<h2>Open up port 80<\/h2>\n<ol start=\"20\">\n<li>\n<p>Check if firewalld is turned on, if it is not it is recommended<\/p>\n<p>To check:<\/p>\n<p><code>systemctl status firewalld<\/code><\/p>\n<p>To start:<\/p>\n<p><code>systemcl start firewalld<\/code><\/p>\n<\/li>\n<li>\n<p>Open up port 80<\/p>\n<p><code>firewall-cmd --permanent --add-port=80\/tcp<\/code><\/p>\n<p><code>firewall-cmd --reload<\/code><\/p>\n<\/li>\n<\/ol>\n<h1>Enjoy<\/h1>\n<ol start=\"22\">\n<li>\n<p>You can now browse your host IP and access and enjoy &quot;http:\/\/&lt;your host ip&gt;&quot;!<\/p>\n<p><em>Note<\/em>: Default username is &quot;admin&quot; and password is &quot;password&quot;<\/p>\n<\/li>\n<\/ol>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>AWX is a web-based task engine built on top of ansible. This guide will walk you through installing AWX on a fresh CentOS7 machine. <\/p>\n","protected":false},"author":1,"featured_media":192,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"nf_dc_page":"","jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[5,6,10,13],"tags":[],"class_list":["post-188","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops","category-docker","category-linux","category-software-development"],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/tonysbit.blog\/wp-content\/uploads\/2019\/03\/awx.png?fit=1913%2C768&ssl=1","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tonysbit.blog\/index.php?rest_route=\/wp\/v2\/posts\/188","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tonysbit.blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tonysbit.blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tonysbit.blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tonysbit.blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=188"}],"version-history":[{"count":0,"href":"https:\/\/tonysbit.blog\/index.php?rest_route=\/wp\/v2\/posts\/188\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tonysbit.blog\/index.php?rest_route=\/wp\/v2\/media\/192"}],"wp:attachment":[{"href":"https:\/\/tonysbit.blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=188"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tonysbit.blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=188"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tonysbit.blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=188"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}