From b3af7b7d51881f7877e958f8f9d85ac92dcf5aa7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=85=AD=E5=BC=80=E7=AE=B1?= Date: Mon, 5 Jun 2023 22:18:48 +0800 Subject: [PATCH] =?UTF-8?q?[=E6=89=8B=E5=8A=A8=E9=80=89=E9=A2=98][tech]:?= =?UTF-8?q?=2020230524.1=20=E2=AD=90=EF=B8=8F=E2=AD=90=EF=B8=8F=20How=20to?= =?UTF-8?q?=20Install=20Ansible=20AWX=20on=20Kubernetes=20Cluster.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...ow to Install Ansible AWX on Kubernetes Cluster.md | 279 ++++++++++++++++++ 1 file changed, 279 insertions(+) create mode 100644 sources/tech/20230524.1 ⭐️⭐️ How to Install Ansible AWX on Kubernetes Cluster.md diff --git a/sources/tech/20230524.1 ⭐️⭐️ How to Install Ansible AWX on Kubernetes Cluster.md b/sources/tech/20230524.1 ⭐️⭐️ How to Install Ansible AWX on Kubernetes Cluster.md new file mode 100644 index 0000000000..500374f354 --- /dev/null +++ b/sources/tech/20230524.1 ⭐️⭐️ How to Install Ansible AWX on Kubernetes Cluster.md @@ -0,0 +1,279 @@ +[#]: subject: "How to Install Ansible AWX on Kubernetes Cluster" +[#]: via: "https://www.linuxtechi.com/install-ansible-awx-on-kubernetes-cluster/" +[#]: author: "Pradeep Kumar https://www.linuxtechi.com/author/pradeep/" +[#]: collector: "lkxed" +[#]: translator: " " +[#]: reviewer: " " +[#]: publisher: " " +[#]: url: " " + +How to Install Ansible AWX on Kubernetes Cluster +====== + +In this post, we will show you how to install Ansible AWX on Kubernetes (k8s) cluster step by step. + +Ansible AWX is a powerful open-source tool for managing and automating IT infrastructure. AWX provides a graphical user interface for Ansible, allowing you to easily create, schedule, and run Ansible playbooks. + +Kubernetes, on the other hand, is a popular container orchestration platform that is widely used for deploying and managing containerized applications. + +##### Prerequisites + +- Kubernetes cluster +- Kubectl +- A regular user with sudo rights and cluster admin rights +- Internet connectivity + +### Step :1 Install helm + +In case you, helmis installed on your system then run beneath commands to install, + +``` +$ curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 +$ chmod +x get_helm.sh +$ ./get_helm.sh +$ helm version +``` + +![Install-helm-linux-command-line][1] + +### Step 2: Install the AWX chart + +The easiest way to install AWX on Kubernetes is by using the AWX Helm chart. So, to install AWX via chart, first add its repository using following helm command. + +``` +$ helm repo add awx-operator https://ansible.github.io/awx-operator/ +"awx-operator" has been added to your repositories +$ +``` + +Note: If you had already added this repository before, then run beneath command to get latest version of packages. + +``` +$ helm repo update +``` + +To install awx-operator via chart, run + +``` +$ helm install ansible-awx-operator awx-operator/awx-operator -n awx --create-namespace +``` + +![helm-install-awx-operator-kubernetes][2] + +This will download the AWX chart and install it on your Kubernetes cluster in awx namespace.The installation process may take a few minutes, so be patient. + +### Step 3: Verify AWX operator installation + +After the successful installation, you can verify AWX operator status by running below command + +``` +$ sudo kubectl get pods -n awx +``` + +You should see something like this: + +![awx-operator-pod-status-kubectl][3] + +### Step:4 Create PV, PVC and deploy AWX yaml file + +AWX requires persistent volume for postgres pod. So, let’s first create a storage class for local volume + +Note: In this post, I am using local file system as persistent volume. + +``` +$ vi local-storage-class.yaml +apiVersion: storage.k8s.io/v1 +kind: StorageClass +metadata: +  name: local-storage +  namespace: awxprovisioner: kubernetes.io/no-provisioner +volumeBindingMode: WaitForFirstConsumer +``` + +Save and close the file and then run , + +``` +$ kubectl create -f local-storage-class.yaml +$ kubectl get sc -n awx +NAME            PROVISIONER                    RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   +local-storage   kubernetes.io/no-provisioner   Delete          WaitForFirstConsumer   false                 +$ +``` + +Next create persistent volume(pv) using following pv.yaml file, + +``` +$ vi pv.yaml +apiVersion: v1 +kind: PersistentVolume +metadata: +  name: postgres-pv +  namespace: awx +spec: +  capacity: +    storage: 10Gi +  volumeMode: Filesystem +  accessModes: +  - ReadWriteOnce +  persistentVolumeReclaimPolicy: Delete +  storageClassName: local-storage +  local: +    path: /mnt/storage +  nodeAffinity: +    required: +      nodeSelectorTerms: +      - matchExpressions: +        - key: kubernetes.io/hostname +          operator: In +          values: +          - k8s-worker +``` + +Save & exit the file. + +![Postgres-pv-awx-kubernetes][4] + +Important note : Make sure folder “/mnt/storage” exists on worker node, if it does not exist then create it using mkdir command on worker node. In our case worker node is “k8s-worker” + +Execute the beneath command to create postgres-pv in awx namespace. + +``` +$ kubectl create -f pv.yaml +``` + +Once pv is created successfully then create persistentvolumecliam using pvc.yaml file, + +``` +$ vi  pvc.yaml +apiVersion: v1 +kind: PersistentVolumeClaim +metadata: +  name: postgres-13-ansible-awx-postgres-13-0 +  namespace: awx +spec: +  storageClassName: local-storage +  accessModes: +    - ReadWriteOnce +  resources: +    requests: +      storage: 10Gi +``` + +![posgres-pvc-awx-kubernetes][5] + +To create pvc, run following kubectl command + +``` +$ kubectl create -f pvc.yaml +``` + +Verify the status of pv and pvc using beneath command + +``` +$ kubectl get pv,pvc -n awx +``` + +Now, we are all set to deploy AWX instance. Create an ansible-awx.yaml file with following content + +``` +$ vi ansible-awx.yaml +--- +apiVersion: awx.ansible.com/v1beta1 +kind: AWX +metadata: +  name: ansible-awx +  namespace: awx +spec: +  service_type: nodeport +  postgres_storage_class: local-storage +``` + +![Ansible-awx-yaml-file][6] + +save and close the file. + +Execute following kubectl command to deploy awx instance, + +``` +$ kubectl create -f ansible-awx.yaml +``` + +Wait for couple of minutes and then check pods status in awx namespace. + +``` +$ kubectl get pods -n awx +``` + +![Ansible-AWX-Pods-Status-Kubernetes][7] + +### Step 5: Access AWX Web Interface + +To access the AWX web interface, you need to create a service that exposes the awx-web deployment: + +``` +$ kubectl expose deployment ansible-awx-web --name ansible-awx-web-svc --type NodePort -n awx +``` + +This command will create a NodePort service that maps the AWX web container’s port to a port on the Kubernetes node. You can find the port number by running: + +``` +$ kubectl get svc ansible-awx-web-svc  -n awx +``` + +This will output something like this: + +``` +NAME              TYPE       CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE +ansible-awx-web-svc   NodePort   10.99.83.248           8052:32254/TCP   82s +``` + +In this example, the web service is available on port 32254. + +![Expose-Ansible-AWX-Web-NodePort-Kubernetes][8] + +By default, the admin user is admin for web interface and the password is available in the -admin-password secret. To retrieve the admin password, run + +``` +$ kubectl get secrets -n awx | grep -i admin-password +ansible-awx-admin-password        Opaque               1      109m +$ +$ kubectl get secret ansible-awx-admin-password -o jsonpath="{.data.password}" -n awx | base64 --decode ; echo +l9mWcIOXQhSKnzZQyQQ9LZf3awDV0YMJ +$ +``` + +You can now access the AWX web interface by opening a web browser and navigating to `http://:/`. In the example above, the URL would be + +http://192.168.1.223:3225 + +![AWX-Login-URL-Kubernetes][9] + +Click on Log In after entering the credentials. + +![Ansible-AWX-Web-Dashboard][10] + +Congratulations! You have successfully installed Ansible AWX on Kubernetes. You can now use AWX to automate your IT infrastructure and make your life as a sysadmin easier. + +-------------------------------------------------------------------------------- + +via: https://www.linuxtechi.com/install-ansible-awx-on-kubernetes-cluster/ + +作者：[Pradeep Kumar][a] +选题：[lkxed][b] +译者：[译者ID](https://github.com/译者ID) +校对：[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 + +[a]: https://www.linuxtechi.com/author/pradeep/ +[b]: https://github.com/lkxed/ +[1]: https://www.linuxtechi.com/wp-content/uploads/2023/05/Install-helm-linux-command-line.png?ezimgfmt=rs%3Adevice%2Frscb22-1 +[2]: https://www.linuxtechi.com/wp-content/uploads/2023/05/helm-install-awx-operator-kubernetes.png +[3]: https://www.linuxtechi.com/wp-content/uploads/2023/05/awx-operator-pod-status-kubectl.png +[4]: https://www.linuxtechi.com/wp-content/uploads/2023/05/Postgres-pv-awx-kubernetes.png +[5]: https://www.linuxtechi.com/wp-content/uploads/2023/05/posgres-pvx-awx-kubernetes.png +[6]: https://www.linuxtechi.com/wp-content/uploads/2023/05/Ansible-awx-yaml-file.png +[7]: https://www.linuxtechi.com/wp-content/uploads/2023/05/Ansible-AWX-Pods-Status-Kubernetes.png +[8]: https://www.linuxtechi.com/wp-content/uploads/2023/05/Expose-Ansible-AWX-Web-NodePort-Kubernetes.png +[9]: https://www.linuxtechi.com/wp-content/uploads/2023/05/AWX-Login-URL-Kubernetes.png +[10]: https://www.linuxtechi.com/wp-content/uploads/2023/05/Ansible-AWX-Web-Dashboard.png \ No newline at end of file