@@ -23,7 +23,8 @@ the Validated Patterns approach to Ansible and hopefully provide better options
2323across the ecosystem.
2424
2525To this end, AGOF continues to provide an experience to install Ansible Automation
26- Platform into AWS
26+ Platform into AWS, as well as the capability of installing an AGOF pattern onto
27+ a freshly installed AAP instance.
2728
2829== Introduction
2930
@@ -159,7 +160,7 @@ OpenShift based installation of AAP will determine values for these variables in
159160need to be set explicitly. Outside of OpenShift, these values must be set in either agof_vault.yml or (if using
160161one) in the inventory file.
161162
162- [cols="1,1"]
163+ [cols="1,1,1,1,1 "]
163164|===
164165|Variable Name|Variable Type|OpenShift handling?|Default|Notes
165166
@@ -187,18 +188,13 @@ one) in the inventory file.
187188|main
188189|Can be a branch name, tag, or SHA commit
189190
190- |ansible_host
191- |string
192- |Discovered by aap-config from installed operand
193- |aap.<cluster domain name>
194- |Hostname to use to reach AAP instance. Hostname for route in OpenShift.
195- Can also be retrieved by running scripts/ansible_get_credentials.sh
196-
197191|admin_password
198192|string
199193|Discovered by aap-config from installed operand
200194|Randomly generated string per-instance
201- |Can also be retrieved by running scripts/ansible_get_credentials.sh
195+ |Can also be retrieved by running scripts/ansible_get_credentials.sh which
196+ will retrieve the AAP hostname and password by discovering the values from
197+ OpenShift.
202198
203199|db_password
204200|string
@@ -210,27 +206,30 @@ Can also be retrieved by running scripts/ansible_get_credentials.sh
210206|string
211207|Derived from OpenShift pull secret
212208|None
213- |Used to download AAP installer
209+ |Used to download AAP installer. On OpenShift it does not need to be separately specified.
214210
215211|redhat_username
216212|string
217213|Derived from OpenShift pull secret
218214|None
219- |Used to download images from registry.redhat.io for non-OpenShift installs
215+ |Used to download images from registry.redhat.io for non-OpenShift installs. On
216+ OpenShift it does not need to be separately specified.
220217
221218|redhat_password
222219|string
223220|Derived from OpenShift pull secret
224221|None
225- |Used to download images from registry.redhat.io for non-OpenShift installs
222+ |Used to download images from registry.redhat.io for non-OpenShift installs. On
223+ OpenShift it does not need to be separately specified.
226224|===
227225
228226== OpenShift Support
229227
230228OpenShift support for AGOF works by creating a "clean room" environment for AGOF within the cluster that hosts
231229the Ansible Automation Platform operator. The scheme expects that the AAP installation will be running but
232- otherwise unconfigured. Thus, it uses the "API Install" mechanism of AGOF (which will configured a previously installed
233- instance of AAP), but adjusted for the OpenShift hosted version of AAP in the following ways:
230+ otherwise unconfigured, and not entitled. Thus, it uses the "API Install" mechanism of AGOF
231+ (which will configured a previously installed instance of AAP), but adjusted for the OpenShift hosted version
232+ of AAP in the following ways:
234233
235234* It forces a variable override order that ensures that the variables passed to the helm chart will take precedence
236235* It includes all Helm chart values as Ansible extravars, at the highest level of priority
@@ -274,9 +273,10 @@ not have to be specified or known in the public repository. AGOF depends on this
274273both a user-specific vault file as well as variables imported from helm in a predictable and deterministic way,
275274so that the user does not have to remember to specify those parameters to the command.
276275
277- == How the OpenShift chart populates the essential variables
276+ == AGOF v2: Repositories for an AGOF Pattern in OpenShift and their Purposes
278277
279- == AGOF v2: Repositories for a Pattern and their Purposes
278+ Note that it is quite possible to run AGOF outside of OpenShift as before. The example below shows the maximum
279+ example (of starting within OpenShift). AGOFv2 outside OpenShift works essentially as it has before.
280280
281281image::agof/AGOFv2_Structure.png[AGOF v2 Repository Structure]
282282
0 commit comments