Commit 24a4280b authored by João Cunha's avatar João Cunha

Update ADO docs on how to install ingress

Now that the Cluster management project template is available,
and GMA v1 is removed,
and GMA v2 is deprecated,
users should use the new template to install ingress.

Also fix some anchor typos in old links.
parent bc1ffbca
...@@ -289,8 +289,8 @@ To add a different cluster for each environment: ...@@ -289,8 +289,8 @@ To add a different cluster for each environment:
1. Navigate to your project's **Operations > Kubernetes**. 1. Navigate to your project's **Operations > Kubernetes**.
1. Create the Kubernetes clusters with their respective environment scope, as 1. Create the Kubernetes clusters with their respective environment scope, as
described from the table above. described from the table above.
1. After creating the clusters, navigate to each cluster and install 1. After creating the clusters, navigate to each cluster and [install
Ingress. Wait for the Ingress IP address to be assigned. Ingress](quick_start_guide.md#install-ingress). Wait for the Ingress IP address to be assigned.
1. Make sure you've [configured your DNS](#auto-devops-base-domain) with the 1. Make sure you've [configured your DNS](#auto-devops-base-domain) with the
specified Auto DevOps domains. specified Auto DevOps domains.
1. Navigate to each cluster's page, through **Operations > Kubernetes**, 1. Navigate to each cluster's page, through **Operations > Kubernetes**,
......
...@@ -106,7 +106,8 @@ status on your [GCP dashboard](https://console.cloud.google.com/kubernetes). ...@@ -106,7 +106,8 @@ status on your [GCP dashboard](https://console.cloud.google.com/kubernetes).
After your cluster is running, you must install NGINX Ingress Controller as a After your cluster is running, you must install NGINX Ingress Controller as a
load balancer, to route traffic from the internet to your application. Because load balancer, to route traffic from the internet to your application. Because
you've created a Google GKE cluster in this guide, you can install NGINX Ingress Controller you've created a Google GKE cluster in this guide, you can install NGINX Ingress Controller
with Google Cloud Shell: through the GitLab [Cluster management project template](../../user/clusters/management_project_template.md),
or manually with Google Cloud Shell:
1. Go to your cluster's details page, and click the **Advanced Settings** tab. 1. Go to your cluster's details page, and click the **Advanced Settings** tab.
1. Click the link to Google Kubernetes Engine to visit the cluster on Google Cloud Console. 1. Click the link to Google Kubernetes Engine to visit the cluster on Google Cloud Console.
...@@ -122,12 +123,26 @@ with Google Cloud Shell: ...@@ -122,12 +123,26 @@ with Google Cloud Shell:
kubectl get service nginx-ingress-nginx-ingress kubectl get service nginx-ingress-nginx-ingress
``` ```
## Configure your Base Domain
Follow these steps to configure the Base Domain where your apps will be accessible.
1. A few minutes after you install NGINX, the load balancer obtains an IP address, and you can 1. A few minutes after you install NGINX, the load balancer obtains an IP address, and you can
get the external IP address with this command: get the external IP address with the following command:
```shell - If you installed it manually through the [Cluster management project template](../../user/clusters/management_project_template.md):
kubectl get service nginx-ingress-nginx-ingress -ojson | jq -r '.status.loadBalancer.ingress[].ip'
``` ```shell
kubectl get service ingress-nginx-ingress-controller -n gitlab-managed-apps -ojson | jq -r '.status.loadBalancer.ingress[].ip'
```
Replace `gitlab-managed-apps` if you have overwritten your namespace.
- If you installed it manually through Google Cloud Shell:
```shell
kubectl get service nginx-ingress-nginx-ingress -ojson | jq -r '.status.loadBalancer.ingress[].ip'
```
Copy this IP address, as you need it in the next step. Copy this IP address, as you need it in the next step.
......
...@@ -30,8 +30,8 @@ To make full use of Auto DevOps with Kubernetes, you need: ...@@ -30,8 +30,8 @@ To make full use of Auto DevOps with Kubernetes, you need:
deployments, any Ingress controller should work, but as of GitLab 14.0, deployments, any Ingress controller should work, but as of GitLab 14.0,
[canary deployments](../../user/project/canary_deployments.md) require [canary deployments](../../user/project/canary_deployments.md) require
NGINX Ingress. You can deploy the NGINX Ingress controller to your NGINX Ingress. You can deploy the NGINX Ingress controller to your
Kubernetes cluster by installing the Kubernetes cluster either through the GitLab [Cluster management project template](../../user/clusters/management_project_template.md)
[`ingress-nginx`](https://github.com/kubernetes/ingress-nginx/tree/master/charts/ingress-nginx) or manually by using the [`ingress-nginx`](https://github.com/kubernetes/ingress-nginx/tree/master/charts/ingress-nginx)
Helm chart. Helm chart.
NOTE: NOTE:
......
...@@ -1029,7 +1029,9 @@ at least 2 people from the ...@@ -1029,7 +1029,9 @@ at least 2 people from the
The one-click installation method was deprecated in GitLab 13.9 and removed in [GitLab 14.0](https://gitlab.com/groups/gitlab-org/-/epics/4280). The one-click installation method was deprecated in GitLab 13.9 and removed in [GitLab 14.0](https://gitlab.com/groups/gitlab-org/-/epics/4280).
The removal does not break nor uninstall any apps you have installed, it only The removal does not break nor uninstall any apps you have installed, it only
removes the "Applications" tab from the cluster page. removes the "Applications" tab from the cluster page.
Follow the process to [take ownership of your GitLab Managed Apps](#take-ownership-of-your-gitlab-managed-apps). The new recommended way to manage cluster applications is to use the [cluster management project template](management_project_template.md).
If you want to migrate your GitLab managed apps management to this template, reference to [migrating from GitLab managed apps to project template](migrating_from_gma_to_project_template.md).
If you don't want to use the template, you can also manually manage your applications. For that, follow the process to [take ownership of your GitLab Managed Apps](#take-ownership-of-your-gitlab-managed-apps).
If you are not yet on GitLab 14.0 or later, you can refer to [an older version of this document](https://docs.gitlab.com/13.12/ee/user/clusters/applications.html#install-with-one-click-deprecated). If you are not yet on GitLab 14.0 or later, you can refer to [an older version of this document](https://docs.gitlab.com/13.12/ee/user/clusters/applications.html#install-with-one-click-deprecated).
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment