Kubernetes Tutorial
You can access the HTML version of this tutorial here: https://redhat-scholars.github.io/kubernetes-tutorial/
Visual Studio Code Remote Development
If you are using Visual Studio Code with the Remote Containers Extension, you donโt need to install anything locally to be able to contribute or run through this tutorial.
Simply follow these instructions:
-
(Only if running with podman) Set the environment variable
DEVCONTAINER_TARGET_PREFIX=podman
-
Open VS Code from the root of the
kubernetes-tutorial
repository and when prompted indicate that you want to "open the folder in a container".
Once the devcontainer is initialized, from the Visual Studio Code terminal you will be able to run all the commands outlined for creating documentation.
Execute Tutorial with VSCode Remote
You can also run through the tutorial with VSCode Remote. The only trick is that you will need to be able to access minikube from within your docker container.
Building the HTML locally
In the root of your git repository, run:
bin/build-site.sh
And then open your gh-pages/index.html
file:
open gh-pages/index.html
Iterative local development
You can develop the tutorial docs locally using a rapid iterative cycle.
First, install the yarn
dependencies:
yarn install
And now start gulp
. It will create the website and open your browser connected with browser-sync
. Everytime it detects a change, it will automatically refresh your browser page.
gulp
You can clean the local cache using:
gulp clean