👨🏫 👉 The Published Docs Live Here 👈 🧑💻
The box on the top of the page allows you to load the docs with variables used by your team prefilled. All you have to do is fill in the boxes on the top of the page with your teams name in the box and the domain your cluster is using and hit save. This will persist the values in your local storage for the site - so hitting clear will reset these for you if you made a mistake.
- If my team is called
rainforestthen pop that in the first box. This value will be prefixed to some of the things such as the namespaces we use. - For the cluster domain, you want to add the
apps.*the bit from the OpenShift domain. For example if my console address lives athttps://console-openshift-console.apps.sandbox1243.opentlc.com/then just putapps.sandbox1243.opentlc.comin the box to generate the correct address for the exercises. - For the git server, you could use your preferred and accessible Git server (GitHub, GitLab, ...). The instructor could provide you one.
For example if the git server lives at
https://gitlab-ce.apps.sandbox1243.opentlc.com/, then just putgitlab-ce.apps.sandbox1243.opentlc.comin the box to generate the correct address for the exercises.
When running through the exercise, we're tried to call out where things need replacing. The key ones are anything inside an <> should be replaced. For example, if your team is called rainforest then in the instructions if you see \<TEAM_NAME\> this should be replaced with rainforest like so:
name: <\TEAM_NAME>
# ^ this becomes
name: rainforest
There are lots of code blocks for you to copy and paste. They have little ✂️ icon on the right if you move your cursor on the code block.
echo "like this one :)"But there are also some blocks that you shouldn't copy and paste which doesn't have the copy✂️ icon. That means you should validate your outputs or yamls against the given block.
To launch the docs, ensure you have NodeJS installed or run it in a NodeJS container if you prefer.
npm i -g docsify-cli@4.4.3
docsify serve ./- Open the browser to http://localhost:3000 to view the tech exercise.