mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-07 09:46:53 +01:00
55 lines
2.2 KiB
Plaintext
55 lines
2.2 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * installing/installing_azure/installing-azure-user-infra.adoc
|
|
|
|
[id="installation-creating-azure-bootstrap_{context}"]
|
|
= Creating the bootstrap machine in Azure
|
|
|
|
You must create the bootstrap machine in Microsoft Azure to use during
|
|
{product-title} cluster initialization. One way to create this machine is to
|
|
modify the provided Azure Resource Manager (ARM) template.
|
|
|
|
[NOTE]
|
|
====
|
|
If you do not use the provided ARM template to create your bootstrap machine,
|
|
you must review the provided information and manually create the infrastructure.
|
|
If your cluster does not initialize correctly, you might have to contact Red Hat
|
|
support with your installation logs.
|
|
====
|
|
|
|
.Prerequisites
|
|
|
|
* Configure an Azure account.
|
|
* Generate the Ignition config files for your cluster.
|
|
* Create and configure a VNet and associated subnets in Azure.
|
|
* Create and configure networking and load balancers in Azure.
|
|
* Create control plane and compute roles.
|
|
|
|
.Procedure
|
|
|
|
. Copy the template from the *ARM template for the bootstrap machine* section of
|
|
this topic and save it as `04_bootstrap.json` in your cluster's installation directory. This template
|
|
describes the bootstrap machine that your cluster requires.
|
|
|
|
. Export the following variables required by the bootstrap machine deployment:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ export BOOTSTRAP_URL=`az storage blob url --account-name ${CLUSTER_NAME}sa --account-key ${ACCOUNT_KEY} -c "files" -n "bootstrap.ign" -o tsv`
|
|
$ export BOOTSTRAP_IGNITION=`jq -rcnM --arg v "3.1.0" --arg url ${BOOTSTRAP_URL} '{ignition:{version:$v,config:{replace:{source:$url}}}}' | base64 | tr -d '\n'`
|
|
----
|
|
|
|
. Create the deployment by using the `az` CLI:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ az deployment group create -g ${RESOURCE_GROUP} \
|
|
--template-file "<installation_directory>/04_bootstrap.json" \
|
|
--parameters bootstrapIgnition="${BOOTSTRAP_IGNITION}" \ <1>
|
|
--parameters sshKeyData="${SSH_KEY}" \ <2>
|
|
--parameters baseName="${INFRA_ID}" <3>
|
|
----
|
|
<1> The bootstrap Ignition content for the bootstrap cluster.
|
|
<2> The SSH RSA public key file as a string.
|
|
<3> The base name to be used in resource names; this is usually the cluster's infrastructure ID.
|