Merge pull request #77939 from tshwartz/HCIDOCS-370

HCIDOCS-370 - Outline Alibaba Cloud Setup

Author: kalexand-rh

_topic_maps/_topic_map.yml

@@ -134,12 +134,12 @@ Topics:
     File: installing-mirroring-disconnected
   - Name: Mirroring images for a disconnected installation using oc-mirror plugin v2
     File: about-installing-oc-mirror-v2
-- Name: Installing on Alibaba Cloud by using Assisted Installer
-  Dir: installing_alibaba
+- Name: Installing on Alibaba Cloud
   Distros: openshift-origin,openshift-enterprise
+  Dir: installing_alibaba
   Topics:
-  - Name: Uninstalling a cluster on Alibaba Cloud
-    File: uninstall-cluster-alibaba
+  - Name: Installing a cluster on Alibaba Cloud using the Assisted Installer
+    File: installing-alibaba-assisted-installer
 - Name: Installing on AWS
   Dir: installing_aws
   Distros: openshift-origin,openshift-enterprise

installing/installing_alibaba/installing-alibaba-assisted-installer.adoc

@@ -0,0 +1,20 @@
+:_mod-docs-content-type: ASSEMBLY
+[id="installing-alibaba-assisted-installer"]
+= Installing a cluster on Alibaba Cloud by using the Assisted Installer
+include::_attributes/common-attributes.adoc[]
+:context: installing-alibaba-assisted-installer
+
+toc::[]
+
+From {product-title} 4.16 and later, you can use the {ai-full} to install an {product-title} cluster on {alibaba}. {alibaba} provides a broad range of cloud computing and data storage services to online businesses and global enterprises.
+
+:FeatureName: Installing {alibaba} with {ai-full}
+include::snippets/technology-preview.adoc[]
+
+include::modules/alibaba-ai-installing.adoc[leveloffset=+1]
+
+.Additional resources
+
+* link:https://docs.redhat.com/en/documentation/openshift_container_platform/4.14/html/installing_openshift_container_platform_with_the_assisted_installer/index[Installing {product-title} with the {ai-full}]
+
+include::modules/alibaba-ai-converting-image-to-qcow2.adoc[leveloffset=+1]

installing/installing_alibaba/uninstall-cluster-alibaba.adoc

@@ -0,0 +1,33 @@
+// Module included in the following assemblies:
+//
+// * installing/installing_alibaba/installing-alibaba-assisted-installer.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="alibaba-ai-converting-image-to-qcow2_{context}"]
+= Converting the discovery image to QCOW2 format
+
+Convert the generated ISO to `QCOW2` format before importing it into {alibaba}. 
+
+.Prerequisites
+
+* You have created a cluster and downloaded the discovery image in the {ai-full}.
+* You have access to a Red Hat Enterprise Linux or Fedora machine that is outside the cluster, such as your desktop machine.
+* You have ensured that the machine has virtualization flags enabled.
+
+.Procedure
+
+. Open the command line interface on your RHEL or Fedora machine.
+
+. Verify that `qemu-img` is installed on the machine by running the following command:
++
+[source,terminal]
+----
+$ sudo dnf install -y qemu-img
+----
+
+. Convert the image to `QCOW2` by running the following command:
++
+[source,terminal]
+----
+$ qemu-img convert -O qcow2 ${CLUSTER_NAME}.iso ${CLUSTER_NAME}.qcow2
+----

modules/alibaba-ai-converting-image-to-qcow2.adoc

@@ -0,0 +1,31 @@
+// Module included in the following assemblies:
+//
+// * installing/installing_alibaba/installing-alibaba-assisted-installer.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="alibaba-ai-installing_{context}"]
+= Process outline for creating a cluster with the {ai-full} 
+
+The main steps of the installation process are as follows:
+
+. Create the cluster with the {ai-full} and download the generated image.
+
+. Convert the image to `QCOW2` format. For more information, see the following section.
+
+. Upload the image to the Object Storage Service bucket in {alibaba}.
+
+. Import the image to the Elastic Compute Service in {alibaba}.
+
+. Provision the {alibaba} resources:
+
+.. In the Virtual Private Cloud (VPC) console, set the networking configurations.
+
+.. In the {alibaba} DNS console, define the Domain Name System.
+
+.. In the Elastic Compute Service (ECS) console, provision the compute instances. 
+
+. Complete host discovery in the {ai-full}.
+
+. Complete the network configurations in {alibaba}.
+
+. Complete the cluster configuration and installation in the {ai-full}.

modules/alibaba-ai-installing.adoc

@@ -9,4 +9,4 @@
 For more information about the support scope of Red Hat Technology Preview features, see link:https://access.redhat.com/support/offerings/techpreview/[Technology Preview Features Support Scope].
 ====
 // Undefine {FeatureName} attribute, so that any mistakes are easily spotted
-:!FeatureName:
+:!FeatureName: The Alibaba Cloud installation with Assisted Installer