diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2020-09-19 01:45:44 +0000 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2020-09-19 01:45:44 +0000 |
commit | 85dc423f7090da0a52c73eb66faf22ddb20efff9 (patch) | |
tree | 9160f299afd8c80c038f08e1545be119f5e3f1e1 /doc/install | |
parent | 15c2c8c66dbe422588e5411eee7e68f1fa440bb8 (diff) | |
download | gitlab-ce-85dc423f7090da0a52c73eb66faf22ddb20efff9.tar.gz |
Add latest changes from gitlab-org/gitlab@13-4-stable-ee
Diffstat (limited to 'doc/install')
-rw-r--r-- | doc/install/aws/index.md | 54 | ||||
-rw-r--r-- | doc/install/azure/index.md | 20 | ||||
-rw-r--r-- | doc/install/docker.md | 14 | ||||
-rw-r--r-- | doc/install/installation.md | 25 | ||||
-rw-r--r-- | doc/install/postgresql_extensions.md | 4 | ||||
-rw-r--r-- | doc/install/requirements.md | 22 |
6 files changed, 73 insertions, 66 deletions
diff --git a/doc/install/aws/index.md b/doc/install/aws/index.md index 92a4ce860c3..aba76ecf50e 100644 --- a/doc/install/aws/index.md +++ b/doc/install/aws/index.md @@ -68,28 +68,32 @@ As we'll be using [Amazon S3 object storage](#amazon-s3-object-storage), our EC2 1. Click **Create policy**, select the `JSON` tab, and add a policy. We want to [follow security best practices and grant _least privilege_](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege), giving our role only the permissions needed to perform the required actions. 1. Assuming you prefix the S3 bucket names with `gl-` as shown in the diagram, add the following policy: -```json -{ - "Version": "2012-10-17", - "Statement": [ - { - "Effect": "Allow", - "Action": [ - "s3:AbortMultipartUpload", - "s3:CompleteMultipartUpload", - "s3:ListBucket", - "s3:PutObject", - "s3:GetObject", - "s3:DeleteObject", - "s3:PutObjectAcl" - ], - "Resource": [ - "arn:aws:s3:::gl-*/*" - ] - } - ] -} -``` + ```json + { "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "s3:PutObject", + "s3:GetObject", + "s3:DeleteObject", + "s3:PutObjectAcl" + ], + "Resource": "arn:aws:s3:::gl-*/*" + }, + { + "Effect": "Allow", + "Action": [ + "s3:ListBucket", + "s3:AbortMultipartUpload", + "s3:ListMultipartUploadParts", + "s3:ListBucketMultipartUploads" + ], + "Resource": "arn:aws:s3:::gl-*" + } + ] + } + ``` 1. Click **Review policy**, give your policy a name (we'll use `gl-s3-policy`), and click **Create policy**. @@ -714,10 +718,10 @@ For more information on how to set it up, visit the GitLab also has various [health check endpoints](../../user/admin_area/monitoring/health_check.md) that you can ping and get reports. -## GitLab Runners +## GitLab Runner If you want to take advantage of [GitLab CI/CD](../../ci/README.md), you have to -set up at least one [GitLab Runner](https://docs.gitlab.com/runner/). +set up at least one [runner](https://docs.gitlab.com/runner/). Read more on configuring an [autoscaling GitLab Runner on AWS](https://docs.gitlab.com/runner/configuration/runner_autoscale_aws/). @@ -795,7 +799,7 @@ to request additional material: - [Scaling GitLab](../../administration/reference_architectures/index.md): GitLab supports several different types of clustering. -- [Geo replication](../../administration/geo/replication/index.md): +- [Geo replication](../../administration/geo/index.md): Geo is the solution for widely distributed development teams. - [Omnibus GitLab](https://docs.gitlab.com/omnibus/) - Everything you need to know about administering your GitLab instance. diff --git a/doc/install/azure/index.md b/doc/install/azure/index.md index 548c7d8c92e..b6e3025a0e0 100644 --- a/doc/install/azure/index.md +++ b/doc/install/azure/index.md @@ -1,15 +1,23 @@ --- +stage: Enablement +group: Distribution +info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers description: 'Learn how to spin up a pre-configured GitLab VM on Microsoft Azure.' type: howto --- # Install GitLab on Microsoft Azure -Azure is Microsoft's business cloud and GitLab is a pre-configured offering on the Azure Marketplace. -Hopefully, you aren't surprised to hear that Microsoft and Azure have embraced open source software -like Ubuntu, Red Hat Enterprise Linux, and of course - GitLab! This means that you can spin up a -pre-configured GitLab VM and have your very own private GitLab up and running in around 30 minutes. -Let's get started. +CAUTION: **Deprecated:** +The GitLab image in the Azure Marketplace is deprecated. You can track GitLab's +efforts to [post a new image](https://gitlab.com/gitlab-com/alliances/microsoft/gitlab-tracker/-/issues/2). + +Azure is Microsoft's business cloud and GitLab is a pre-configured offering on +the Azure Marketplace. Hopefully, you aren't surprised to hear that Microsoft +and Azure have embraced open source software like Ubuntu, Red Hat Enterprise Linux, +and of course - GitLab! This means that you can spin up a pre-configured +GitLab VM and have your very own private GitLab up and running in around 30 +minutes. Let's get started. ## Getting started @@ -419,7 +427,7 @@ Check out our other [Technical Articles](../../articles/index.md) or browse the ### Useful links - [GitLab Community Edition](https://about.gitlab.com/features/) -- [GitLab Enterprise Edition](https://about.gitlab.com/features/#ee-starter) +- [GitLab Enterprise Edition](https://about.gitlab.com/features/#ee) - [Microsoft Azure](https://azure.microsoft.com/en-us/) - [Azure - Free Account FAQ](https://azure.microsoft.com/en-us/free/free-account-faq/) - [Azure - Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/) diff --git a/doc/install/docker.md b/doc/install/docker.md index e0cef71a4d8..c2d7655d526 100644 --- a/doc/install/docker.md +++ b/doc/install/docker.md @@ -6,18 +6,10 @@ type: index [Docker](https://www.docker.com) and container technology have been revolutionizing the software world for the past few years. They combine the performance and efficiency of native execution with the abstraction, security, and immutability of virtualization. -GitLab provides official Docker images allowing you to easily take advantage of the benefits of containerization while operating your GitLab instance. +GitLab provides official Docker images allowing you to easily take advantage of the benefits of containerization while operating your GitLab instance. A [complete usage guide](https://docs.gitlab.com/omnibus/docker/) for these images is available, as well as the [Dockerfile used for building the images](https://gitlab.com/gitlab-org/omnibus-gitlab/tree/master/docker). -## Omnibus GitLab based images - -GitLab maintains a set of [official Docker images](https://hub.docker.com/u/gitlab) based on our [Omnibus GitLab package](https://docs.gitlab.com/omnibus/README.html). These images include: - -- [GitLab Community Edition](https://hub.docker.com/r/gitlab/gitlab-ce/) -- [GitLab Enterprise Edition](https://hub.docker.com/r/gitlab/gitlab-ee/) -- [GitLab Runner](https://hub.docker.com/r/gitlab/gitlab-runner/) - -A [complete usage guide](https://docs.gitlab.com/omnibus/docker/) to these images is available, as well as the [Dockerfile used for building the images](https://gitlab.com/gitlab-org/omnibus-gitlab/tree/master/docker). +There's also a [Docker image for GitLab Runner](https://docs.gitlab.com/runner/install/docker.html). ## Cloud native images -GitLab is also working towards a [cloud native set of containers](https://docs.gitlab.com/charts/), with a single image for each component service. We intend for these images to eventually replace the [Omnibus GitLab based images](#omnibus-gitlab-based-images). +GitLab is also working towards a [cloud native set of containers](https://docs.gitlab.com/charts/), with a single image for each component service. diff --git a/doc/install/installation.md b/doc/install/installation.md index 7216f750624..e2c77073983 100644 --- a/doc/install/installation.md +++ b/doc/install/installation.md @@ -147,8 +147,7 @@ ldd $(command -v git) | grep pcre2 The output should contain `libpcre2-8.so.0`. -Is the system packaged Git too old, or not compiled with pcre2? -Remove it: +If the system packaged Git is too old or not compiled with `pcre2`, remove it: ```shell sudo apt-get remove git-core @@ -312,13 +311,20 @@ sudo adduser --disabled-login --gecos 'GitLab' git ## 6. Database NOTE: **Note:** -Starting from GitLab 12.1, only PostgreSQL is supported. Since GitLab 13.0, we require PostgreSQL 11+. +Starting from GitLab 12.1, only PostgreSQL is supported. Since GitLab 13.0, we [require PostgreSQL 11+](requirements.md#postgresql-requirements). 1. Install the database packages: ```shell sudo apt-get install -y postgresql postgresql-client libpq-dev postgresql-contrib ``` + +1. Verify the PostgreSQL version you have is supported by the version of GitLab you're + installing: + + ```shell + psql --version + ``` 1. Start the PostgreSQL service and confirm that the service is running: @@ -401,10 +407,11 @@ Starting from GitLab 12.1, only PostgreSQL is supported. Since GitLab 13.0, we r ## 7. Redis -GitLab requires at least Redis 5.0. +NOTE: **Note:** +See the [requirements page](requirements.md#redis-versions) for the minimum +Redis requirements. -If you are using Debian 10 or Ubuntu 20.04 and up, you can install -Redis 5.0 with: +Install Redis with: ```shell sudo apt-get install redis-server @@ -686,7 +693,7 @@ Next, make sure that Gitaly is configured: sudo chmod 0700 /home/git/gitlab/tmp/sockets/private sudo chown git /home/git/gitlab/tmp/sockets/private -# If you are using non-default settings you need to update config.toml +# If you are using non-default settings, you need to update config.toml cd /home/git/gitaly sudo -u git -H editor config.toml ``` @@ -740,7 +747,7 @@ Download the init script (is `/etc/init.d/gitlab`): sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab ``` -And if you are installing with a non-default folder or user copy and edit the defaults file: +And if you are installing with a non-default folder or user, copy and edit the defaults file: ```shell sudo cp lib/support/init.d/gitlab.default.example /etc/default/gitlab @@ -937,7 +944,7 @@ See the [OmniAuth integration documentation](../integration/omniauth.md). ### Build your projects -GitLab can build your projects. To enable that feature, you need GitLab Runners to do that for you. +GitLab can build your projects. To enable that feature, you need runners to do that for you. See the [GitLab Runner section](https://about.gitlab.com/stages-devops-lifecycle/continuous-integration/#gitlab-runner) to install it. ### Adding your Trusted Proxies diff --git a/doc/install/postgresql_extensions.md b/doc/install/postgresql_extensions.md index 4156d72097d..9e5a1e3d627 100644 --- a/doc/install/postgresql_extensions.md +++ b/doc/install/postgresql_extensions.md @@ -1,7 +1,3 @@ ---- -last_updated: 2020-09-01 ---- - # Managing PostgreSQL extensions This guide documents how to manage PostgreSQL extensions for installations with an external diff --git a/doc/install/requirements.md b/doc/install/requirements.md index 10d5853c82e..da0128fecc3 100644 --- a/doc/install/requirements.md +++ b/doc/install/requirements.md @@ -12,7 +12,7 @@ as the hardware requirements that are needed to install and use GitLab. ### Supported Linux distributions - Ubuntu (16.04/18.04/20.04) -- Debian (8/9/10) +- Debian (9/10) - CentOS (6/7/8) - openSUSE (Leap 15.1/Enterprise Server 12.2) - Red Hat Enterprise Linux (please use the CentOS packages and instructions) @@ -61,8 +61,8 @@ From GitLab 13.1: ### Node.js versions -Beginning in GitLab 12.9, we only support node.js 10.13.0 or higher, and we have dropped -support for node.js 8. (node.js 6 support was dropped in GitLab 11.8) +Beginning in GitLab 12.9, we only support Node.js 10.13.0 or higher, and we have dropped +support for Node.js 8. (Node.js 6 support was dropped in GitLab 11.8) We recommend Node 12.x, as it's faster. @@ -74,9 +74,12 @@ a version older than `v10.13.0`, you need to update it to a newer version. You can find instructions to install from community maintained packages or compile from source at the [Node.js website](https://nodejs.org/en/download/). -## Redis versions +### Redis versions -GitLab requires Redis 5.0+. Beginning in GitLab 13.0, lower versions are not supported. +GitLab 13.0 and later requires Redis version 4.0 or higher. + +Redis version 5.0 or higher is recommended, as this is what ships with +[Omnibus GitLab](https://docs.gitlab.com/omnibus/) packages starting with GitLab 12.7. ## Hardware requirements @@ -137,7 +140,6 @@ We highly recommend users to use the minimum PostgreSQL versions specified below GitLab version | Minimum PostgreSQL version -|- 10.0 | 9.6 -12.10 | 11 13.0 | 11 You must also ensure the `pg_trgm` and `btree_gist` extensions are [loaded into every @@ -148,7 +150,7 @@ Support for [PostgreSQL 9.6 and 10 has been removed in GitLab 13.0](https://abou #### Additional requirements for GitLab Geo -If you're using [GitLab Geo](../administration/geo/replication/index.md): +If you're using [GitLab Geo](../administration/geo/index.md): - We strongly recommend running Omnibus-managed instances as they are actively developed and tested. We aim to be compatible with most external (not managed @@ -180,7 +182,7 @@ optimal settings for your infrastructure. ### Puma threads The recommended number of threads is dependent on several factors, including total memory, and use -of [legacy Rugged code](../development/gitaly.md#legacy-rugged-code). +of [legacy Rugged code](../administration/gitaly/index.md#direct-access-to-git-in-gitlab). - If the operating system has a maximum 2 GB of memory, the recommended number of threads is `1`. A higher value will result in excess swapping, and decrease performance. @@ -257,8 +259,6 @@ For reference, GitLab.com's [auto-scaling shared runner](../user/gitlab_com/inde CAUTION: **Caution:** With GitLab 13.0 (May 2020) we have removed official support for Internet Explorer 11. -With the release of GitLab 13.4 (September 2020) we will remove all code that supports Internet Explorer 11. -You can provide feedback [on this issue](https://gitlab.com/gitlab-org/gitlab/-/issues/197987) or via your usual support channels. GitLab supports the following web browsers: @@ -270,7 +270,7 @@ GitLab supports the following web browsers: For the listed web browsers, GitLab supports: -- The current and previous major versions of browsers except Internet Explorer. +- The current and previous major versions of browsers. - The current minor version of a supported major version. NOTE: **Note:** |