Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Léo-Paul Géneau
gitlab-ce
Commits
b7a01e08
Commit
b7a01e08
authored
Nov 16, 2017
by
Achilleas Pipinellis
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add info on creating your own k8s cluster from the cluster page
parent
644a2941
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
32 additions
and
21 deletions
+32
-21
doc/user/project/clusters/index.md
doc/user/project/clusters/index.md
+32
-21
No files found.
doc/user/project/clusters/index.md
View file @
b7a01e08
# 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:
...
@@ -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.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment