kubernetes-the-hard-way/docs/01-prerequisites.md

46 lines
1.9 KiB
Markdown
Raw Normal View History

2017-08-29 00:19:25 +03:00
# Prerequisites
2019-05-23 19:48:36 +03:00
## Microsoft Azure
2017-08-29 00:19:25 +03:00
2019-05-23 19:48:36 +03:00
This tutorial leverages [Microsoft Azure](https://azure.microsoft.com/en-us/) to streamline provisioning of the compute infrastructure required to bootstrap a Kubernetes cluster from the ground up. [Sign up](https://azure.microsoft.com/en-us/free/) for $200 in free credits.
2017-08-29 00:19:25 +03:00
2019-05-23 19:48:36 +03:00
> The compute resources required for this tutorial exceed the Azure free tier.
2017-08-29 00:19:25 +03:00
2019-05-30 21:52:22 +03:00
## nix* Environment
If you're running this tutorial from a Linux or macOS machine, you're all set. If you're running on Windows, you'll need to use WSL. Instructions for setting that up can be found in the official docs [HERE](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
2019-05-23 19:48:36 +03:00
## Azure CLI
2017-08-29 00:19:25 +03:00
2019-05-23 19:48:36 +03:00
### Install the Azure CLI
2017-08-29 00:19:25 +03:00
2019-05-23 19:48:36 +03:00
Follow the Azure CLI [documentation](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest) to install and configure the `az` command line utility.
2017-08-29 00:19:25 +03:00
2019-05-23 19:48:36 +03:00
### Set a Default Compute Region
2017-08-29 00:19:25 +03:00
2019-05-23 19:48:36 +03:00
This tutorial assumes a default compute region has been configured.
2017-08-29 00:19:25 +03:00
2019-05-23 19:48:36 +03:00
If you are using the `az` command-line tool for the first time, you'll need to `login`:
```
2019-05-23 19:48:36 +03:00
az login
```
2019-05-23 19:48:36 +03:00
Set a default compute region:
2017-08-29 00:19:25 +03:00
```
2019-05-23 19:48:36 +03:00
az configure --default region=westus2
2017-08-29 00:19:25 +03:00
```
## Running Commands in Parallel with tmux
[tmux](https://github.com/tmux/tmux/wiki) can be used to run commands on multiple compute instances at the same time. Labs in this tutorial may require running the same commands across multiple compute instances, in those cases consider using tmux and splitting a window into multiple panes with `synchronize-panes` enabled to speed up the provisioning process.
> The use of tmux is optional and not required to complete this tutorial.
![tmux screenshot](images/tmux-screenshot.png)
> Enable `synchronize-panes`: `ctrl+b` then `shift :`. Then type `set synchronize-panes on` at the prompt. To disable synchronization: `set synchronize-panes off`.
2017-08-29 00:19:25 +03:00
Next: [Installing the Client Tools](02-client-tools.md)