diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2020-03-23 06:09:28 +0000 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2020-03-23 06:09:28 +0000 |
commit | 1635eacd2a9293cd04d21e82def6e2c14ed01242 (patch) | |
tree | 257df93e8de5920c325651811af841128f20f2bc /doc/user/clusters/applications.md | |
parent | 5b51129e3356a12283f0ba2da15db897ee30cf1a (diff) | |
download | gitlab-ce-1635eacd2a9293cd04d21e82def6e2c14ed01242.tar.gz |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc/user/clusters/applications.md')
-rw-r--r-- | doc/user/clusters/applications.md | 66 |
1 files changed, 33 insertions, 33 deletions
diff --git a/doc/user/clusters/applications.md b/doc/user/clusters/applications.md index a2d42573321..9165b5c2f5d 100644 --- a/doc/user/clusters/applications.md +++ b/doc/user/clusters/applications.md @@ -529,7 +529,7 @@ Interested in contributing a new GitLab managed app? Visit the [development guidelines page](../../development/kubernetes.md#gitlab-managed-apps) to get started. -## Install using GitLab CI (alpha) +## Install using GitLab CI/CD (alpha) > [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/20822) in GitLab 12.6. @@ -538,20 +538,20 @@ This is an _alpha_ feature, and it is subject to change at any time without prior notice. This alternative method allows users to install GitLab-managed -applications using GitLab CI. It also allows customization of the +applications using GitLab CI/CD. It also allows customization of the install using Helm `values.yaml` files. Supported applications: -- [Ingress](#install-ingress-using-gitlab-ci) -- [cert-manager](#install-cert-manager-using-gitlab-ci) -- [Sentry](#install-sentry-using-gitlab-ci) -- [GitLab Runner](#install-gitlab-runner-using-gitlab-ci) -- [Cilium](#install-cilium-using-gitlab-ci) -- [Vault](#install-vault-using-gitlab-ci) -- [JupyterHub](#install-jupyterhub-using-gitlab-ci) -- [Elastic Stack](#install-elastic-stack-using-gitlab-ci) -- [Crossplane](#install-crossplane-using-gitlab-ci) +- [Ingress](#install-ingress-using-gitlab-cicd) +- [cert-manager](#install-cert-manager-using-gitlab-cicd) +- [Sentry](#install-sentry-using-gitlab-cicd) +- [GitLab Runner](#install-gitlab-runner-using-gitlab-cicd) +- [Cilium](#install-cilium-using-gitlab-cicd) +- [Vault](#install-vault-using-gitlab-cicd) +- [JupyterHub](#install-jupyterhub-using-gitlab-cicd) +- [Elastic Stack](#install-elastic-stack-using-gitlab-cicd) +- [Crossplane](#install-crossplane-using-gitlab-cicd) ### Usage @@ -559,7 +559,7 @@ You can find and import all the files referenced below in the [example cluster applications project](https://gitlab.com/gitlab-org/cluster-integration/example-cluster-applications/). -To install applications using GitLab CI: +To install applications using GitLab CI/CD: 1. Connect the cluster to a [cluster management project](management_project.md). 1. In that project, add a `.gitlab-ci.yml` file with the following content: @@ -582,7 +582,7 @@ To install applications using GitLab CI: 1. Optionally, define `.gitlab/managed-apps/<application>/values.yaml` file to customize values for the installed application. -A GitLab CI pipeline will then run on the `master` branch to install the +A GitLab CI/CD pipeline will then run on the `master` branch to install the applications you have configured. In case of pipeline failure, the output of the [Helm Tiller](https://v2.helm.sh/docs/install/#running-tiller-locally) binary @@ -597,7 +597,7 @@ Note the following: - If you update `.gitlab/managed-apps/<application>/values.yaml` with new values, the application will be redeployed. -### Install Ingress using GitLab CI +### Install Ingress using GitLab CI/CD To install Ingress, define the `.gitlab/managed-apps/config.yaml` file with: @@ -616,9 +616,9 @@ management project. Refer to the [chart](https://github.com/helm/charts/tree/master/stable/nginx-ingress) for the available configuration options. -### Install cert-manager using GitLab CI +### Install cert-manager using GitLab CI/CD -cert-manager is installed using GitLab CI by defining configuration in +cert-manager is installed using GitLab CI/CD by defining configuration in `.gitlab/managed-apps/config.yaml`. cert-manager: @@ -628,7 +628,7 @@ cert-manager: email address to be specified. The email address is used by Let's Encrypt to contact you about expiring certificates and issues related to your account. -The following configuration is required to install cert-manager using GitLab CI: +The following configuration is required to install cert-manager using GitLab CI/CD: ```yaml certManager: @@ -638,7 +638,7 @@ certManager: email: "user@example.com" ``` -The following installs cert-manager using GitLab CI without the default `ClusterIssuer`: +The following installs cert-manager using GitLab CI/CD without the default `ClusterIssuer`: ```yaml certManager: @@ -653,7 +653,7 @@ management project. Refer to the [chart](https://hub.helm.sh/charts/jetstack/cert-manager) for the available configuration options. -### Install Sentry using GitLab CI +### Install Sentry using GitLab CI/CD NOTE: **Note:** The Sentry Helm chart [recommends](https://github.com/helm/charts/blob/f6e5784f265dd459c5a77430185d0302ed372665/stable/sentry/values.yaml#L284-L285) at least 3GB of available RAM for database migrations. @@ -714,12 +714,12 @@ postgresql: postgresqlPassword: example-postgresql-password ``` -### Install GitLab Runner using GitLab CI +### Install GitLab Runner using GitLab CI/CD -GitLab Runner is installed using GitLab CI by defining configuration in +GitLab Runner is installed using GitLab CI/CD by defining configuration in `.gitlab/managed-apps/config.yaml`. -The following configuration is required to install GitLab Runner using GitLab CI: +The following configuration is required to install GitLab Runner using GitLab CI/CD: ```yaml gitlabRunner: @@ -745,7 +745,7 @@ management project. Refer to the [chart](https://gitlab.com/gitlab-org/charts/gitlab-runner) for the available configuration options. -### Install Cilium using GitLab CI +### Install Cilium using GitLab CI/CD > [Introduced](https://gitlab.com/gitlab-org/cluster-integration/cluster-applications/-/merge_requests/22) in GitLab 12.8. @@ -823,14 +823,14 @@ agent: enabled: false ``` -### Install Vault using GitLab CI +### Install Vault using GitLab CI/CD > [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/9982) in GitLab 12.9. [Hashicorp Vault](https://vaultproject.io/) is a secrets management solution which can be used to safely manage and store passwords, credentials, certificates and more. A Vault installation could be leveraged to provide a single secure data store for credentials -used in your applications, GitLab CI jobs, and more. It could also serve as a way of +used in your applications, GitLab CI/CD jobs, and more. It could also serve as a way of providing SSL/TLS certificates to systems and deployments in your infrastructure. Leveraging Vault as a single source for all these credentials allows greater security by having a single source of access, control, and auditability around all your sensitive @@ -912,11 +912,11 @@ kubectl -n gitlab-managed-apps exec -it vault-0 sh This should give you your unseal keys and initial root token. Make sure to note these down and keep these safe as you will need them to unseal the Vault throughout its lifecycle. -### Install JupyterHub using GitLab CI +### Install JupyterHub using GitLab CI/CD > [Introduced](https://gitlab.com/gitlab-org/cluster-integration/cluster-applications/-/merge_requests/40) in GitLab 12.8. -JupyterHub is installed using GitLab CI by defining configuration in +JupyterHub is installed using GitLab CI/CD by defining configuration in `.gitlab/managed-apps/config.yaml` as follows: ```yaml @@ -961,14 +961,14 @@ Refer to the [chart reference](https://zero-to-jupyterhub.readthedocs.io/en/stable/reference.html) for the available configuration options. -### Install Elastic Stack using GitLab CI +### Install Elastic Stack using GitLab CI/CD > [Introduced](https://gitlab.com/gitlab-org/cluster-integration/cluster-applications/-/merge_requests/45) in GitLab 12.8. -Elastic Stack is installed using GitLab CI by defining configuration in +Elastic Stack is installed using GitLab CI/CD by defining configuration in `.gitlab/managed-apps/config.yaml`. -The following configuration is required to install Elastic Stack using GitLab CI: +The following configuration is required to install Elastic Stack using GitLab CI/CD: ```yaml elasticStack: @@ -988,14 +988,14 @@ available configuration options. NOTE: **Note:** In this alpha implementation of installing Elastic Stack through CI, reading the environment logs through Elasticsearch is unsupported. This is supported if [installed via the UI](#elastic-stack). -### Install Crossplane using GitLab CI +### Install Crossplane using GitLab CI/CD > [Introduced](https://gitlab.com/gitlab-org/cluster-integration/cluster-applications/-/merge_requests/68) in GitLab 12.9. -Crossplane is installed using GitLab CI by defining configuration in +Crossplane is installed using GitLab CI/CD by defining configuration in `.gitlab/managed-apps/config.yaml`. -The following configuration is required to install Crossplane using GitLab CI: +The following configuration is required to install Crossplane using GitLab CI/CD: ```yaml Crossplane: |