Useful Links
This page is a collection of links that may come in handy during day-to-day work.
SUSE & Rancher doc sites
- Production website. Corresponds to the "master" branch of the rancher/docs repo.
- Staging website. Corresponds to the "staging" branch of the rancher/docs repo.
- Project management tool.
- Website for RKE2 documentation.
- Website for Rancher Desktop.
Style guides
- Microsoft style guide - Primarily used by Rancher docs for legacy reasons.
- SUSE style guide - Used as a secondary guide where the MS guide isn't relevant or doesn't have any advice.
Learning resources
Kubernetes-related
- Highest level overview https://www.cncf.io/phippy/the-childrens-illustrated-guide-to-kubernetes/
- The Kubernetes Book (learn the jargon and how to run clusters): https://leanpub.com/thekubernetesbook
- What's the difference between K8s and K3s?https://traefik.io/glossary/k3s-explained/
- Etcd: https://etcd.io/docs/v3.5/faq/
- NGINX ingress controllers
Rancher
- Rancher video course: https://www.crowdcast.io/e/up-and-running-rancher-october
- https://www.rancher.com/learn-the-basics
- https://community.suse.com/ (Successor to Rancher Operator course is supposedly here)
- https://www.youtube.com/@Rancher
- https://www.youtube.com/watch?v=fa59nQvC2S0
Linux Foundation courses and certifications
- Open Source IT & Cloud Computing course: https://trainingportal.linuxfoundation.org/courses/fundamentals-of-open-source-it-and-cloud-computing-lfs200
- Kubernetes Essentials course: https://trainingportal.linuxfoundation.org/courses/kubernetes-and-cloud-native-essentials-lfs250
- Certified Kubernetes Admin: https://training.linuxfoundation.org/certification/certified-kubernetes-administrator-cka/
Docs formatting
- https://docs.github.com/en/get-started/using-git/about-git
- https://www.markdownguide.org/basic-syntax/
- https://docusaurus.io/docs
Tools
Vale is a command line linter with integrations for VS Code and other text editors. It points out style issues on your page so that you can fix them before you push a commit. After you install Vale CLI, create a .vale.ini config file to contain references to your style guides, and runvale sync. Then, add the integration with your text editor. When you run Vale, you should be in the same directory as .vale.ini.
Microsoft should be listed as your primary Vale style, while the SUSE style guide for Vale should be among your supplementary styles. To add the Suse guide to your Vale styles, simply run git clone [https://github.com/openSUSE/suse-vale-styleguide.git](https://github.com/openSUSE/suse-vale-styleguide.git) in your styles directory and update your .vale.ini file's BasedOnStyles and Packages to list suse-vale-styleguide.
Company resources
- Meeting Recordings.
- Support Matrix
- A table listing out the different internal user accounts, and how to access them, request password resets, etc.