Feedback incorporated

RedHatQuickCourses · Dec 12, 2024 · b617ae6 · b617ae6
1 parent 736694b
commit b617ae6
Show file tree

Hide file tree

Showing 7 changed files with 242 additions and 132 deletions.
diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc
@@ -1,9 +1,9 @@
-= Migration of AWX to AAP 2.5 
+= Migration of AWX to AAP 2.5
 :navtitle: Home
 
 Introduction:
 
-The Ansible Automation platform Application Migration: Free to Enterprise course, which aims to close the gap between enterprise-grade solutions from the open-source automation. With an emphasis on scalability, security, and advanced capabilities, this extensive course will walk you through the process of moving automation workflows from free tools to reliable corporate platforms. This training gives you the knowledge and abilities to guarantee a smooth transition, whether you're updating your automation ecosystem or bringing it into compliance with organizational requirements.
+Welcome to the Ansible Automation Platform Application Migration: Free to Enterprise course, which aims to close the gap between enterprise-grade solutions from the open-source automation. With an emphasis on scalability, security, and advanced capabilities, this course will walk you through the process of moving automation workflows from free tools to a reliable enterprise  platform. This training gives you the knowledge and abilities to guarantee a smooth transition, whether you’re updating your automation ecosystem or bringing it into compliance with organizational requirements.
 
 Duration: 40 Minutes
 
@@ -12,16 +12,16 @@ Duration: 40 Minutes
 On completing this course, you should be able to:
 
 - Implement the steps provided to guide application migration.
-- Define and discuss the necessity for AWX to AAP 2.5 migration.
+- Define and discuss the necessity for Ansible Web Executable (AWX) to Ansible Automation Platform (AAP) 2.5 migration.
 - Define the benefits of utilizing AAP 2.5 to migrate applications.
 - Diagnose and rectify known issues in AWX application migrations.
 
 == Prerequisites
 
 This course assumes that you have the following prior experience:
 
-* Knowledge on Ansible Automation Platform.
-* Foundational Knowledge of Openshift and Linux. 
+- Knowledge of Red Hat Ansible Automation Platform.
+- Foundational knowledge of Red Hat Openshift and Red Hat Enterprise Linux.
 
 == Contributors
 

diff --git a/modules/chapter1/pages/index.adoc b/modules/chapter1/pages/index.adoc
@@ -1,9 +1,9 @@
-= Migration of AWX to AAP 2.5 
+= Migration of AWX to AAP 2.5
 
-You will cover the following points: 
+You will cover the following points:
 
  - Why did we create this migration course from free to enterprise software?
  - What’s the benefit of using Ansible Automation Platform over AWX?
- - Deployment of AWX 
+ - Deployment of AWX
  - Deployment of the Ansible Automation Platform 2.5 operator
- - Migration of AWX to AAP 2.5 
+ - Migration of AWX to AAP 2.5
diff --git a/modules/chapter1/pages/section1.adoc b/modules/chapter1/pages/section1.adoc
@@ -1,6 +1,6 @@
 = Why did we create this migration course from free to enterprise software?
 
-There are several advantages to switching from a free to an enterprise software:
+There are several advantages to switching from a free to an enterprise software, including:
 
 - Increased Scalability: Supports the growing demands of expanding enterprises.
 - Enhanced Security: Advanced measures ensure data protection and compliance.
@@ -19,5 +19,4 @@ There are several advantages to switching from a free to an enterprise software:
 
 - Removal of Restrictions: Overcomes limitations common in free versions.
 
-This enables businesses to concentrate on innovation and expansion using Automation what benefits are there to use Ansible Automation platform (AAP) over Ansible Web Executable (AWX)
-
+This enables businesses to concentrate on innovation and expansion using automation.
diff --git a/modules/chapter1/pages/section2.adoc b/modules/chapter1/pages/section2.adoc
@@ -1,18 +1,18 @@
-= What’s the benefit of using Ansible Automation Platform over AWX?
- 
+= WWhat’s the benefit of using AAP over AWX?
+
 In order to do the migration its important to understand why the migration is needed. So here are the key reason why the Ansible Automation platform is better for enterprise.  
 
 
 [cols=3,3, options="header"]
 |===
 | |image:awx.png[align=center, width=100,height=120] |image:aap.png[align=center, width=80,height=100]
-| Security | Not available | Trusted chain-of-custody for certified and private content. https://www.redhat.com/en/technologies/management/ansible/gain-security-with-red-hat-ansible-automation-platform[Security hardened,window=read-later] with support, performance testing, bug fixes, and other standardized practices—for a more consistent and less vulnerable enterprise environment 
+| Security | Not available | Trusted chain-of-custody for certified and private content. https://www.redhat.com/en/technologies/management/ansible/gain-security-with-red-hat-ansible-automation-platform[Security hardened,window=read-later] with support, performance testing, bug fixes, and other standardized practices—for a more consistent and less vulnerable enterprise environment
 |Certified content and partner ecosystem | Not available | 140+ https://catalog.redhat.com/platform/red-hat-ansible[certified content collections,window=read-later] across 60+ partners. Benefit from pre-built, fully supported, and certified automation content from Red Hat and our partners.
 |Life cycle support|Not available|At least 18 months of https://access.redhat.com/support/policy/updates/ansible-automation-platform[enterprise support,window=read-later] per release. Critical bugfix and security vulnerability backporting for all components.
 |Legal protections|Not available| Intellectual property protections via the https://www.redhat.com/en/about/open-source-assurance[Open Source Assurance Agreement,window=read-later].
 |Automation analytics |Not available|https://www.redhat.com/en/technologies/management/ansible/automation-analytics-insights[Automation analytics,window=read-later] and Red Hat Insights for Ansible Automation Platform offer in-depth analytics and reporting for planning and tracking performance and adoption.
 |Upgrades and migrations|Not available|https://access.redhat.com/support/policy/updates/ansible-automation-platform[Supported migration] to major releases as well as upgrades to minor releases.
-|Training and consulting|Not available|https://www.redhat.com/en/consulting/automation[Expert resources,window=read-later] to help you build and run a successful automation practice, backed by robust https://www.redhat.com/en/technologies/management/ansible/training-and-certification[training offerings,window=read-later] and support. 
+|Training and consulting|Not available|https://www.redhat.com/en/consulting/automation[Expert resources,window=read-later] to help you build and run a successful automation practice, backed by robust https://www.redhat.com/en/technologies/management/ansible/training-and-certification[training offerings,window=read-later] and support.
 |Cloud deployment options|Not available|Managed and self-managed applications available to deploy on your cloud of choice, including https://www.redhat.com/en/technologies/management/ansible/azure[Microsoft Azure,window=read-later], https://www.redhat.com/en/technologies/management/ansible/aws[AWS,window=read-later], and https://www.redhat.com/en/technologies/management/ansible/google-cloud[Google Cloud,window=read-later]. Counts toward committed spend agreements. Supported by Red Hat with integrated billing. https://www.redhat.com/en/technologies/management/ansible/pricing[View deployment options and pricing information,window=read-later].
 |Event-Driven Ansible|Separate upstream project that requires manual integration into your environment| https://www.redhat.com/en/technologies/management/ansible/features#event-driven-ansible[Event-Driven Ansible,window=read-later] is an integrated and tested product component of Ansible Automation Platform that reduces manual tasks, delivers more efficient IT operations, and frees your teams to focus on innovation.
 |Ansible automation hub |Separate upstream project that requires manual integration into your environment| https://www.redhat.com/en/technologies/management/ansible/features#ansible-automation-hub[Ansible automation hub,window=read-later] is an integrated and tested product component of Ansible Automation Platform.

diff --git a/modules/chapter1/pages/section3.adoc b/modules/chapter1/pages/section3.adoc
@@ -1,25 +1,42 @@
-= Deployment of AWX 
+= Deployment of AWX
 
-The following Video will cover the step to step guide to deploy the AWX operator on Opensfhit system: 
+The following Video will cover the step-to-step guide to deploy the AWX operator on an OpenShift system:
 
 video::awx_deployment.mp4[align="center",width=700,height=400]
 
-
-. First create a clone of the awx-operator github repo: 
-
-   git clone https://github.com/ansible/awx-operator.git
-   cd awx-operator
-   git tag
-   git checkout tags/<tag>
-
-
-. There is a make command to create resources which will further will be used to do the awx deployment: 
-
-   make deploy
-
+. First create a clone of the awx-operator github repo:
++
+[source,bash,role=execute]
+----
+git clone https://github.com/ansible/awx-operator.git
+----
++
+[source,bash,role=execute]
+----
+cd awx-operator
+----
++
+[source,bash,role=execute]
+----
+git tag
+----
++
+[source,bash,role=execute]
+----
+git checkout tags/<tag>
+----
+
+. There is a _make_ command to create resources which will further be used to do the awx deployment:
++
+[source,bash,role=execute]
+----
+make deploy
+----
 
 . Create a file called `kustomization.yaml` with the following content to build the AWX operator image:
-
++
+.Sample output:
+----
   apiVersion: kustomize.config.k8s.io/v1beta1
   kind: Kustomization
   resources:
@@ -31,13 +48,18 @@ video::awx_deployment.mp4[align="center",width=700,height=400]
      newTag: <tag>
   # Specify a custom namespace in which to install AWX
   namespace: awx
- 
+----
 
 . Apply the changes of the `kustomization.yaml` file by running this:
-
-  oc apply -k .
-
-  Command output: 
++
+[source,bash,role=execute]
+----
+oc apply -k .
+----
++
+.Sample output:
+----
+  Command output:
   namespace/awx created
   customresourcedefinition.apiextensions.k8s.io/awxbackups.awx.ansible.com created
   customresourcedefinition.apiextensions.k8s.io/awxrestores.awx.ansible.com created
@@ -53,32 +75,38 @@ video::awx_deployment.mp4[align="center",width=700,height=400]
   configmap/awx-operator-awx-manager-config created
   service/awx-operator-controller-manager-metrics-service created
   deployment.apps/awx-operator-controller-manager created
+----
 
-
-. Edit the `awx-demo.yml` file with the following content which will do the deployment of resources: 
-
+. Edit the `awx-demo.yml` file with the following content, which will do the deployment of resources:
++
+.Sample output:
+----
   apiVersion: awx.ansible.com/v1beta1
   kind: AWX
   metadata:
    name: awx-demo
   spec:
    service_type: clusterip
    ingress_type: Route
- 
+----
 
 . Make sure to add this new file to the list of resources in your `kustomization.yaml` file:
-
++
+.Sample output:
+----
   resources:
    - github.com/ansible/awx-operator/config/default?ref=<tag>
    # Add this extra line:
    - awx-demo.yml
-
-
-. Apply the changes to create the AWX instance in the Openshift cluster
+----
 
-  oc apply -k .
-
+. Apply the changes to create the AWX instance in the Openshift cluster:
++
+[source,bash,role=execute]
+----
+oc apply -k .
+----
 
-NOTE: Create Resources on the AWX which can be confirmed after migration Following Video Tutorial will help in doing that. 
+NOTE: Create Resources on the AWX, which can be confirmed after migration. The following video tutorial will help in doing that.
 
 video::awx_resource_creation.mp4[align="center",width=700,height=400]
diff --git a/modules/chapter1/pages/section4.adoc b/modules/chapter1/pages/section4.adoc
@@ -1,15 +1,14 @@
 = Deployment of the Ansible Automation Platform 2.5 operator
 
-The following video will provide the step to step guide to Install the Ansible Automation Platform 2.5 operator: 
+The following video will provide the step-to-step guide to install the Ansible Automation Platform 2.5 operator:
 
 video::aap_deploy.mp4[align="center",width=700,height=400]
 
-. Log in to Red Hat OpenShift Container Platform. 				
-. Navigate to Operators OperatorHub. 				
-. Search for Ansible Automation Platform and click Install. 				
-. Select an  stable-2.5 
-. Select namespace as awx
-. Click Install
+. Log in to Red Hat OpenShift Container Platform.
+. Navigate to Operators OperatorHub.
+. Search for Ansible Automation Platform and click *Install*.
+. Select an *stable-2.5*.
+. Select namespace as awx.
+. Click *Install*.
 
-
-NOTE: It is recommended to have the AWX and AAP 2.5 in the same Namespace or else the communication issues occur between the pods while performing the database migration.
+NOTE: It is recommended to have the AWX and AAP 2.5 in the same namespace or else communication issues occur between the pods while performing the database migration.