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
1
Merge Requests
1
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
nexedi
gitlab-ce
Commits
98bc4a6a
Commit
98bc4a6a
authored
Jun 05, 2020
by
Amy Qualls
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add 'EKS' to acronym list
This acronym doesn't need re-defining frequently.
parent
9de9a747
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
36 additions
and
35 deletions
+36
-35
doc/.vale/gitlab/Acronyms.yml
doc/.vale/gitlab/Acronyms.yml
+1
-0
doc/user/project/clusters/add_eks_clusters.md
doc/user/project/clusters/add_eks_clusters.md
+35
-35
No files found.
doc/.vale/gitlab/Acronyms.yml
View file @
98bc4a6a
...
...
@@ -19,6 +19,7 @@ exceptions:
-
CSS
-
CSV
-
DNS
-
EKS
-
GET
-
GNU
-
GPG
...
...
doc/user/project/clusters/add_eks_clusters.md
View file @
98bc4a6a
...
...
@@ -164,6 +164,41 @@ You will need to add your AWS external ID to the
[
IAM Role in the AWS CLI
](
https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-role.html#cli-configure-role-xaccount
)
to manage your cluster using
`kubectl`
.
### Troubleshooting creating a new cluster
The following errors are commonly encountered when creating a new cluster.
#### Error: Request failed with status code 422
When submitting the initial authentication form, GitLab returns a status code 422
error when it can't determine the role you've provided. Make sure you've
correctly configured your role with the
**Account ID**
and
**External ID**
provided by GitLab. In GitLab, make sure to enter the correct
**Role ARN**
.
#### Could not load Security Groups for this VPC
When populating options in the configuration form, GitLab returns this error
because GitLab has successfully assumed your provided role, but the role has
insufficient permissions to retrieve the resources needed for the form. Make sure
you've assigned the role the correct permissions.
#### `ROLLBACK_FAILED` during cluster creation
The creation process halted because GitLab encountered an error when creating
one or more resources. You can inspect the associated
[
CloudFormation stack
](
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html
)
to find the specific resources that failed to create.
If the
`Cluster`
resource failed with the error
`The provided role doesn't have the Amazon EKS Managed Policies associated with it.`
,
the role specified in
**Role name**
is not configured correctly.
NOTE:
**Note:**
This role should not be the same as the one created above. If you don't have an
existing
[
EKS cluster IAM role
](
https://docs.aws.amazon.com/eks/latest/userguide/service_IAM_role.html
)
,
you must create one.
## Existing EKS cluster
To add an existing EKS cluster to your project, group, or instance:
...
...
@@ -311,38 +346,3 @@ to users. Click on **CI/CD > Environments**.
You will see a list of the environments and their deploy status, as well as
options to browse to the app, view monitoring metrics, and even access a shell
on the running pod.
## Troubleshooting
The following errors are commonly encountered.
### Error: Request failed with status code 422
When submitting the initial authentication form, GitLab returns a status code 422
error when it can't determine the role you've provided. Make sure you've
correctly configured your role with the
**Account ID**
and
**External ID**
provided by GitLab. In GitLab, make sure to enter the correct
**Role ARN**
.
### Could not load Security Groups for this VPC
When populating options in the configuration form, GitLab returns this error
because GitLab has successfully assumed your provided role, but the role has
insufficient permissions to retrieve the resources needed for the form. Make sure
you've assigned the role the correct permissions.
### `ROLLBACK_FAILED` during cluster creation
The creation process halted because GitLab encountered an error when creating
one or more resources. You can inspect the associated
[
CloudFormation stack
](
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-view-stack-data-resources.html
)
to find the specific resources that failed to create.
If the
`Cluster`
resource failed with the error
`The provided role doesn't have the Amazon EKS Managed Policies associated with it.`
,
the role specified in
**Role name**
is not configured correctly.
NOTE:
**Note:**
This role should not be the same as the one created above. If you don't have an
existing
[
EKS cluster IAM role
](
https://docs.aws.amazon.com/eks/latest/userguide/service_IAM_role.html
)
,
you must create one.
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