Add info on creating your own k8s cluster from the cluster page
This commit is contained in:
parent
644a2941c0
commit
b7a01e08b2
|
@ -1,14 +1,15 @@
|
||||||
# Connecting GitLab with GKE
|
# Connecting GitLab with a Kubernetes cluster
|
||||||
|
|
||||||
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/35954) in 10.1.
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/35954) in 10.1.
|
||||||
|
|
||||||
CAUTION: **Warning:**
|
CAUTION: **Warning:**
|
||||||
The Cluster integration is currently in **Beta**.
|
The Cluster integration is currently in **Beta**.
|
||||||
|
|
||||||
Connect your project to Google Container Engine (GKE) in a few steps.
|
|
||||||
|
|
||||||
With a cluster associated to your project, you can use Review Apps, deploy your
|
With a cluster associated to your project, you can use Review Apps, deploy your
|
||||||
applications, run your pipelines, and much more in an easy way.
|
applications, run your pipelines, and much more, in an easy way.
|
||||||
|
|
||||||
|
Connect your project to Google Container Engine (GKE) or your own Kubernetes
|
||||||
|
cluster in a few steps.
|
||||||
|
|
||||||
NOTE: **Note:**
|
NOTE: **Note:**
|
||||||
The Cluster integration will eventually supersede the
|
The Cluster integration will eventually supersede the
|
||||||
|
@ -30,31 +31,41 @@ prerequisites must be met:
|
||||||
- You must have Master [permissions] in order to be able to access the **Cluster**
|
- You must have Master [permissions] in order to be able to access the **Cluster**
|
||||||
page.
|
page.
|
||||||
|
|
||||||
If all of the above requirements are met, you can proceed to add a new cluster.
|
If all of the above requirements are met, you can proceed to add a new GKE
|
||||||
|
cluster.
|
||||||
|
|
||||||
## Adding a cluster
|
## Adding a cluster
|
||||||
|
|
||||||
NOTE: **Note:**
|
NOTE: **Note:**
|
||||||
You need Master [permissions] and above to add a cluster.
|
You need Master [permissions] and above to add a cluster.
|
||||||
|
|
||||||
|
There are two options when adding a new cluster; either use Google Container
|
||||||
|
Engine (GKE) or provide the credentials to your own Kubernetes cluster.
|
||||||
|
|
||||||
To add a new cluster:
|
To add a new cluster:
|
||||||
|
|
||||||
1. Navigate to your project's **CI/CD > Cluster** page.
|
1. Navigate to your project's **CI/CD > Cluster** page
|
||||||
1. Connect your Google account if you haven't done already by clicking the
|
1. If you want to let GitLab create a cluster on GKE for you, go through the
|
||||||
"Sign-in with Google" button.
|
following steps, otherwise skip to the next one.
|
||||||
1. Fill in the requested values:
|
1. Click on **Create with GKE**
|
||||||
- **Cluster name** (required) - The name you wish to give the cluster.
|
1. Connect your Google account if you haven't done already by clicking the
|
||||||
- **GCP project ID** (required) - The ID of the project you created in your GCP
|
**Sign in with Google** button
|
||||||
console that will host the Kubernetes cluster. This must **not** be confused
|
1. Fill in the requested values:
|
||||||
with the project name. Learn more about [Google Cloud Platform projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects).
|
- **Cluster name** (required) - The name you wish to give the cluster.
|
||||||
- **Zone** - The zone under which the cluster will be created. Read more about
|
- **GCP project ID** (required) - The ID of the project you created in your GCP
|
||||||
[the available zones](https://cloud.google.com/compute/docs/regions-zones/).
|
console that will host the Kubernetes cluster. This must **not** be confused
|
||||||
- **Number of nodes** - The number of nodes you wish the cluster to have.
|
with the project name. Learn more about [Google Cloud Platform projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects).
|
||||||
- **Machine type** - The machine type of the Virtual Machine instance that
|
- **Zone** - The zone under which the cluster will be created. Read more about
|
||||||
the cluster will be based on. Read more about [the available machine types](https://cloud.google.com/compute/docs/machine-types).
|
[the available zones](https://cloud.google.com/compute/docs/regions-zones/).
|
||||||
- **Project namespace** - The unique namespace for this project. By default you
|
- **Number of nodes** - The number of nodes you wish the cluster to have.
|
||||||
don't have to fill it in; by leaving it blank, GitLab will create one for you.
|
- **Machine type** - The machine type of the Virtual Machine instance that
|
||||||
1. Click the **Create cluster** button.
|
the cluster will be based on. Read more about [the available machine types](https://cloud.google.com/compute/docs/machine-types).
|
||||||
|
- **Project namespace** - The unique namespace for this project. By default you
|
||||||
|
don't have to fill it in; by leaving it blank, GitLab will create one for you.
|
||||||
|
1. If you want to use your own Kubernetes cluster, click on
|
||||||
|
**Add an existing cluster** and fill in the details as described in the
|
||||||
|
[Kubernetes integration](../integrations/kubernetes.md) documentation.
|
||||||
|
1. Finally, click the **Create cluster** button
|
||||||
|
|
||||||
After a few moments, your cluster should be created. If something goes wrong,
|
After a few moments, your cluster should be created. If something goes wrong,
|
||||||
you will be notified.
|
you will be notified.
|
||||||
|
|
Loading…
Reference in New Issue