Awesome
Rainforest
AIMLOPS - Platform as Product
👨🏫 👉 The Published Docs Live Here 👈 🧑💻
🪄 Customize The Instructions
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
rainforest
then 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 at <code class="language-yaml">https://console-openshift-console.apps.sandbox1243.opentlc.com/</code> then just putapps.sandbox1243.opentlc.com
in 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 <code class="language-yaml">https://gitlab-ce.apps.sandbox1243.opentlc.com/</code>, then just
put
gitlab-ce.apps.sandbox1243.opentlc.com
in the box to generate the correct address for the exercises.
🦆 Conventions
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:
<div class="highlight" style="background: #f7f7f7">
<pre><code class="language-bash">
name: <\TEAM_NAME>
# ^ this becomes
name: rainforest
</code></pre></div>
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.
🏃♀️ Running the docs site locally
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.