Commit eee2a659 authored by GitLab Bot's avatar GitLab Bot

Automatic merge of gitlab-org/gitlab-ce master

parents 7972904b d1ea2aba
...@@ -36,13 +36,18 @@ installations will be better served with the default configuration ...@@ -36,13 +36,18 @@ installations will be better served with the default configuration
used by Omnibus and the GitLab source installation guide. used by Omnibus and the GitLab source installation guide.
Starting with GitLab 11.4, Gitaly is able to serve all Git requests without Starting with GitLab 11.4, Gitaly is able to serve all Git requests without
needed a shared NFS mount for Git repository data. requiring a shared NFS mount for Git repository data.
Between 11.4 and 11.8 the exception was the Between 11.4 and 11.8 the exception was the
[Elasticsearch indexer](https://gitlab.com/gitlab-org/gitlab-elasticsearch-indexer). [Elasticsearch indexer](https://gitlab.com/gitlab-org/gitlab-elasticsearch-indexer).
But since 11.8 the indexer uses Gitaly for data access as well. NFS can still But since 11.8 the indexer uses Gitaly for data access as well. NFS can still
be leveraged for redudancy on block level of the Git data. But only has to be leveraged for redudancy on block level of the Git data. But only has to
be mounted on the Gitaly server. be mounted on the Gitaly server.
Starting with GitLab 11.8, it is possible to use ElasticSearch in conjunction with
a Gitaly setup that isn't utilising NFS. In order to use ElasticSearch in this
scenario, the [new repository indexer](../../integration/elasticsearch.md#elasticsearch-repository-indexer-beta)
needs to be enabled in your GitLab configuration.
NOTE: **Note:** While Gitaly can be used as a replacement for NFS, it's not recommended NOTE: **Note:** While Gitaly can be used as a replacement for NFS, it's not recommended
to use EFS as it may impact GitLab's performance. Review the [relevant documentation](../high_availability/nfs.md#avoid-using-awss-elastic-file-system-efs) to use EFS as it may impact GitLab's performance. Review the [relevant documentation](../high_availability/nfs.md#avoid-using-awss-elastic-file-system-efs)
for more details. for more details.
......
...@@ -5,17 +5,17 @@ Troubleshooting ElasticSearch requires: ...@@ -5,17 +5,17 @@ Troubleshooting ElasticSearch requires:
- Knowledge of common terms. - Knowledge of common terms.
- Establishing within which category the problem fits. - Establishing within which category the problem fits.
## Common Terminology ## Common terminology
- **Lucene**: A full-text search library written in Java. - **Lucene**: A full-text search library written in Java.
- **Near Realtime (NRT)**: Refers to the slight latency from the time to index a - **Near Realtime (NRT)**: Refers to the slight latency from the time to index a
document to the time when it becomes searchable. document to the time when it becomes searchable.
- **Cluster**: A collection of one or more nodes that work together to hold all - **Cluster**: A collection of one or more nodes that work together to hold all
the data, providing indexing and search capabilities. the data, providing indexing and search capabilities.
- **Node**: A single server that works as part of a cluster. - **Node**: A single server that works as part of a cluster.
- **Index**: A collection of documents that have somewhat similar characteristics. - **Index**: A collection of documents that have somewhat similar characteristics.
- **Document**: A basic unit of information that can be indexed. - **Document**: A basic unit of information that can be indexed.
- **Shards**: Fully-functional and independent subdivisions of indices. Each shard is actually - **Shards**: Fully-functional and independent subdivisions of indices. Each shard is actually
a Lucene index. a Lucene index.
- **Replicas**: Failover mechanisms that duplicate indices. - **Replicas**: Failover mechanisms that duplicate indices.
...@@ -138,7 +138,7 @@ graph TD; ...@@ -138,7 +138,7 @@ graph TD;
F7(Escalate to<br>GitLab support.) F7(Escalate to<br>GitLab support.)
``` ```
## Troubleshooting Walkthrough ## Troubleshooting walkthrough
Most ElasticSearch troubleshooting can be broken down into 4 categories: Most ElasticSearch troubleshooting can be broken down into 4 categories:
...@@ -150,7 +150,7 @@ Most ElasticSearch troubleshooting can be broken down into 4 categories: ...@@ -150,7 +150,7 @@ Most ElasticSearch troubleshooting can be broken down into 4 categories:
Generally speaking, if it does not fall into those four categories, it is either: Generally speaking, if it does not fall into those four categories, it is either:
- Something GitLab support needs to look into. - Something GitLab support needs to look into.
- Not a true ElasticSearch issue. - Not a true ElasticSearch issue.
Exercise caution. Issues that appear to be ElasticSearch problems can be OS-level issues. Exercise caution. Issues that appear to be ElasticSearch problems can be OS-level issues.
...@@ -186,12 +186,12 @@ Moving past that, it is best to attempt the same search using the [ElasticSearch ...@@ -186,12 +186,12 @@ Moving past that, it is best to attempt the same search using the [ElasticSearch
If the results: If the results:
- Sync up, then there is not a technical "issue" per se. Instead, it might be a problem - Sync up, then there is not a technical "issue" per se. Instead, it might be a problem
with the ElasticSearch filters we are using. This can be complicated, so it is best to with the ElasticSearch filters we are using. This can be complicated, so it is best to
escalate to GitLab support to check these and guide you on the potential on whether or escalate to GitLab support to check these and guide you on the potential on whether or
not a feature request is needed. not a feature request is needed.
- Do not match up, this indicates a problem with the documents generated from the - Do not match up, this indicates a problem with the documents generated from the
project. It is best to re-index that project and proceed with project. It is best to re-index that project and proceed with
[Troubleshooting indexing](#troubleshooting-indexing). [Troubleshooting indexing](#troubleshooting-indexing).
### Troubleshooting indexing ### Troubleshooting indexing
...@@ -200,13 +200,13 @@ Troubleshooting indexing issues can be tricky. It can pretty quickly go to eithe ...@@ -200,13 +200,13 @@ Troubleshooting indexing issues can be tricky. It can pretty quickly go to eithe
support or your ElasticSearch admin. support or your ElasticSearch admin.
The best place to start is to determine if the issue is with creating an empty index. The best place to start is to determine if the issue is with creating an empty index.
If it is, check on the ElasticSearch side to determine if the `gitlab-production` (the If it is, check on the ElasticSearch side to determine if the `gitlab-production` (the
name for the GitLab index) exists. If it exists, manually delete it on the ElasticSearch name for the GitLab index) exists. If it exists, manually delete it on the ElasticSearch
side and attempt to recreate it from the side and attempt to recreate it from the
[`create_empty_index`](../../integration/elasticsearch.md#gitlab-elasticsearch-rake-tasks) [`create_empty_index`](../../integration/elasticsearch.md#gitlab-elasticsearch-rake-tasks)
rake task. rake task.
If you still encounter issues, try creating an index manually on the ElasticSearch If you still encounter issues, try creating an index manually on the ElasticSearch
instance. The details of the index aren't important here, as we want to test if indices instance. The details of the index aren't important here, as we want to test if indices
can be made. If the indices: can be made. If the indices:
...@@ -317,7 +317,7 @@ dig further into these. ...@@ -317,7 +317,7 @@ dig further into these.
Feel free to reach out to GitLab support, but this is likely to be something a skilled Feel free to reach out to GitLab support, but this is likely to be something a skilled
ElasticSearch admin has more experience with. ElasticSearch admin has more experience with.
## Common Issues ## Common issues
All common issues [should be documented](../../integration/elasticsearch.md#troubleshooting). If not, All common issues [should be documented](../../integration/elasticsearch.md#troubleshooting). If not,
feel free to update that page with issues you encounter and solutions. feel free to update that page with issues you encounter and solutions.
......
# 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 applications which can
be added directly to your configured cluster. These applications are be added directly to your configured cluster.
needed for [Review Apps](../../ci/review_apps/index.md) and
[deployments](../../ci/environments.md) when using [Auto DevOps](../../topics/autodevops/index.md). These applications are needed for [Review Apps](../../ci/review_apps/index.md)
and [deployments](../../ci/environments.md) when using [Auto DevOps](../../topics/autodevops/index.md).
You can install them after you You can install them after you
[create a cluster](../project/clusters/index.md#add-new-gke-cluster). [create a cluster](../project/clusters/index.md#adding-and-removing-clusters).
## Installing applications ## Installing applications
...@@ -20,8 +22,10 @@ This namespace: ...@@ -20,8 +22,10 @@ This namespace:
To see a list of available applications to install: To see a list of available applications to install:
1. For a: 1. For a:
- Project-level cluster, navigate to your project's **Operations > Kubernetes**. - [Project-level cluster](../project/clusters/index.md),
- Group-level cluster, navigate to your group's **Kubernetes** page. navigate to your project's **Operations > Kubernetes**.
- [Group-level cluster](../group/clusters/index.md),
navigate to your group's **Kubernetes** page.
Install Helm first as it's used to install other applications. Install Helm first as it's used to install other applications.
...@@ -160,9 +164,9 @@ file. ...@@ -160,9 +164,9 @@ file.
When installing JupyterHub onto your Kubernetes cluster, [JupyterLab's Git extension](https://github.com/jupyterlab/jupyterlab-git) When installing JupyterHub onto your Kubernetes cluster, [JupyterLab's Git extension](https://github.com/jupyterlab/jupyterlab-git)
is automatically provisioned and configured using the authenticated user's: is automatically provisioned and configured using the authenticated user's:
- Name - Name.
- Email - Email.
- Newly created access token - Newly created access token.
JupyterLab's Git extension enables full version control of your notebooks as well as issuance of Git commands within Jupyter. JupyterLab's Git extension enables full version control of your notebooks as well as issuance of Git commands within Jupyter.
Git commands can be issued via the **Git** tab on the left panel or via Jupyter's command line prompt. Git commands can be issued via the **Git** tab on the left panel or via Jupyter's command line prompt.
...@@ -233,8 +237,10 @@ The applications below can be upgraded. ...@@ -233,8 +237,10 @@ The applications below can be upgraded.
To upgrade an application: To upgrade an application:
1. For a: 1. For a:
- Project-level cluster, navigate to your project's **Operations > Kubernetes**. - [Project-level cluster](../project/clusters/index.md),
- Group-level cluster, navigate to your group's **Kubernetes** page. navigate to your project's **Operations > Kubernetes**.
- [Group-level cluster](../group/clusters/index.md),
navigate to your group's **Kubernetes** page.
1. Select your cluster. 1. Select your cluster.
1. If an upgrade is available, the **Upgrade** button is displayed. Click the button to upgrade. 1. If an upgrade is available, the **Upgrade** button is displayed. Click the button to upgrade.
...@@ -263,8 +269,10 @@ The applications below can be uninstalled. ...@@ -263,8 +269,10 @@ The applications below can be uninstalled.
To uninstall an application: To uninstall an application:
1. For a: 1. For a:
- Project-level cluster, navigate to your project's **Operations > Kubernetes**. - [Project-level cluster](../project/clusters/index.md),
- Group-level cluster, navigate to your group's **Kubernetes** page. navigate to your project's **Operations > Kubernetes**.
- [Group-level cluster](../group/clusters/index.md),
navigate to your group's **Kubernetes** page.
1. Select your cluster. 1. Select your cluster.
1. Click the **Uninstall** button for the application. 1. Click the **Uninstall** button for the application.
......
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