Configuring Ubuntu

Configuring Ubuntu

You must configure the base operating system of your node machines to use GKE on Bare Metal. This page contains the steps you need to take to complete the needed configuration. For more information about troubleshooting GKE on Bare Metal requirements, see the troubleshooting guides.

Before you begin

Ensure you are using a supported version of your operating system. GKE on Bare Metal supports the following versions for Ubuntu:

  • 18.04
  • 20.04

Validate package manager:

  sudo apt-get check

The output should show no errors and look similar to the following example:

  # Reading package lists... Done
  # Building dependency tree
  # Reading state information... Done

Disabling AppArmor

  1. Stop AppArmor:

    sudo systemctl stop apparmor
  2. Disable AppArmor:

    sudo systemctl disable apparmor
  3. Check that AppArmor appears as inactive:

    sudo systemctl status apparmor | grep "Active"

For example:

  # Active: inactive (dead) ...

Disabling ufw

  1. Disable ufw:

    sudo ufw disable
  2. Check that ufw is disabled:

    sudo ufw status
    # Status: inactive

Configuring Docker 19.03+ on your workstation

GKE on Bare Metal helps you install Docker on your bare metal machines in the following scenarios:

  • If your bare metal machines don't have Docker installed, bmctl installs 19.03.13 or later.
  • If your bare metal machines have Docker 19.03.5 or earlier installed, bmctl upgrades Docker to version 19.03.13 or later.

Follow these steps to manually install Docker:

  1. Remove any previous Docker version:

    sudo apt-get remove docker docker-engine containerd runc
  2. Update your package manager:

    sudo apt-get update
  3. Install Docker 19.03+:

    sudo apt-get install \
      apt-transport-https \
      ca-certificates \
      curl \
      gnupg-agent \
      software-properties-common \
  4. Verify you are now running version 19.03+:

    sudo docker version
  5. Compare your output with the following example to ensure the Client and Server versions are 19.03+ :

     Client: Docker Engine - Community
     Version:           19.03.13
     Server: Docker Engine - Community
      Version:          19.03.13