You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Running Gitpod in [Azure AKS](https://azure.microsoft.com/en-gb/services/kubernetes-service/)
2
2
3
-
> **IMPORTANT** This guide exists as a simple and reliable way of creating a Gitpod instance in Azure AKS. It
4
-
> is not designed to cater for every situation. If you find that it does not meet your exact needs,
3
+
> **IMPORTANT** This guide exists as a simple and reliable way of creating an environment in AKS that can run Gitpod. It is not designed to cater for every situation. If you find that it does not meet your exact needs,
5
4
> please fork this guide and amend it to your own needs.
6
5
7
6
Before starting the installation process, you need:
@@ -28,7 +27,7 @@ To sign in, use a web browser to open the page https://microsoft.com/devicelogin
28
27
make install
29
28
```
30
29
31
-
The whole process takes around twenty minutes. In the end, the following resources are created:
30
+
The whole process takes around twenty minutes. In the end, the following resources are created. These are the Azure versions of the [components Gitpod requires](https://www.gitpod.io/docs/self-hosted/latest/required-components):
32
31
33
32
- an AKS cluster running Kubernetes v1.21.
34
33
- Azure load balancer.
@@ -39,15 +38,14 @@ The whole process takes around twenty minutes. In the end, the following resourc
39
38
-[calico](https://docs.projectcalico.org) as CNI and NetworkPolicy implementation.
40
39
-[cert-manager](https://cert-manager.io/) for self-signed SSL certificates.
41
40
42
-
Upon completion, it will print the config for resource (including passwords) and instructions on what
43
-
to do next. **IMPORTANT** - running the `make install` command after the initial install will change
41
+
Upon completion, it will print the config for the resources created (including passwords) and instructions on what to do next. **IMPORTANT** - running the `make install` command after the initial install will change
44
42
your database password which will require you to update your KOTS configuration.
45
43
46
44
## DNS records
47
45
48
46
> This setup will work even if the parent domain is not owned by a DNS zone in the Azure portal.
49
47
50
-
The recommended setup is to have `SETUP_MANAGED_DNS`to be `true` which will create an
48
+
The recommended setup is to have `SETUP_MANAGED_DNS` be `true` which will create an
51
49
[Azure DNS zone](https://docs.microsoft.com/en-us/azure/dns/dns-zones-records) for your
52
50
domain. When the zone is created, you will see various nameserver records (with type `NS`), such
53
51
as `ns1-xx.azure-dns.com`, `ns2-xx.azure-dns.net`, `ns3-xx.azure-dns.org` and `ns4-xx.azure-dns.info`
@@ -59,7 +57,7 @@ This is what it would look like if your parent domain was using Cloudflare.
59
57
60
58

61
59
62
-
Once applied, please allow a few minutes to for DNS propagation.
60
+
Once applied, please allow a few minutes for DNS propagation.
63
61
64
62
### Common errors running make install
65
63
@@ -78,7 +76,7 @@ Once applied, please allow a few minutes to for DNS propagation.
78
76
proxy-5998488f4c-t8vkh 0/1 Init 0/1 0 5m
79
77
```
80
78
81
-
The most likely reason is because the [DNS01 challenge](https://cert-manager.io/docs/configuration/acme/dns01/) has yet to resolve. If using `SETUP_MANAGED_DNS`, you will need to update your DNS records to point to the Azure DNS zone nameserver.
79
+
The most likely reason is that the [DNS01 challenge](https://cert-manager.io/docs/configuration/acme/dns01/) has yet to resolve. If using `SETUP_MANAGED_DNS`, you will need to update your DNS records to point to the Azure DNS zone nameserver.
82
80
83
81
Once the DNS record has been updated, you will need to delete all cert-manager pods to retrigger the certificate request
84
82
@@ -94,54 +92,6 @@ Once applied, please allow a few minutes to for DNS propagation.
0 commit comments