`gkeadm` is a command-line tool for creating and managing admin workstations
in Google Distributed Cloud.

## Downloading `gkeadm`

To create an admin workstation for a certain version of Google Distributed Cloud,
[download](https://docs.cloud.google.com/anthos/clusters/docs/on-prem/1.6/downloads)
that same version of the `gkeadm` tool.

To upgrade and admin workstation, download the version of `gkeadm` that matches
the target version of your upgrade.

## Creating an admin workstation

These are the steps for creating an admin workstation:

1. Create a template for an admin workstation configuration file by running
   `gkeadm create config`.

2. Fill in your admin workstation configuration file.

3. Create your admin workstation by running `gkeadm create admin-workstation`.
   Provide your admin workstation configuration file as an argument.

For more information, see
[Creating an admin workstation](https://docs.cloud.google.com/anthos/clusters/docs/on-prem/1.6/how-to/admin-workstation).

## Upgrading an admin workstation

To upgrade your admin workstation, download the version of `gkeadm` that
matches the target version of your upgrade. Then run
`gkeadm upgrade admin-workstation`. Use the same configuration file that you
used to create your admin workstation.

In addition to your admin configuration file, you need to provide one of the
following:

- An infomation file. When you created your admin workstation, `gkeadm`
  generated this file for you.

- An OS image file.

For more information, see
[Upgrading Google Distributed Cloud](https://docs.cloud.google.com/anthos/clusters/docs/on-prem/1.6/how-to/upgrading).

## Rolling back

To roll back your admin workstation to the previous version, use the same
configuration file that you used to create your admin workstation. Then run
`gkeadm rollback admin-workstation`.

In addition to your admin configuration file, you need to provide one of the
following:

- An infomation file. When you created your admin workstation, `gkeadm`
  generated this file for you.

- An OS image file.

## Restoring from backup

When you upgrade an admin workstation, `gkeadm` saves a backup file for you.
Later, if you no longer have an admin workstation or if you've lost some of
the files that were on your upgraded admin workstation, you can use the backup
file to create an admin workstation that is restored to what was in place
immediately after the upgrade.

To create an admin workstation from a backup file, run
`gkeadm create admin-workstation --restore-from-backup`.

## Getting help

To list all available commands:

```
gkeadm help
```

To get help for a specific command:

```
gkeadm COMMAND --help
```

## Synopsis

```
gkeadm installs and manages the admin workstation.

Usage:
  gkeadm [flags]
  gkeadm [command]

Available Commands:
  create      Create a GKE On-Prem admin workstation
  delete      Delete a GKE On-Prem admin workstation
  help        Help about any command
  rollback    Rollback a GKE On-Prem admin workstation to the previous version
  upgrade     Upgrade a GKE On-Prem admin workstation
  version     Print the gkeadm version

Flags:
      --add_dir_header             If true, adds the file directory to the header
      --alsologtostderr            log to standard error as well as files
  -h, --help                       help for gkeadm
      --log_file string            If non-empty, use this log file
      --log_file_max_size uint     Defines the maximum size a log file can grow to. Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
      --skip_headers               If true, avoid header prefixes in the log messages
      --skip_log_headers           If true, avoid headers when opening log files
      --stderrthreshold severity   logs at or above this threshold go to stderr (default 2)
  -v, --v Level                    number for the log level verbosity (default 0)

Use "gkeadm [command] --help" for more information about a command.
```