From e33f29ee46ec1332455db5e513676cffa0435bd0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rapha=C3=ABl=20Pinson?= Date: Tue, 9 Nov 2021 14:12:40 +0100 Subject: [PATCH] docs(kind): add docs for Kind MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Raphaël Pinson --- .../ROOT/pages/howtos/quickstart_kind.adoc | 38 +++++++++++++++++++ .../references/applications/traefik.adoc | 2 +- .../terraform_modules/aks/azure.adoc | 8 ++-- site/data/en/homepage.yml | 3 ++ 4 files changed, 46 insertions(+), 5 deletions(-) create mode 100644 docs/modules/ROOT/pages/howtos/quickstart_kind.adoc diff --git a/docs/modules/ROOT/pages/howtos/quickstart_kind.adoc b/docs/modules/ROOT/pages/howtos/quickstart_kind.adoc new file mode 100644 index 0000000000..f5b513b411 --- /dev/null +++ b/docs/modules/ROOT/pages/howtos/quickstart_kind.adoc @@ -0,0 +1,38 @@ += Kind Quickstart + +== Prerequisites + +- Access to a functional Docker Engine, +- Knowledge of https://terraform.io[Terraform] basics +- Minimal Terraform version: 0.14 +- `jq` binary +- https://argoproj.github.io/argo-cd/cli_installation/[argocd] CLI + + +include::partial$terraform_instant_intro.adoc[] + +```hcl +# terraform/main.tf + +module "cluster" { + source = "git::https://github.com/camptocamp/devops-stack.git//modules/kind/kind?ref=master" + + cluster_name = "my-cluster" +} +``` + +If your docker setup doesn't support the bridge0 like on MacOSX, you cannot access to the container IP so the computed base domain isn't reachable. + + +include::partial$tf_apply.adoc[] + +include::partial$wait_for_keycloak.adoc[] + +include::partial$access_keycloak.adoc[] + +include::partial$tf_destroy.adoc[] + + +== Reference + +See the xref:ROOT:references/terraform_modules/kind/kind.adoc[Kind reference page]. diff --git a/docs/modules/ROOT/pages/references/applications/traefik.adoc b/docs/modules/ROOT/pages/references/applications/traefik.adoc index 4f2814cfef..96a5960315 100644 --- a/docs/modules/ROOT/pages/references/applications/traefik.adoc +++ b/docs/modules/ROOT/pages/references/applications/traefik.adoc @@ -17,6 +17,6 @@ cluster Ingress Controller. |=== |Key |Type |Default |Description |traefik |object -|`{"additionalArguments":["--metrics.prometheus=true","--serversTransport.insecureSkipVerify=true"],"deployment":{"replicas":2},"logs":{"access":{"enabled":true}}}` +|`{"additionalArguments":["--metrics.prometheus=true","--serversTransport.insecureSkipVerify=true"],"deployment":{"replicas":2},"logs":{"access":{"enabled":true}},"tlsOptions":{"default":{"minVersion":"VersionTLS12"}}}` |Values passed to the traefik chart |=== diff --git a/docs/modules/ROOT/pages/references/terraform_modules/aks/azure.adoc b/docs/modules/ROOT/pages/references/terraform_modules/aks/azure.adoc index fff686cc35..c2d0e6ab83 100644 --- a/docs/modules/ROOT/pages/references/terraform_modules/aks/azure.adoc +++ b/docs/modules/ROOT/pages/references/terraform_modules/aks/azure.adoc @@ -11,7 +11,7 @@ The `aks/azure` Terraform module provides a way to install and configure: |=== |Name |Version |[[requirement_terraform]] <> |>= 0.13 -|[[requirement_azuread]] <> |~> 1.5 +|[[requirement_azuread]] <> |~> 2.0 |[[requirement_azurerm]] <> |~> 2.62 |[[requirement_helm]] <> |~> 2.0 |[[requirement_kubernetes]] <> |~> 2.0 @@ -25,7 +25,7 @@ The `aks/azure` Terraform module provides a way to install and configure: [cols="a,a",options="header,autowidth"] |=== |Name |Version -|[[provider_azuread]] <> |~> 1.5 +|[[provider_azuread]] <> |~> 2.0 |[[provider_azurerm]] <> |~> 2.62 |[[provider_random]] <> |~> 3.0 |=== @@ -45,7 +45,6 @@ The `aks/azure` Terraform module provides a way to install and configure: |=== |Name |Type |https://registry.terraform.io/providers/hashicorp/azuread/latest/docs/resources/application[azuread_application.oauth2_apps] |resource -|https://registry.terraform.io/providers/hashicorp/azuread/latest/docs/resources/application_app_role[azuread_application_app_role.argocd_admin] |resource |https://registry.terraform.io/providers/hashicorp/azuread/latest/docs/resources/application_password[azuread_application_password.oauth2_apps] |resource |https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/dns_cname_record[azurerm_dns_cname_record.wildcard] |resource |https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/kubernetes_cluster_node_pool[azurerm_kubernetes_cluster_node_pool.this] |resource @@ -60,8 +59,9 @@ The `aks/azure` Terraform module provides a way to install and configure: |https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/user_assigned_identity[azurerm_user_assigned_identity.kube_prometheus_stack_prometheus] |resource |https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/user_assigned_identity[azurerm_user_assigned_identity.this] |resource |https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/password[random_password.grafana_admin_password] |resource -|https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/password[random_password.oauth2_apps] |resource |https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/string[random_string.storage_account] |resource +|https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/uuid[random_uuid.argocd_app_role] |resource +|https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/uuid[random_uuid.resource_app_id] |resource |https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/client_config[azurerm_client_config.current] |data source |https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/dns_zone[azurerm_dns_zone.this] |data source |https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/kubernetes_cluster[azurerm_kubernetes_cluster.cluster] |data source diff --git a/site/data/en/homepage.yml b/site/data/en/homepage.yml index 1f98128da9..f09fa1eac9 100644 --- a/site/data/en/homepage.yml +++ b/site/data/en/homepage.yml @@ -31,6 +31,9 @@ banner: - label: "K3S Quickstart" icon: "fa fa-hat-cowboy-side" link: "/docs/devops-stack/__VERSION__/howtos/quickstart_k3s_docker.html" + - label: "Kind Quickstart" + icon: "fa fa-wine-bottle" + link: "/docs/devops-stack/__VERSION__/howtos/quickstart_kind.html" # Components components: