Commit Graph
49 Commits
Author SHA1 Message Date
Bastian Hofmann c5ff08a766 Updates the docs to register existing clusters
* Adds information about registering AKS clusters
* Adds information about registering RKE2 clusters

Fixes https://github.com/rancher/rancher-docs/issues/308
2022-11-24 16:45:13 +01:00
Bastian Hofmann 02a92e1b8f Remove reference to Rancher 1 and Cattle
Fixes https://github.com/rancher/rancher-docs/issues/204
2022-09-16 15:57:18 +02:00
Bastian Hofmann a789a6ba11 Add missing reference to RKE2
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2022-06-17 16:15:21 +02:00
Bastian Hofmann e072a6da86 [Rancher] Restructure ingress controller docs on Rancher installation page
* Make it clearer in which cases you need to install an additional ingress controller and in which you don't
* Move Ingress Controller docs closer to the cluster provisioning docs
* Move hosted kubernetes cluster docs to k8s-tutorial so that they are next to the RKE, RKE2 and K3s docs in the menu

Fixes https://github.com/rancher/docs/issues/4109

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2022-06-03 16:09:50 +02:00
Bastian Hofmann 24060cd7e4 [K3s] Document registry mirror rewrite configuration and clean up mirror config section
Fixes https://github.com/rancher/docs/issues/4007

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2022-04-22 12:17:16 +02:00
Bastian Hofmann 5f30d33956 Fix link in Logging -> Flows to link to the correct upstream docs page
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2022-04-11 10:24:53 +02:00
Bastian Hofmann 54c8abb9cd Always link to the latest Longhorn docs version
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2022-04-08 13:01:46 +02:00
Bastian Hofmann 4cde01757d Extend airgapped Rancher installation tutorial for RKE2
Fixes https://github.com/rancher/docs/issues/3985

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2022-03-28 18:14:03 +02:00
Bastian Hofmann 8a131408bd Update quickstart docs
* SSH keys are auto-generated (https://github.com/rancher/quickstart/pull/86)
* Add documentation for missing variables
* Rancher is installed in a K3s cluster
* Align docs of different providers

Fixes https://github.com/rancher/quickstart/issues/192

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2022-01-03 13:20:44 +01:00
Bastian Hofmann 1aa26583de Update vagrant quickstart IP
The IPs were changed in https://github.com/rancher/quickstart/pull/191 to support the latest VirtualBox version on Mac

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-12-13 17:18:40 +01:00
Bastian Hofmann 80b114cdd7 Simplify docs to install Istio on RKE2 with selinux
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-10-15 17:37:51 +02:00
Bastian Hofmann e142786ef2 Remove references to Azure Tenant ID when creating cloud credentials
Since 2.6 the tenant id is automatically looked up by rancher and can't be provided by the UI anymore.

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-10-15 10:22:02 +02:00
Bastian Hofmann 31c2e8b330 Update advanced TLS settings page for 2.5
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-10-04 13:19:43 +02:00
Bastian Hofmann 7ba6b0a951 Update advanced TLS settings page
This adds a detailed description on how to configure tls version and ciphers when Rancher is installed in a Kubernetes cluster. TLS is offloaded at the ingress controller, which means these settings need to be set there instead of the Rancher Pod/Container.

For running Rancher as a single Docker container, the default values have been updated to the ones currently supported.

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-09-28 16:06:53 +02:00
Bastian Hofmann 426b325f0e Update kubeconfig ttl docs
Since 2.6 the settings can be configured in the global settings UI instead of the API only

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-09-27 18:13:22 +02:00
Bastian Hofmann 62ed9483a8 Re-add documentation how to create Rancher Apps to 2.6 docs
This page was accidentally removed when the legacy catalogs and multi cluster app docs were removed in the 2.6 docs. The documentation on how to create these apps is still relevant in the 2.6 app marketplace though.

This re-adds this pages and updates it to the 2.6 copy and featureset.

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-09-27 17:13:56 +02:00
Bastian HofmannandJen Travinski 60b45b7386 Remove Helm 2 references (#3549)
Helm 2 has been EOL for over a year

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>

Co-authored-by: Jen Travinski <jennifer.travinski@suse.com>
2021-09-24 11:08:54 -07:00
Bastian Hofmann 271e11af89 * Fix cert-manager installation docs: the installation fails with installCRDs=true, if you applied the crds before
* Change cert-manager version for proxy installation docs to match version in normal docs

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-09-09 15:17:18 +02:00
Bastian Hofmann f27d442882 Update FAQ regarding Hashicorp Vault
This clarifies that there is no built-in integration at the moment, but that you can use Vault with its standard Kubernetes integration.

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-08-09 16:23:53 +02:00
Bastian Hofmann a64564a5cd Update K3s docs to customize Traefik
* Instead of duplication the traefik.yaml, the preferred way to customize Treafik is to use a HelmChartConfig manifest.
* The link to the Traefik was pointing to a deprecated and outdated repository.

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-08-03 11:44:59 +02:00
Bastian Hofmann 11139f18c5 Fix openssl certificate generation command in ADFS docs
The CN must be a hostname without a protocol.

With the protocol the command even fails because of the missing escaping of the forward slashes:

openssl req -x509 -newkey rsa:2048 -keyout myservice.key -out myservice.cert -days 365 -nodes -subj '/CN=https://myservice.example.com'
Generating a 2048 bit RSA private key
..+++
...........................+++
writing new private key to 'myservice.key'
-----
end of string encountered while processing type of subject name element #1
problems making Certificate Request

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-05-20 15:50:53 +02:00
Bastian Hofmann 3881ea9bb5 Update cluster capabilities table for Rancher 2.5
* Cluster Upgrades are possible for imported RKE2 clusters
* CIS Scans are available for all types of clusters in 2.5

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-04-08 15:23:26 +02:00
Bastian Hofmann c947a0d5cc Remove two more references to specific linux distributions in the docs and link to the support matrix
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2021-01-07 17:38:35 +01:00
Bastian Hofmann 78b6998bec Add link to S3 credentials example on backup storage configuration page
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-12-10 15:40:41 -07:00
Bastian Hofmann e3b44bf94c Add link to S3 credentials example on backup storage configuration page
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-12-09 15:28:16 +01:00
Bastian Hofmann e842604f7c Add new 2.5 webhook port requirements to imported clusters
https://github.com/rancher/rancher/issues/30101
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-11-17 15:05:24 +01:00
Bastian Hofmann 1f56d06020 Cleanup Rancher port requirements
Port requirements were documented in 3 places in the Rancher docs. This consolidates the documentation in one place and correctly distinguishes between the Rancher management cluster and downstream clusters.

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-11-13 11:37:37 +01:00
Bastian Hofmann 8534996de4 Extend monitoring v1 to v2 migration guide
* Add more default information how to remove monitoring v1
* Add documentation how to migrate a v1 alert through the new PrometheusRule UI
* Add a note how to migrate v1 notifiers

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-11-12 18:44:34 +01:00
Bastian Hofmann 1f67d3268d Add documentation for the new entity ID field in the keycloak configuration
The field was introduced with https://github.com/rancher/rancher/pull/29555 in 2.5.2

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-11-12 13:50:27 +01:00
Bastian Hofmann 8c9fd3440b Adapt default value for noProxy helm chart variable
New value was introduced in 2.5 with https://github.com/rancher/rancher/commit/7feec1fb9713df4903a056c5375926a613a5d85d

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-11-10 16:25:34 +01:00
Bastian Hofmann cffa8eb573 Add guide how to migrate dashboards and alerts from monitoring v1 to v2
Clarify V1 uninstallation and Grafana dashboard import.

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-11-02 11:39:14 +01:00
Bastian Hofmann a8b10a5292 Add guide how to migrate dashboards and alerts from monitoring v1 to v2
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-10-30 16:22:28 +01:00
Bastian Hofmann e6e32529b0 Add redirects for links that changed with 2.5 updates
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-10-06 14:32:36 +02:00
Bastian Hofmann 7d3dea23d9 Update cert-manager namespace on the rancher troubleshooting page and remove reference to tiller 2020-08-28 09:06:03 -07:00
Bastian Hofmann 380e83cacf Add tutorial to show how Rancher can be installed behind a HTTP proxy setup 2020-08-26 12:32:41 -07:00
Bastian Hofmann a8d795202b Improve Keycloak authentication documentation
* Explain in text and with screenshots how to correctly configure the Rancher SAML client in Keycloak, including mappers
* Provide examples for field configurations in Rancher that map to the Keycloak defaults
* Move the note on how to get a metadata.xml file with Keycloak >= 6.0.0 directly to the Prerequisites so that it is hard to miss

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-08-19 16:43:08 -07:00
Bastian Hofmann 66f181c29b Update Rancher HA disaster recovery documentation to work with rke >= 0.2.0 - address the reviews
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-27 16:18:38 -07:00
Bastian Hofmann 74ddc4793d Update Rancher HA disaster recovery documentation to work with rke >= 0.2.0
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-27 16:18:38 -07:00
Bastian Hofmann 6bea52ce63 Move cluster-capabilities-table to a headless bundle and include it as a page instead of reading the file
This prevents the table to automatically be included on pages of other bundles.
By including the page instead of reading the file also the shortcodes in the table are expanded correctly.

This fixes broken links in the table.

Fixes https://github.com/rancher/docs/issues/2577

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-27 16:18:38 -07:00
Bastian Hofmann 318a873672 Move cluster-capabilities-table to a headless bundle and include it as a page instead of reading the file
This prevents the table to automatically be included on pages of other bundles.
By including the page instead of reading the file also the shortcodes in the table are expanded correctly.

This fixes broken links in the table.

Fixes https://github.com/rancher/docs/issues/2577

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-27 16:18:38 -07:00
Bastian Hofmann 041664fa62 Update and centralize cluster capabilities table
Currently there are 4 different occurrences of the cluster capabilities table that compares which features you can use in Rancher with RKE clusters, hosted cloud provider clusters and imported clusters. One of them is very detailed but a bit outdated, the other ones only mention basic features and are not complete.

This commit centralizes the table and includes it on all 4 pages and updates it for features introduced with 2.4

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-27 16:18:38 -07:00
Bastian Hofmann df131dd046 Document missing Rancher Helm chart options 2020-07-27 16:18:38 -07:00
Bastian Hofmann d100d3a099 Hardcode keys in kubectl create secret commands
This hardcodes the generated key name in all `kubectl create secret` commands where the `--from-file` option is used. It ensures that the stored key is the one that Rancher expects and does not rely on the local file name.

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-15 09:58:03 -07:00
Bastian Hofmann d8f9c2e667 Update Rancher HA disaster recovery documentation to work with rke >= 0.2.0 - address the reviews
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-09 17:16:37 -07:00
Bastian Hofmann 16e115e951 Update Rancher HA disaster recovery documentation to work with rke >= 0.2.0
Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-09 17:16:37 -07:00
Bastian Hofmann e610bc8ef2 Move cluster-capabilities-table to a headless bundle and include it as a page instead of reading the file
This prevents the table to automatically be included on pages of other bundles.
By including the page instead of reading the file also the shortcodes in the table are expanded correctly.

This fixes broken links in the table.

Fixes https://github.com/rancher/docs/issues/2577

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-08 11:15:08 -07:00
Bastian Hofmann 0ebb806516 Move cluster-capabilities-table to a headless bundle and include it as a page instead of reading the file
This prevents the table to automatically be included on pages of other bundles.
By including the page instead of reading the file also the shortcodes in the table are expanded correctly.

This fixes broken links in the table.

Fixes https://github.com/rancher/docs/issues/2577

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-07-07 21:33:43 -07:00
Bastian Hofmann f68ff88900 Update and centralize cluster capabilities table
Currently there are 4 different occurrences of the cluster capabilities table that compares which features you can use in Rancher with RKE clusters, hosted cloud provider clusters and imported clusters. One of them is very detailed but a bit outdated, the other ones only mention basic features and are not complete.

This commit centralizes the table and includes it on all 4 pages and updates it for features introduced with 2.4

Signed-off-by: Bastian Hofmann <bashofmann@gmail.com>
2020-06-25 08:48:37 -07:00
Bastian Hofmann 43cb14fb41 Document missing Rancher Helm chart options 2020-06-01 15:22:02 -07:00