diff options
Diffstat (limited to 'doc/user/clusters/applications.md')
| -rw-r--r-- | doc/user/clusters/applications.md | 59 |
1 files changed, 52 insertions, 7 deletions
diff --git a/doc/user/clusters/applications.md b/doc/user/clusters/applications.md index cc7b5dcd5fb..47cbc0d4a1e 100644 --- a/doc/user/clusters/applications.md +++ b/doc/user/clusters/applications.md @@ -553,12 +553,12 @@ To enable Fluentd: 1. Navigate to **{cloud-gear}** **Operations > Kubernetes** and click **Applications**. You will be prompted to enter a host, port and protocol where the WAF logs will be sent to via syslog. -1. Provide the host domain name or URL in **SIEM URL or Host**. +1. Provide the host domain name or URL in **SIEM Hostname**. 1. Provide the host port number in **SIEM Port**. 1. Select a **SIEM Protocol**. 1. Check **Send ModSecurity Logs**. If you do not select this checkbox, the **Install** button is disabled. -1. Click **Install**. +1. Click **Save changes**.  @@ -592,6 +592,7 @@ Supported applications: - [Elastic Stack](#install-elastic-stack-using-gitlab-cicd) - [Crossplane](#install-crossplane-using-gitlab-cicd) - [Fluentd](#install-fluentd-using-gitlab-cicd) +- [Knative](#install-knative-using-gitlab-cicd) ### Usage @@ -652,7 +653,7 @@ ingress: Ingress will then be installed into the `gitlab-managed-apps` namespace of your cluster. -You can customize the installation of Ingress by defining +You can customize the installation of Ingress by defining a `.gitlab/managed-apps/ingress/values.yaml` file in your cluster management project. Refer to the [chart](https://github.com/helm/charts/tree/master/stable/nginx-ingress) @@ -689,7 +690,7 @@ certManager: installed: false ``` -You can customize the installation of cert-manager by defining +You can customize the installation of cert-manager by defining a `.gitlab/managed-apps/cert-manager/values.yaml` file in your cluster management project. Refer to the [chart](https://hub.helm.sh/charts/jetstack/cert-manager) for the @@ -1054,7 +1055,7 @@ In this alpha implementation of installing Elastic Stack through CI, reading the ### Install Crossplane using GitLab CI/CD -> [Introduced](https://gitlab.com/gitlab-org/cluster-integration/cluster-applications/-/merge_requests/68) in GitLab 12.9. +> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/35675) in GitLab 12.9. Crossplane is installed using GitLab CI/CD by defining configuration in `.gitlab/managed-apps/config.yaml`. @@ -1068,13 +1069,15 @@ Crossplane: Crossplane is installed into the `gitlab-managed-apps` namespace of your cluster. -You can check the default [values.yaml](https://github.com/crossplane/crossplane/blob/master/cluster/charts/crossplane/values.yaml.tmpl) we set for this chart. +You can check the default +[values.yaml](https://github.com/crossplane/crossplane/blob/master/cluster/charts/crossplane/values.yaml.tmpl) +we set for this chart. You can customize the installation of Crossplane by defining `.gitlab/managed-apps/crossplane/values.yaml` file in your cluster management project. Refer to the [chart](https://github.com/crossplane/crossplane/tree/master/cluster/charts/crossplane#configuration) for the -available configuration options. Note that this link points to the docs for the current development release, which may differ from the version you have installed. You can check out a specific version in the branch/tag switcher. +available configuration options. Note that this link points to the documentation for the current development release, which may differ from the version you have installed. ### Install Fluentd using GitLab CI/CD @@ -1100,6 +1103,48 @@ The configuration chart link points to the current development release, which may differ from the version you have installed. To ensure compatibility, switch to the specific branch or tag you are using. +### Install Knative using GitLab CI/CD + +To install Knative, define the `.gitlab/managed-apps/config.yaml` file +with: + +```yaml +knative: + installed: true +``` + +You can customize the installation of Knative by defining `.gitlab/managed-apps/knative/values.yaml` +file in your cluster management project. Refer to the [chart](https://gitlab.com/gitlab-org/charts/knative) +for the available configuration options. + +Here is an example configuration for Knative: + +```yaml +domain: 'my.wildcard.A.record.dns' +``` + +If you plan to use GitLab Serverless capabilities, be sure to set an A record wildcard domain on your custom configuration. + +#### Knative Metrics + +GitLab provides [Invocation Metrics](../project/clusters/serverless/index.md#invocation-metrics) for your functions. To collect these metrics, you must have: + +1. Knative and Prometheus managed applications installed on your cluster. +1. Manually applied the custom metrics on your cluster by running the following command: + + ```bash + kubectl apply -f https://gitlab.com/gitlab-org/cluster-integration/cluster-applications/-/raw/02c8231e30ef5b6725e6ba368bc63863ceb3c07d/src/default-data/knative/istio-metrics.yaml + ``` + +#### Uninstall Knative + +To uninstall Knative, you must first manually remove any custom metrics you have added +by running the following command: + +```bash +kubectl delete -f https://gitlab.com/gitlab-org/cluster-integration/cluster-applications/-/raw/02c8231e30ef5b6725e6ba368bc63863ceb3c07d/src/default-data/knative/istio-metrics.yaml +``` + ## Upgrading applications > [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/24789) in GitLab 11.8. |