Deploying GDC Virtual on bare metal requires knowledge of Linux command-line skills, and an understanding of the existing network topology. The code deployment varies based on network speeds and familiarity with the tools discussed in this section but can generally be completed within a few hours.
Prepare the Linux Admin Workstation machine
Complete the following instructions on the Admin Workstation node:
- Admin workstation node hosts the command-line tools and configuration files to provision and manage the cluster. Ensure that the admin workstation meets the prerequisites described in the admin workstation prerequisites.
- Install a supported Linux operating system. For the list of supported Linux operating systems and versions, see Select your operating system. This page has links to configuration instructions, including Docker configuration, for each operating system.
- Ensure that the docker version 19.03 or later is installed.
- Ensure that the Google Cloud CLI is installed. The gcloud, gsutil, and kubectl command-line tools are components of gcloud CLI. To create and manage clusters, kubectl and bmctl tools are used. For more information, see Install the gcloud CLI.
- Create a directory, for example:
cd ~
mkdir baremetal
cd baremetal
- Download and install the bmctl for the version of the cluster that is being created by running the following command:
gcloud auth login
gsutil cp gs://anthos-baremetal-release/bmctl/VERSION/linux-amd64/bmctl .
chmod +x ./bmctl
- Create a configuration file by running the following command:
./bmctl create config -c CLUSTER_NAME --enable-apis --create-service-accounts --project-id=GOOGLE_PROJECT_ID
The above command creates service accounts for the google project id and downloads the service account keys as a JSON file under the bmctl-workspace/.sa-keys directory. - The cluster configuration file is located under bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME.yaml file. Edit the cluster configuration file with the corresponding IP addresses and cluster details. A sample configuration file is present in can be found here.
- Create the cluster by running the following command:
./bmctl create cluster -c CLUSTER_NAME
The bmctl command runs preflight checks on the cluster config file before it creates a cluster. If the checks are successful, the cluster is created. The bmctl logs, the preflight check, and the node installation logs, are in the baremetal/bmctl-workspace//log directory.
- During cluster creation, the bmctl command writes a kubeconfig file which is written to the bmctl-workspace//- kubeconfig file.
- Once the cluster creation is successful, the cluster can be verified by running the following command:
kubectl --kubeconfig bmctlworkspace//-kubeconfig get nodes
Note: For manual service account creation and complete details on setting up of GDC Virtual on bare metal, see Reference Architecture: Google Cloud Anthos and GDC Virtual on Dell PowerFlex.