Commit eb1f374b authored by Amy Qualls (slowly returning after surgery)'s avatar Amy Qualls (slowly returning after surgery) Committed by Craig Norris

Begin revising applications page for tone/style

Start revising the applications page to fix some glaring tone and
style issues, and removing some of the (many) note boxes.
parent 0709379d
...@@ -6,37 +6,29 @@ info: To determine the technical writer assigned to the Stage/Group associated w ...@@ -6,37 +6,29 @@ info: To determine the technical writer assigned to the Stage/Group associated w
# GitLab Managed Apps # GitLab Managed Apps
GitLab provides **GitLab Managed Apps**, a one-click install for various applications which can GitLab provides **GitLab Managed Apps**, a one-click install for various
be added directly to your configured cluster. applications which can be added directly to your configured cluster. These
applications are needed for [Review Apps](../../ci/review_apps/index.md) and
These applications are needed for [Review Apps](../../ci/review_apps/index.md) [deployments](../../ci/environments/index.md) when using [Auto DevOps](../../topics/autodevops/index.md).
and [deployments](../../ci/environments/index.md) when using [Auto DevOps](../../topics/autodevops/index.md). You can install them after you [create a cluster](../project/clusters/add_remove_clusters.md).
You can install them after you
[create a cluster](../project/clusters/add_remove_clusters.md).
## Installing applications ## Installing applications
Applications managed by GitLab will be installed onto the `gitlab-managed-apps` namespace. Applications managed by GitLab are installed onto the `gitlab-managed-apps`
namespace. This namespace:
This namespace:
- Is different from the namespace used for project deployments. - Is different from the namespace used for project deployments.
- Is created once. - Is created once.
- Has a non-configurable name. - Has a non-configurable name.
To see a list of available applications to install. For a: To view a list of available applications to install for a:
- [Project-level cluster](../project/clusters/index.md), navigate to your project's - [Project-level cluster](../project/clusters/index.md), navigate to your project's
**Operations > Kubernetes**. **Operations > Kubernetes**.
- [Group-level cluster](../group/clusters/index.md), navigate to your group's - [Group-level cluster](../group/clusters/index.md), navigate to your group's
**Kubernetes** page. **Kubernetes** page.
NOTE: **Note:** You can install the following applications:
As of GitLab 11.6, Helm will be upgraded to the latest version supported
by GitLab before installing any of the applications.
The following applications can be installed:
- [Helm](#helm) - [Helm](#helm)
- [Ingress](#ingress) - [Ingress](#ingress)
...@@ -49,10 +41,9 @@ The following applications can be installed: ...@@ -49,10 +41,9 @@ The following applications can be installed:
- [Elastic Stack](#elastic-stack) - [Elastic Stack](#elastic-stack)
- [Fluentd](#fluentd) - [Fluentd](#fluentd)
With the exception of Knative, the applications will be installed in a dedicated With the exception of Knative, the applications are installed in a dedicated
namespace called `gitlab-managed-apps`. namespace called `gitlab-managed-apps`.
NOTE: **Note:**
Some applications are installable only for a project-level cluster. Some applications are installable only for a project-level cluster.
Support for installing these applications in a group-level cluster is Support for installing these applications in a group-level cluster is
planned for future releases. planned for future releases.
...@@ -65,6 +56,9 @@ you should be careful as GitLab cannot detect it. In this case, installing ...@@ -65,6 +56,9 @@ you should be careful as GitLab cannot detect it. In this case, installing
Helm via the applications will result in the cluster having it twice, which Helm via the applications will result in the cluster having it twice, which
can lead to confusion during deployments. can lead to confusion during deployments.
In GitLab versions 11.6 and greater, Helm is upgraded to the latest version
supported by GitLab before installing any of the applications.
### Helm ### Helm
> - Introduced in GitLab 10.2 for project-level clusters. > - Introduced in GitLab 10.2 for project-level clusters.
...@@ -81,7 +75,6 @@ applications. Prior to [GitLab 13.2](https://gitlab.com/gitlab-org/gitlab/-/issu ...@@ -81,7 +75,6 @@ applications. Prior to [GitLab 13.2](https://gitlab.com/gitlab-org/gitlab/-/issu
GitLab used an in-cluster Tiller server in the `gitlab-managed-apps` GitLab used an in-cluster Tiller server in the `gitlab-managed-apps`
namespace. This server can now be safely removed. namespace. This server can now be safely removed.
NOTE: **Note:**
GitLab's Helm integration does not support installing applications behind a proxy, GitLab's Helm integration does not support installing applications behind a proxy,
but a [workaround](../../topics/autodevops/index.md#install-applications-behind-a-proxy) but a [workaround](../../topics/autodevops/index.md#install-applications-behind-a-proxy)
is available. is available.
...@@ -90,26 +83,25 @@ is available. ...@@ -90,26 +83,25 @@ is available.
> Introduced in GitLab 11.6 for project- and group-level clusters. > Introduced in GitLab 11.6 for project- and group-level clusters.
[cert-manager](https://cert-manager.io/docs/) is a native [cert-manager](https://cert-manager.io/docs/) is a native Kubernetes certificate
Kubernetes certificate management controller that helps with issuing management controller that helps with issuing certificates. Installing
certificates. Installing cert-manager on your cluster will issue a cert-manager on your cluster issues a certificate by [Let's Encrypt](https://letsencrypt.org/)
certificate by [Let's Encrypt](https://letsencrypt.org/) and ensure that and ensures that certificates are valid and up-to-date.
certificates are valid and up-to-date.
The chart used to install this application depends on the version of GitLab used. In: The chart used to install this application depends on the version of GitLab used. In:
- GitLab 12.3 and newer, the [jetstack/cert-manager](https://github.com/jetstack/cert-manager) - GitLab 12.3 and newer, the [`jetstack/cert-manager`](https://github.com/jetstack/cert-manager)
chart is used with a [`values.yaml`](https://gitlab.com/gitlab-org/gitlab/blob/master/vendor/cert_manager/values.yaml) chart is used with a [`values.yaml`](https://gitlab.com/gitlab-org/gitlab/blob/master/vendor/cert_manager/values.yaml)
file. file.
- GitLab 12.2 and older, the [stable/cert-manager](https://github.com/helm/charts/tree/master/stable/cert-manager) - GitLab 12.2 and older, the [`stable/cert-manager`](https://gi2wthub.com/helm/charts/tree/master/stable/cert-manager)
chart was used. chart was used.
If you have installed cert-manager prior to GitLab 12.3, Let's Encrypt will If you installed cert-manager prior to GitLab 12.3, Let's Encrypt
[block requests from older versions of cert-manager](https://community.letsencrypt.org/t/blocking-old-cert-manager-versions/98753). [blocks requests](https://community.letsencrypt.org/t/blocking-old-cert-manager-versions/98753)
from older versions of `cert-manager`. To resolve this:
To resolve this:
1. Uninstall cert-manager (consider [backing up any additional configuration](https://cert-manager.io/docs/tutorials/backup/)). 1. [Back up any additional configuration](https://cert-manager.io/docs/tutorials/backup/).
1. Uninstall cert-manager.
1. Install cert-manager again. 1. Install cert-manager again.
### GitLab Runner ### GitLab Runner
...@@ -117,26 +109,21 @@ To resolve this: ...@@ -117,26 +109,21 @@ To resolve this:
> - Introduced in GitLab 10.6 for project-level clusters. > - Introduced in GitLab 10.6 for project-level clusters.
> - Introduced in GitLab 11.10 for group-level clusters. > - Introduced in GitLab 11.10 for group-level clusters.
[GitLab Runner](https://docs.gitlab.com/runner/) is the open source [GitLab Runner](https://docs.gitlab.com/runner/) is the open source project that
project that is used to run your jobs and send the results back to is used to run your jobs and send the results back to GitLab. It's used in
GitLab. It is used in conjunction with [GitLab conjunction with [GitLab CI/CD](../../ci/README.md), the open-source continuous
CI/CD](../../ci/README.md), the open-source continuous integration integration service included with GitLab that coordinates the jobs.
service included with GitLab that coordinates the jobs.
If the project is on GitLab.com, [shared runners](../gitlab_com/index.md#shared-runners)
If the project is on GitLab.com, shared runners are available are available, and you do not have to deploy one if they are enough for your
(the first 2000 minutes are free, you can needs. If a project-specific runner is desired, or there are no shared runners,
[buy more later](../../subscriptions/gitlab_com/index.md#purchase-additional-ci-minutes)) you can deploy one.
and you do not have to deploy one if they are enough for your needs. If a
project-specific runner is desired, or there are no shared runners, it is easy The deployed runner is set as **privileged**. Root access to the underlying
to deploy one. server is required to build Docker images, so it is the default. Be sure to read
the [security implications](../project/clusters/index.md#security-implications)
Note that the deployed runner will be set as **privileged**, which means it will essentially
have root access to the underlying machine. This is required to build Docker images,
so it is the default. Make sure you read the
[security implications](../project/clusters/index.md#security-implications)
before deploying one. before deploying one.
NOTE: **Note:**
The [`runner/gitlab-runner`](https://gitlab.com/gitlab-org/charts/gitlab-runner) The [`runner/gitlab-runner`](https://gitlab.com/gitlab-org/charts/gitlab-runner)
chart is used to install this application, using chart is used to install this application, using
[a preconfigured `values.yaml`](https://gitlab.com/gitlab-org/charts/gitlab-runner/-/blob/master/values.yaml) [a preconfigured `values.yaml`](https://gitlab.com/gitlab-org/charts/gitlab-runner/-/blob/master/values.yaml)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment