diff --git a/docs/content/_index.md b/docs/content/_index.md index 95451ce..ec82e15 100644 --- a/docs/content/_index.md +++ b/docs/content/_index.md @@ -40,9 +40,18 @@ layout: hextra-home title="K3s Cluster" subtitle="High Availability cluster deployed with Ansible." class="hx-aspect-auto md:hx-aspect-[1.1/1] max-md:hx-min-h-[340px]" - image="images/card-k3s-cluster.webp" + image="/images/card-k3s-cluster.webp" imageClass="hx-top-[20%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80" - link="k3s-cluster" + link="/k3s-cluster/" + style="background: radial-gradient(ellipse at 50% 80%,rgba(194,97,254,0.15),hsla(0,0%,100%,0));" + >}} + {{< hextra/feature-card + title="K3s Applications" + subtitle="Project for applications deployed with ArgoCD." + class="hx-aspect-auto md:hx-aspect-[1.1/1] max-md:hx-min-h-[340px]" + image="/images/card-k3s-apps.webp" + imageClass="hx-top-[20%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80" + link="/k3s-cluster/tutorials/handbook/argocd/" style="background: radial-gradient(ellipse at 50% 80%,rgba(194,97,254,0.15),hsla(0,0%,100%,0));" >}} {{< /hextra/feature-grid >}} diff --git a/docs/static/images/card-k3s-apps.webp b/docs/static/images/card-k3s-apps.webp new file mode 100644 index 0000000..faada22 Binary files /dev/null and b/docs/static/images/card-k3s-apps.webp differ diff --git a/k3s-cluster/content/_index.md b/k3s-cluster/content/_index.md index 7fdea54..b07e61b 100644 --- a/k3s-cluster/content/_index.md +++ b/k3s-cluster/content/_index.md @@ -4,7 +4,7 @@ layout: hextra-home --- {{< hextra/hero-container - image="images/logo-services.svg" + image="/images/logo-services.svg" imageLink="https://github.com/axivo/k3s-cluster" imageTitle="Kubernetes Services" >}} @@ -37,7 +37,7 @@ layout: hextra-home title="K3s" subtitle="Certified Kubernetes distribution built for IoT and Edge computing, running on Ubuntu Server LTS." class="hx-aspect-auto md:hx-aspect-[1.1/1] max-md:hx-min-h-[340px]" - image="images/card-k3s.webp" + image="/images/card-k3s.webp" imageClass="hx-top-[20%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80" link="https://k3s.io" style="background: radial-gradient(ellipse at 50% 80%,rgba(221,210,59,0.15),hsla(0,0%,100%,0));" @@ -46,7 +46,7 @@ layout: hextra-home title="Cilium" subtitle="eBPF-based project, providing networking, security, and observability for Kubernetes clusters." class="hx-aspect-auto md:hx-aspect-[1.1/1] max-md:hx-min-h-[340px]" - image="images/card-cilium.webp" + image="/images/card-cilium.webp" imageClass="hx-top-[20%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80" link="https://cilium.io" style="background: radial-gradient(ellipse at 50% 80%,rgba(194,97,254,0.15),hsla(0,0%,100%,0));" @@ -55,7 +55,7 @@ layout: hextra-home title="Prometheus Stack" subtitle="Kubernetes cluster monitoring and Grafana dashboards, using Prometheus Operator." class="hx-aspect-auto md:hx-aspect-[1.1/1] max-md:hx-min-h-[340px]" - image="images/card-prometheus.webp" + image="/images/card-prometheus.webp" imageClass="hx-top-[20%] hx-left-[24px] hx-w-[180%] sm:hx-w-[110%] dark:hx-opacity-80" link="https://github.com/prometheus-community/helm-charts/tree/main/charts/kube-prometheus-stack" style="background: radial-gradient(ellipse at 50% 80%,rgba(142,53,74,0.15),hsla(0,0%,100%,0));" diff --git a/k3s-cluster/content/tutorials/handbook/ansible/_index.md b/k3s-cluster/content/tutorials/handbook/ansible/_index.md index f388bd5..b310c5a 100644 --- a/k3s-cluster/content/tutorials/handbook/ansible/_index.md +++ b/k3s-cluster/content/tutorials/handbook/ansible/_index.md @@ -46,7 +46,7 @@ ansible_password: !vault | Use the above defined `my-Gl0bal-Passw0rd` global password example, for all encrypted settings, into your configuration files. {{< /callout >}} -Insert the `ansible_password` encrypted output into [`all.yaml`](https://{{< param variables.repository >}}/blob/main/inventory/cluster/group_vars/all.yaml) configuration file, while respecting the output indentation. +Insert the `ansible_password` encrypted output into [`all.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/inventory/cluster/group_vars/all.yaml) configuration file, while respecting the output indentation. ### Decryption diff --git a/k3s-cluster/content/tutorials/handbook/argocd/_index.md b/k3s-cluster/content/tutorials/handbook/argocd/_index.md new file mode 100644 index 0000000..0092759 --- /dev/null +++ b/k3s-cluster/content/tutorials/handbook/argocd/_index.md @@ -0,0 +1,73 @@ +--- +title: ArgoCD +prev: /tutorials/handbook +next: /tutorials/handbook/cilium +--- + +This repository uses [ArgoCD](https://argoproj.github.io/cd) to deploy applications, based on Helm charts. We encourage the community contributing to the [official project](https://{{< param variables.repository.applications >}}). + + + +## Repository Setup + +Navigate to `ArgoCD Settings` > `Repositories` and connect to official project repository: + +| Key | Value | +| :------ | :------------------------------------------------------------ | +| Method | `HTTPS` | +| Type | `git` | +| Project | `default` | +| URL | `https://{{< param variables.repository.applications >}}.git` | + +## Applications Provisioning + +Application charts are released with version control, based on repository tags. See below an example of application provisioning in ArgoCD. + +### Application Resource + +In this example, we will create an [Ubuntu Server pod](https://{{< param variables.repository.applications >}}/tree/main/argo/ubuntu), deployed into `default` namespace. Navigate to `Applications` and create an application, then edit the resource manifest as `YAML` and paste the following content: + +```yaml +apiVersion: argoproj.io/v1alpha1 +kind: Application +metadata: + name: ubuntu + namespace: kube-system +spec: + destination: + name: '' + namespace: default + server: 'https://kubernetes.default.svc' + source: + path: argo/ubuntu + repoURL: 'https://{{< param variables.repository.applications >}}.git' + targetRevision: ubuntu/v1.0.0 + helm: + valueFiles: + - values.yaml + sources: [] + project: default + syncPolicy: + automated: + prune: true + selfHeal: true +``` + +#### Metadata + +This repository uses the `kube-system` namespace for ArgoCD role provisioning. Adjust the `metadata.namespace` value accordingly, if you deploy ArgoCD in a different namespace. + +The `spec.destination.name` is inherited from `metadata.name` value. + +### Shell Login + +Example of pod shell login: + +```shell +$ kubectl get pods -n default -o go-template \ + --template='{{range .items}}{{.metadata.name}}{{"\n"}}{{end}}' +ubuntu-6589cf5fb4-p9z2b + +$ kubectl exec -itn default ubuntu-6589cf5fb4-p9z2b -- bash +root@ubuntu-6589cf5fb4-p9z2b:/# +``` diff --git a/k3s-cluster/content/tutorials/handbook/cilium/_index.md b/k3s-cluster/content/tutorials/handbook/cilium/_index.md index 4fe22cb..3c0de2d 100644 --- a/k3s-cluster/content/tutorials/handbook/cilium/_index.md +++ b/k3s-cluster/content/tutorials/handbook/cilium/_index.md @@ -24,9 +24,9 @@ See below the required Cilium dependencies, used into chart configuration. During chart post-install provisioning, Cilium Hubble is configured to take advantage of CertManager auto-renewed certificates, instead of default Helm expiring certificates. This requires the creation of three resources: -- CertManager `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository >}}/blob/main/roles/certmanager/templates/cluster_issuer.j2) -- Hubble `Certificate` resource template, see [`certificate.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/certificate.j2) -- Hubble `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/cluster_issuer.j2) +- CertManager `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/certmanager/templates/cluster_issuer.j2) +- Hubble `Certificate` resource template, see [`certificate.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/certificate.j2) +- Hubble `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/cluster_issuer.j2) {{< callout type="warning" >}} Cilium details the following instructions into their installation steps: @@ -46,8 +46,8 @@ Refer to Cilium [documentation](https://docs.cilium.io/en/stable/gettingstarted/ This is an example of `Gateway` and `HTTPRoute` resources usage for Longhorn frontend, as replacement for deprecated `Ingress` resource: -- `Gateway` resource template, see [`gateway.j2`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/templates/gateway.j2) -- `HTTPRoute` insecure resource template, see [`http_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/templates/http_route.j2) -- `HTTPRoute` secure resource template, see [`https_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/templates/https_route.j2) +- `Gateway` resource template, see [`gateway.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/templates/gateway.j2) +- `HTTPRoute` insecure resource template, see [`http_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/templates/http_route.j2) +- `HTTPRoute` secure resource template, see [`https_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/templates/https_route.j2) Refer to Cilium [documentation](https://docs.cilium.io/en/stable/network/servicemesh/gateway-api/gateway-api/), for further details. diff --git a/k3s-cluster/content/tutorials/handbook/cloudflare/_index.md b/k3s-cluster/content/tutorials/handbook/cloudflare/_index.md index 477b772..8543c5d 100644 --- a/k3s-cluster/content/tutorials/handbook/cloudflare/_index.md +++ b/k3s-cluster/content/tutorials/handbook/cloudflare/_index.md @@ -20,7 +20,7 @@ Generate the domain [API token](https://developers.cloudflare.com/fundamentals/a {{< /filetree/container >}} Encrypt the `token.value` with [`ansible-vault`](/k3s-cluster/tutorials/handbook/ansible/#vault) and insert it into -[`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/defaults/main.yaml) defaults file. +[`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/defaults/main.yaml) defaults file. ## Front-Ends @@ -33,4 +33,4 @@ The following front-ends are available, once the cluster is provisioned successf - Grafana, `https://grafana.domain.com` - Prometheus, `https://prometheus.domain.com` -Update the `gateway.domain` setting into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/defaults/main.yaml) defaults file. +Update the `gateway.domain` setting into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/defaults/main.yaml) defaults file. diff --git a/k3s-cluster/content/tutorials/handbook/kured/_index.md b/k3s-cluster/content/tutorials/handbook/kured/_index.md index 03824e9..5fd22ef 100644 --- a/k3s-cluster/content/tutorials/handbook/kured/_index.md +++ b/k3s-cluster/content/tutorials/handbook/kured/_index.md @@ -31,7 +31,7 @@ https://hooks.slack.com/services/// ### Notify URL Encrypt the `slack.notify_url` value with [`ansible-vault`](/k3s-cluster/tutorials/handbook/ansible/#vault) and insert it into -[`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/kured/defaults/main.yaml) defaults file. Notify URL pre-encrypted format: +[`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/kured/defaults/main.yaml) defaults file. Notify URL pre-encrypted format: ```yaml notify_url: slack://// diff --git a/k3s-cluster/content/tutorials/handbook/renovate/_index.md b/k3s-cluster/content/tutorials/handbook/renovate/_index.md index 752b23a..b4d0371 100644 --- a/k3s-cluster/content/tutorials/handbook/renovate/_index.md +++ b/k3s-cluster/content/tutorials/handbook/renovate/_index.md @@ -9,6 +9,6 @@ This repository uses [Renovate](https://docs.renovatebot.com), to track any new ## Configuration -Follow the Renovate [onboarding instructions](https://docs.renovatebot.com/getting-started/installing-onboarding/) and once the `k3s-cluster` forked repository is configured, review the [`renovate.json5`](https://{{< param variables.repository >}}/blob/main/.github/renovate.json5) configuration file, for current Renovate implementation. +Follow the Renovate [onboarding instructions](https://docs.renovatebot.com/getting-started/installing-onboarding/) and once the `k3s-cluster` forked repository is configured, review the [`renovate.json5`](https://{{< param variables.repository.cluster >}}/blob/main/.github/renovate.json5) configuration file, for current Renovate implementation. See a [PR example](https://github.com/axivo/k3s-cluster/pull/73) with a new release version generated by Renovate. diff --git a/k3s-cluster/content/wiki/guide/_index.md b/k3s-cluster/content/wiki/guide/_index.md index 4dd528a..87afb91 100644 --- a/k3s-cluster/content/wiki/guide/_index.md +++ b/k3s-cluster/content/wiki/guide/_index.md @@ -9,7 +9,7 @@ The cluster inventory, user, role configuration settings and provisioning playbo {{< callout type="info" >}} - Prior adjusting any settings, [fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) the [`k3s-cluster`](https://{{< param variables.repository >}}) repository. + Prior adjusting any settings, [fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) the [`k3s-cluster`](https://{{< param variables.repository.cluster >}}) repository. {{< /callout >}} ## Next diff --git a/k3s-cluster/content/wiki/guide/configuration/_index.md b/k3s-cluster/content/wiki/guide/configuration/_index.md index 5bd4fd7..f839633 100644 --- a/k3s-cluster/content/wiki/guide/configuration/_index.md +++ b/k3s-cluster/content/wiki/guide/configuration/_index.md @@ -11,7 +11,7 @@ The configuration guides present in this section allow you to configure the K3s {{< callout type="info" >}} - Prior adjusting any settings, [fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) the [`k3s-cluster`](https://{{< param variables.repository >}}) repository. + Prior adjusting any settings, [fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) the [`k3s-cluster`](https://{{< param variables.repository.cluster >}}) repository. {{< /callout >}} ## OS Installation diff --git a/k3s-cluster/content/wiki/guide/configuration/inventory.md b/k3s-cluster/content/wiki/guide/configuration/inventory.md index c80cb24..ec62905 100644 --- a/k3s-cluster/content/wiki/guide/configuration/inventory.md +++ b/k3s-cluster/content/wiki/guide/configuration/inventory.md @@ -41,7 +41,7 @@ The `serial` structure has the following pattern: {{% /details %}} {{< callout type="info" >}} - Update the `serial` structure into [`provisioning.yaml`](https://{{< param variables.repository >}}/blob/main/provisioning.yaml) playbook file. + Update the `serial` structure into [`provisioning.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/provisioning.yaml) playbook file. {{< /callout >}} Example of `serial` structure with 3 `server` type nodes and 5 `agent` type nodes, used into [Reset](/k3s-cluster/wiki/guide/playbooks/reset) playbook: @@ -62,7 +62,7 @@ The `serial` structure has the following pattern: {{% /details %}} {{< callout type="info" >}} - Update the `serial` structure into [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/reset.yaml) playbook file. + Update the `serial` structure into [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/reset.yaml) playbook file. {{< /callout >}} ### `k3s_vars.server.controlplane.tainted` @@ -70,14 +70,14 @@ The `serial` structure has the following pattern: The setting allows the end-user to control where the Kubernetes pods will be deployed. In a scenario where there is only a single or no `agent` type nodes deployed, setting the value to `false` will allow pods to be deployed into any cluster node type. {{< callout type="info" >}} - Update the setting into K3s role [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/k3s/defaults/main.yaml) variables file. + Update the setting into K3s role [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/defaults/main.yaml) variables file. {{< /callout >}} {{% /steps %}} ## Configuration -The [`hosts.yaml`](https://{{< param variables.repository >}}/blob/main/inventory/cluster/hosts.yaml) inventory file contains the list of `server` and `agent` cluster node types. +The [`hosts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/inventory/cluster/hosts.yaml) inventory file contains the list of `server` and `agent` cluster node types. {{< callout type="info" >}} Please review the [K3s Architecture](https://docs.k3s.io/architecture), for further details. @@ -93,7 +93,7 @@ Example of a HA cluster inventory with 4 nodes: {{% details title="Inventory Details" closed="true" %}} -Inventory, set into [`hosts.yaml`](https://{{< param variables.repository >}}/blob/main/inventory/cluster/hosts.yaml) inventory file: +Inventory, set into [`hosts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/inventory/cluster/hosts.yaml) inventory file: ```yaml server: @@ -112,7 +112,7 @@ cluster: agent: ``` -Batch size, set into [`provisioning.yaml`](https://{{< param variables.repository >}}/blob/main/provisioning.yaml) playbook file: +Batch size, set into [`provisioning.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/provisioning.yaml) playbook file: ```yaml serial: @@ -121,7 +121,7 @@ serial: - 1 ``` -Batch size, set into [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/reset.yaml) playbook file: +Batch size, set into [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/reset.yaml) playbook file: ```yaml serial: @@ -137,7 +137,7 @@ serial: The above detailed configuration will introduce a SPOF, since Kubernetes pods are deployed to a single or no `agent` type nodes. {{< /callout >}} -To address this issue, set the `k3s_vars.server.controlplane.tainted` option to `false` into K3s role [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/k3s/defaults/main.yaml) variables file. +To address this issue, set the `k3s_vars.server.controlplane.tainted` option to `false` into K3s role [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/defaults/main.yaml) variables file. ### Non High Availability @@ -151,7 +151,7 @@ Example of a Non HA cluster inventory with 2 nodes: {{% details title="Inventory Details" closed="true" %}} -Inventory, set into [`hosts.yaml`](https://{{< param variables.repository >}}/blob/main/inventory/cluster/hosts.yaml) inventory file: +Inventory, set into [`hosts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/inventory/cluster/hosts.yaml) inventory file: ```yaml server: @@ -168,14 +168,14 @@ cluster: agent: ``` -Batch size, set into [`provisioning.yaml`](https://{{< param variables.repository >}}/blob/main/provisioning.yaml) playbook file: +Batch size, set into [`provisioning.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/provisioning.yaml) playbook file: ```yaml serial: - 1 ``` -Batch size, set into [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/reset.yaml) playbook file: +Batch size, set into [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/reset.yaml) playbook file: ```yaml serial: diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/argocd.md b/k3s-cluster/content/wiki/guide/configuration/roles/argocd.md index 933969b..122561d 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/argocd.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/argocd.md @@ -10,7 +10,7 @@ The role performs various tasks related to Helm chart deployment, reset and vali ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/argocd/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/defaults/main.yaml) defaults file. {{% steps %}} @@ -678,19 +678,19 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/argocd/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/tasks/facts.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/argocd/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/argocd/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/tasks/reset.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/argocd/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/tasks/validation.yaml) for details. {{% /steps %}} @@ -702,11 +702,11 @@ See the related role templates, listed below. ### Helm Chart -Helm chart values template, see [`values.j2`](https://{{< param variables.repository >}}/blob/main/roles/argocd/templates/values.j2) for details. +Helm chart values template, see [`values.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/templates/values.j2) for details. ### Gateway -Kubernetes `Gateway` resource template, see [`config.j2`](https://{{< param variables.repository >}}/blob/main/roles/argocd/templates/gateway.j2) for details. +Kubernetes `Gateway` resource template, see [`config.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/templates/gateway.j2) for details. ### HTTP Route @@ -714,17 +714,17 @@ Kubernetes `Gateway` resource template, see [`config.j2`](https://{{< param vari #### Insecure Route -Kubernetes `HTTPRoute` resource template, see [`http_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/argocd/templates/http_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`http_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/templates/http_route.j2) for details. #### Secure Route -Kubernetes `HTTPRoute` resource template, see [`https_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/argocd/templates/https_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`https_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/templates/https_route.j2) for details. {{% /steps %}} ### Load Balancer -Kubernetes `Service` resource template, see [`loadbalancer.j2`](https://{{< param variables.repository >}}/blob/main/roles/argocd/templates/loadbalancer.j2) for details. +Kubernetes `Service` resource template, see [`loadbalancer.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/templates/loadbalancer.j2) for details. ### User @@ -732,11 +732,11 @@ Kubernetes `Service` resource template, see [`loadbalancer.j2`](https://{{< para #### Name -Kubernetes `ConfigMap` resource template, see [`username.j2`](https://{{< param variables.repository >}}/blob/main/roles/argocd/templates/username.j2) for details. +Kubernetes `ConfigMap` resource template, see [`username.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/templates/username.j2) for details. #### Password -Kubernetes `Secret` resource template, see [`password.j2`](https://{{< param variables.repository >}}/blob/main/roles/argocd/templates/password.j2) for details. +Kubernetes `Secret` resource template, see [`password.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/argocd/templates/password.j2) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/certmanager.md b/k3s-cluster/content/wiki/guide/configuration/roles/certmanager.md index f004f20..dbf16d8 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/certmanager.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/certmanager.md @@ -10,7 +10,7 @@ The role performs various tasks related to Helm chart deployment, reset and vali ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/certmanager/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/certmanager/defaults/main.yaml) defaults file. {{% steps %}} @@ -252,19 +252,19 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/certmanager/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/certmanager/tasks/facts.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/certmanager/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/certmanager/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/certmanager/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/certmanager/tasks/reset.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/certmanager/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/certmanager/tasks/validation.yaml) for details. {{% /steps %}} @@ -276,10 +276,10 @@ See the related role templates, listed below. ### Helm Chart -Helm chart values template, see [`values.j2`](https://{{< param variables.repository >}}/blob/main/roles/certmanager/templates/values.j2) for details. +Helm chart values template, see [`values.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/certmanager/templates/values.j2) for details. ### Cluster Issuer -Kubernetes `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository >}}/blob/main/roles/certmanager/templates/cluster_issuer.j2) for details. +Kubernetes `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/certmanager/templates/cluster_issuer.j2) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/cilium.md b/k3s-cluster/content/wiki/guide/configuration/roles/cilium.md index 8e5c668..afba413 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/cilium.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/cilium.md @@ -10,7 +10,7 @@ The role performs various tasks related to Helm chart deployment, reset and vali ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cilium/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/defaults/main.yaml) defaults file. {{% steps %}} @@ -572,23 +572,23 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cilium/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/tasks/facts.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cilium/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cilium/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/tasks/reset.yaml) for details. ### Update -Update related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cilium/tasks/update.yaml) for details. +Update related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/tasks/update.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cilium/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/tasks/validation.yaml) for details. {{% /steps %}} @@ -600,19 +600,19 @@ See the related role templates, listed below. ### Helm Chart -Helm chart values template, see [`values.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/values.j2) for details. +Helm chart values template, see [`values.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/values.j2) for details. ### Certificate -Kubernetes `Certificate` resource template, see [`certificate.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/certificate.j2) for details. +Kubernetes `Certificate` resource template, see [`certificate.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/certificate.j2) for details. ### Cluster Issuer -Kubernetes `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/cluster_issuer.j2) for details. +Kubernetes `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/cluster_issuer.j2) for details. ### Gateway -Kubernetes `Gateway` resource template, see [`gateway.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/gateway.j2) for details. +Kubernetes `Gateway` resource template, see [`gateway.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/gateway.j2) for details. ### HTTP Route @@ -620,24 +620,24 @@ Kubernetes `Gateway` resource template, see [`gateway.j2`](https://{{< param var #### Insecure Route -Kubernetes `HTTPRoute` resource template, see [`http_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/http_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`http_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/http_route.j2) for details. #### Secure Route -Kubernetes `HTTPRoute` resource template, see [`https_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/https_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`https_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/https_route.j2) for details. {{% /steps %}} ### L2 Announcement Policy -Kubernetes `CiliumL2AnnouncementPolicy` resource template, see [`l2_announcement_policy.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/l2_announcement_policy.j2) for details. +Kubernetes `CiliumL2AnnouncementPolicy` resource template, see [`l2_announcement_policy.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/l2_announcement_policy.j2) for details. ### Load Balancer -Kubernetes `Service` resource template, see [`loadbalancer.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/loadbalancer.j2) for details. +Kubernetes `Service` resource template, see [`loadbalancer.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/loadbalancer.j2) for details. ### Load Balancer IP Pool -Kubernetes `CiliumLoadBalancerIPPool` resource template, see [`loadbalancer_ip_pool.j2`](https://{{< param variables.repository >}}/blob/main/roles/cilium/templates/loadbalancer_ip_pool.j2) for details. +Kubernetes `CiliumLoadBalancerIPPool` resource template, see [`loadbalancer_ip_pool.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cilium/templates/loadbalancer_ip_pool.j2) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/cloudflare.md b/k3s-cluster/content/wiki/guide/configuration/roles/cloudflare.md index 02c1b0a..58127f2 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/cloudflare.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/cloudflare.md @@ -10,7 +10,7 @@ The role performs various tasks related to [Cloudflare](https://www.cloudflare.c ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/defaults/main.yaml) defaults file. {{% steps %}} @@ -228,19 +228,19 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/tasks/facts.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/tasks/reset.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/tasks/validation.yaml) for details. {{% /steps %}} @@ -252,14 +252,14 @@ See the related role templates, listed below. ### Helm Chart -Helm chart values template, see [`values.j2`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/templates/values.j2) for details. +Helm chart values template, see [`values.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/templates/values.j2) for details. ### API Token -Kubernetes `Secret` resource template, see [`api_token.j2`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/templates/api_token.j2) for details. +Kubernetes `Secret` resource template, see [`api_token.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/templates/api_token.j2) for details. ### Cluster Issuer -Kubernetes `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository >}}/blob/main/roles/cloudflare/templates/cluster_issuer.j2) for details. +Kubernetes `ClusterIssuer` resource template, see [`cluster_issuer.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cloudflare/templates/cluster_issuer.j2) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/cluster.md b/k3s-cluster/content/wiki/guide/configuration/roles/cluster.md index 45d4f54..a680332 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/cluster.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/cluster.md @@ -11,7 +11,7 @@ The role performs various tasks related to OS configuration, reset and validatio ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/defaults/main.yaml) defaults file. {{% steps %}} @@ -307,34 +307,34 @@ See the related role tasks, listed below. ### Configuration -OS configuration related tasks, see [`configuration.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/tasks/configuration.yaml) for details. +OS configuration related tasks, see [`configuration.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/tasks/configuration.yaml) for details. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/tasks/facts.yaml) for details. ### Firewall -Firewall related tasks, can be used to also configure specific firewall rules. See [`firewall.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/tasks/firewall.yaml) for details. +Firewall related tasks, can be used to also configure specific firewall rules. See [`firewall.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/tasks/firewall.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/tasks/reset.yaml) for details. ### Upgrade -OS upgrade related tasks, see [`upgrade.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/tasks/upgrade.yaml) for details. +OS upgrade related tasks, see [`upgrade.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/tasks/upgrade.yaml) for details. ### User -User related tasks, see [`user.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/tasks/user.yaml) for details. +User related tasks, see [`user.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/tasks/user.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/tasks/validation.yaml) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/helm.md b/k3s-cluster/content/wiki/guide/configuration/roles/helm.md index fefb848..a226386 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/helm.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/helm.md @@ -11,7 +11,7 @@ The role performs various tasks related to OS configuration, reset and validatio ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/helm/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/helm/defaults/main.yaml) defaults file. {{% steps %}} @@ -89,18 +89,18 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/helm/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/helm/tasks/facts.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/helm/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/helm/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/helm/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/helm/tasks/reset.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/helm/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/helm/tasks/validation.yaml) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/k3s.md b/k3s-cluster/content/wiki/guide/configuration/roles/k3s.md index 1efe765..e6c813e 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/k3s.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/k3s.md @@ -11,7 +11,7 @@ The role performs various tasks related to OS configuration, K3s cluster deploym ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/k3s/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/defaults/main.yaml) defaults file. {{% steps %}} @@ -213,23 +213,23 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/k3s/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/tasks/facts.yaml) for details. ### Load Balancer -Load balancer related tasks, see [`loadbalancer.yaml`](https://{{< param variables.repository >}}/blob/main/roles/k3s/tasks/loadbalancer.yaml) for details. +Load balancer related tasks, see [`loadbalancer.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/tasks/loadbalancer.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/k3s/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/k3s/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/tasks/reset.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/k3s/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/tasks/validation.yaml) for details. {{% /steps %}} @@ -241,22 +241,22 @@ See the related role templates, listed below. ### Configuration -Cluster configuration template, see [`config.j2`](https://{{< param variables.repository >}}/blob/main/roles/k3s/templates/config.j2) for details. +Cluster configuration template, see [`config.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/templates/config.j2) for details. ### HAProxy -HAProxy configuration template, see [`haproxy.j2`](https://{{< param variables.repository >}}/blob/main/roles/k3s/templates/haproxy.j2) for details. +HAProxy configuration template, see [`haproxy.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/templates/haproxy.j2) for details. ### KeepAlived -KeepAlived configuration template, see [`keepalived.j2`](https://{{< param variables.repository >}}/blob/main/roles/k3s/templates/keepalived.j2) for details. +KeepAlived configuration template, see [`keepalived.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/templates/keepalived.j2) for details. ### Registries -[Registries](https://docs.k3s.io/installation/registry-mirror) configuration template, see [`registries.j2`](https://{{< param variables.repository >}}/blob/main/roles/k3s/templates/registries.j2) for details. +[Registries](https://docs.k3s.io/installation/registry-mirror) configuration template, see [`registries.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/templates/registries.j2) for details. ### Service -Service configuration template, see [`service.j2`](https://{{< param variables.repository >}}/blob/main/roles/k3s/templates/service.j2) for details. +Service configuration template, see [`service.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/k3s/templates/service.j2) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/kured.md b/k3s-cluster/content/wiki/guide/configuration/roles/kured.md index 8b135b5..0a728d4 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/kured.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/kured.md @@ -10,7 +10,7 @@ The role performs various tasks related to Helm chart deployment, reset and vali ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/kured/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/kured/defaults/main.yaml) defaults file. {{% steps %}} @@ -246,19 +246,19 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/kured/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/kured/tasks/facts.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/kured/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/kured/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/kured/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/kured/tasks/reset.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/kured/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/kured/tasks/validation.yaml) for details. {{% /steps %}} @@ -270,6 +270,6 @@ See the related role templates, listed below. ### Helm Chart -Helm chart values template, see [`values.j2`](https://{{< param variables.repository >}}/blob/main/roles/kured/templates/values.j2) for details. +Helm chart values template, see [`values.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/kured/templates/values.j2) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/longhorn.md b/k3s-cluster/content/wiki/guide/configuration/roles/longhorn.md index bb77e1c..bfeddd5 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/longhorn.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/longhorn.md @@ -10,7 +10,7 @@ The role performs various tasks related to Helm chart deployment, reset and vali ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/defaults/main.yaml) defaults file. {{% steps %}} @@ -162,19 +162,19 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/tasks/facts.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/tasks/reset.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/tasks/validation.yaml) for details. {{% /steps %}} @@ -186,11 +186,11 @@ See the related role templates, listed below. ### Helm Chart -Helm chart values template, see [`values.j2`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/templates/values.j2) for details. +Helm chart values template, see [`values.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/templates/values.j2) for details. ### Gateway -Kubernetes `Gateway` resource template, see [`gateway.j2`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/templates/gateway.j2) for details. +Kubernetes `Gateway` resource template, see [`gateway.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/templates/gateway.j2) for details. ### HTTP Route @@ -198,16 +198,16 @@ Kubernetes `Gateway` resource template, see [`gateway.j2`](https://{{< param var #### Insecure Route -Kubernetes `HTTPRoute` resource template, see [`http_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/templates/http_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`http_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/templates/http_route.j2) for details. #### Secure Route -Kubernetes `HTTPRoute` resource template, see [`https_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/templates/https_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`https_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/templates/https_route.j2) for details. {{% /steps %}} ### Load Balancer -Kubernetes `Service` resource template, see [`loadbalancer.j2`](https://{{< param variables.repository >}}/blob/main/roles/longhorn/templates/loadbalancer.j2) for details. +Kubernetes `Service` resource template, see [`loadbalancer.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/longhorn/templates/loadbalancer.j2) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/roles/prometheus.md b/k3s-cluster/content/wiki/guide/configuration/roles/prometheus.md index 08bd6d3..046151b 100644 --- a/k3s-cluster/content/wiki/guide/configuration/roles/prometheus.md +++ b/k3s-cluster/content/wiki/guide/configuration/roles/prometheus.md @@ -10,7 +10,7 @@ The role performs various tasks related to OS configuration, chart deployment, r ## Role Settings -See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/defaults/main.yaml) defaults file. +See the related role settings listed below, defined into [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/defaults/main.yaml) defaults file. {{% steps %}} @@ -336,19 +336,19 @@ See the related role tasks, listed below. ### Facts -Ansible facts, see [`facts.yaml`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/tasks/facts.yaml) for details. +Ansible facts, see [`facts.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/tasks/facts.yaml) for details. ### Main -Main role related tasks, see [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/tasks/main.yaml) for details. +Main role related tasks, see [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/tasks/main.yaml) for details. ### Reset -Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/tasks/reset.yaml) for details. +Reset related tasks, see [`reset.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/tasks/reset.yaml) for details. ### Validation -Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/tasks/validation.yaml) for details. +Validation related tasks, see [`validation.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/tasks/validation.yaml) for details. {{% /steps %}} @@ -360,7 +360,7 @@ See the related role templates, listed below. ### Helm Chart -Helm chart values template, see [`values.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/values.j2) for details. +Helm chart values template, see [`values.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/values.j2) for details. ### Alert Manager @@ -368,7 +368,7 @@ Helm chart values template, see [`values.j2`](https://{{< param variables.reposi #### Gateway -Kubernetes `Gateway` resource template, see [`alertmanager_gateway.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/alertmanager_gateway.j2) for details. +Kubernetes `Gateway` resource template, see [`alertmanager_gateway.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/alertmanager_gateway.j2) for details. #### HTTP Route @@ -376,11 +376,11 @@ Kubernetes `Gateway` resource template, see [`alertmanager_gateway.j2`](https:// ##### Insecure Route -Kubernetes `HTTPRoute` resource template, see [`alertmanager_http_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/alertmanager_http_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`alertmanager_http_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/alertmanager_http_route.j2) for details. ##### Secure Route -Kubernetes `HTTPRoute` resource template, see [`alertmanager_https_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/alertmanager_https_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`alertmanager_https_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/alertmanager_https_route.j2) for details. {{% /steps %}} @@ -392,11 +392,11 @@ Kubernetes `HTTPRoute` resource template, see [`alertmanager_https_route.j2`](ht #### Credentials -Kubernetes `Secret` resource template, see [`grafana_credentials.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/grafana_credentials.j2) for details. +Kubernetes `Secret` resource template, see [`grafana_credentials.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/grafana_credentials.j2) for details. #### Gateway -Kubernetes `Gateway` resource template, see [`grafana_gateway.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/grafana_gateway.j2) for details. +Kubernetes `Gateway` resource template, see [`grafana_gateway.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/grafana_gateway.j2) for details. #### HTTP Route @@ -404,11 +404,11 @@ Kubernetes `Gateway` resource template, see [`grafana_gateway.j2`](https://{{< p ##### Insecure Route -Kubernetes `HTTPRoute` resource template, see [`grafana_http_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/grafana_http_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`grafana_http_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/grafana_http_route.j2) for details. ##### Secure Route -Kubernetes `HTTPRoute` resource template, see [`grafana_https_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/grafana_https_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`grafana_https_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/grafana_https_route.j2) for details. {{% /steps %}} @@ -420,7 +420,7 @@ Kubernetes `HTTPRoute` resource template, see [`grafana_https_route.j2`](https:/ #### Gateway -Kubernetes `Gateway` resource template, see [`prometheus_gateway.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/prometheus_gateway.j2) for details. +Kubernetes `Gateway` resource template, see [`prometheus_gateway.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/prometheus_gateway.j2) for details. #### HTTP Route @@ -428,11 +428,11 @@ Kubernetes `Gateway` resource template, see [`prometheus_gateway.j2`](https://{{ ##### Insecure Route -Kubernetes `HTTPRoute` resource template, see [`prometheus_http_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/prometheus_http_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`prometheus_http_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/prometheus_http_route.j2) for details. ##### Secure Route -Kubernetes `HTTPRoute` resource template, see [`prometheus_https_route.j2`](https://{{< param variables.repository >}}/blob/main/roles/prometheus/templates/prometheus_https_route.j2) for details. +Kubernetes `HTTPRoute` resource template, see [`prometheus_https_route.j2`](https://{{< param variables.repository.cluster >}}/blob/main/roles/prometheus/templates/prometheus_https_route.j2) for details. {{% /steps %}} diff --git a/k3s-cluster/content/wiki/guide/configuration/user.md b/k3s-cluster/content/wiki/guide/configuration/user.md index cc78d55..0647144 100644 --- a/k3s-cluster/content/wiki/guide/configuration/user.md +++ b/k3s-cluster/content/wiki/guide/configuration/user.md @@ -13,7 +13,7 @@ The Ansible user is used to remotely execute various deployment tasks into clust ### User Name -Set the [`ansible_user`](https://docs.ansible.com/ansible/latest/reference_appendices/special_variables.html) variable into [`all.yaml`](https://{{< param variables.repository >}}/blob/main/inventory/cluster/group_vars/all.yaml) global configuration file. +Set the [`ansible_user`](https://docs.ansible.com/ansible/latest/reference_appendices/special_variables.html) variable into [`all.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/inventory/cluster/group_vars/all.yaml) global configuration file. {{< callout type="warning" >}} Use the `username` value defined into [OS General Settings](/k3s-cluster/tutorials/handbook/server/#os-general-settings) server installation, to set the `ansible_user` variable. @@ -21,7 +21,7 @@ Set the [`ansible_user`](https://docs.ansible.com/ansible/latest/reference_appen ### User Password -Encrypt the `ansible_password` variable with [`ansible-vault`](/k3s-cluster/tutorials/handbook/ansible/#vault) and set the encrypted value into [`all.yaml`](https://{{< param variables.repository >}}/blob/main/inventory/cluster/group_vars/all.yaml) global configuration file. +Encrypt the `ansible_password` variable with [`ansible-vault`](/k3s-cluster/tutorials/handbook/ansible/#vault) and set the encrypted value into [`all.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/inventory/cluster/group_vars/all.yaml) global configuration file. ### SSH Key @@ -35,6 +35,6 @@ ssh-keygen -t ed25519 -C 'your_email@example.com' The [Provisioning](/k3s-cluster/wiki/guide/playbooks/provisioning) playbook will look for the generated SSH key, into default `/Users/username/.ssh` location. {{< /callout >}} -For a different storage location, update the [`cluster_vars.ssh.authorized_key`](/k3s-cluster/wiki/guide/configuration/roles/cluster/#sshauthorized_key) value into Cluster role [`main.yaml`](https://{{< param variables.repository >}}/blob/main/roles/cluster/defaults/main.yaml) configuration file. +For a different storage location, update the [`cluster_vars.ssh.authorized_key`](/k3s-cluster/wiki/guide/configuration/roles/cluster/#sshauthorized_key) value into Cluster role [`main.yaml`](https://{{< param variables.repository.cluster >}}/blob/main/roles/cluster/defaults/main.yaml) configuration file. {{% /steps %}} diff --git a/k3s-cluster/hugo.yaml b/k3s-cluster/hugo.yaml index 896457c..304a1a4 100644 --- a/k3s-cluster/hugo.yaml +++ b/k3s-cluster/hugo.yaml @@ -58,5 +58,7 @@ params: os: previous_version: 22.04 version: 24.04 - repository: github.com/axivo/k3s-cluster + repository: + applications: github.com/axivo/k3s-applications + cluster: github.com/axivo/k3s-cluster publishDir: ../public/k3s-cluster