Create the global Cluster on Huawei Cloud Stack
TOC
PrerequisitesProcedure1. Writeinstall-config.yaml2. Create the Cluster3. Monitor the InstallationVerificationNext StepsPrerequisites
- You completed the common prerequisites and the Huawei Cloud Stack prerequisites.
- The Core Package is extracted on the bootstrap node, and its payload is in the external registry. See Prepare the Core Package and the Registry.
- For a disaster recovery pair, write both files as described in Create a Global Cluster Disaster Recovery Pair, then run this procedure on each side.
Procedure
1. Write install-config.yaml
Create an installation directory on the bootstrap node, for example /root/global-install, and write install-config.yaml in it. The commands on this page call this directory <install-dir>; see Installation Directory. Keep the file private (chmod 600 install-config.yaml), because it holds the passwords.
Copy the following template and fill in the placeholders. The numbered lines are specific to Huawei Cloud Stack and are described in the table below the template. For the other fields, see Common install-config.yaml Fields. For the objects that ac renders from this file, see Rendered Manifests.
cluster.network.loadBalancer is rejected, because the control plane endpoint is the ELB under provider.hcs.elb.
2. Create the Cluster
On the bootstrap node:
ac first checks that the IAM endpoint <schema>://iam-apigateway-proxy.<externalGlobalDomain> answers. If the check fails, nothing is changed, and the error names the endpoint.
Before you run create, make sure that the credential is correct, and that the names of the image, flavor, availability zone, VPC, subnet, and security group are correct. A wrong credential or name stops the installation in stage 4.
create returns when the installation is complete. If create stops, run the same command again. It skips the work that is already complete. See The create Command.
Once the HCSCluster exists, create does not change its subnet list (spec.network.subnets). A subnet that you add to or change in install-config.yaml after that has no effect.
3. Monitor the Installation
From another terminal on the bootstrap node:
For the stages and common failures, see Troubleshooting. For Huawei Cloud Stack failures, see Troubleshooting on Huawei Cloud Stack.
Verification
When create returns, the installation is complete, but some platform components can take a few more minutes to become ready. Before you judge the result, wait for them as described in Additional Checks for Alauda OS. Then verify the platform as described in Validation, including its checks for Alauda OS.
Next Steps
- A disaster recovery pair: continue with Install the Primary and the Standby.
- Create a Cluster on Huawei Cloud Stack. The
globalcluster already runs the Huawei Cloud Stack provider. - To create workload clusters on other infrastructure, install that provider as described in Prepare.