|
|
|
@ -1,4 +1,4 @@
|
|
|
|
|
# sameersbn/gitlab:16.10.2
|
|
|
|
|
# sameersbn/gitlab:16.10.3
|
|
|
|
|
|
|
|
|
|
[](https://circleci.com/gh/sameersbn/docker-gitlab/tree/master)
|
|
|
|
|
|
|
|
|
@ -126,7 +126,7 @@ Your docker host needs to have 1GB or more of available RAM to run GitLab. Pleas
|
|
|
|
|
Automated builds of the image are available on [Dockerhub](https://hub.docker.com/r/sameersbn/gitlab) and is the recommended method of installation.
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker pull sameersbn/gitlab:16.10.2
|
|
|
|
|
docker pull sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You can also pull the `latest` tag which is built from the repository *HEAD*
|
|
|
|
@ -195,7 +195,7 @@ docker run --name gitlab -d \
|
|
|
|
|
--env 'GITLAB_SECRETS_SECRET_KEY_BASE=long-and-random-alpha-numeric-string' \
|
|
|
|
|
--env 'GITLAB_SECRETS_OTP_KEY_BASE=long-and-random-alpha-numeric-string' \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
*Please refer to [Available Configuration Parameters](#available-configuration-parameters) to understand `GITLAB_PORT` and other configuration options*
|
|
|
|
@ -230,7 +230,7 @@ Volumes can be mounted in docker by specifying the `-v` option in the docker run
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -d \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Database
|
|
|
|
@ -288,7 +288,7 @@ docker run --name gitlab -d \
|
|
|
|
|
--env 'DB_NAME=gitlabhq_production' \
|
|
|
|
|
--env 'DB_USER=gitlab' --env 'DB_PASS=password' \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
##### Linking to PostgreSQL Container
|
|
|
|
@ -332,7 +332,7 @@ We are now ready to start the GitLab application.
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -d --link gitlab-postgresql:postgresql \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Here the image will also automatically fetch the `DB_NAME`, `DB_USER` and `DB_PASS` variables from the postgresql container as they are specified in the `docker run` command for the postgresql container. This is made possible using the magic of docker links and works with the following images:
|
|
|
|
@ -371,7 +371,7 @@ The image can be configured to use an external redis server. The configuration s
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm \
|
|
|
|
|
--env 'REDIS_HOST=192.168.1.100' --env 'REDIS_PORT=6379' \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Linking to Redis Container
|
|
|
|
@ -398,7 +398,7 @@ We are now ready to start the GitLab application.
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -d --link gitlab-redis:redisio \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Mail
|
|
|
|
@ -411,7 +411,7 @@ If you are using Gmail then all you need to do is:
|
|
|
|
|
docker run --name gitlab -d \
|
|
|
|
|
--env 'SMTP_USER=USER@gmail.com' --env 'SMTP_PASS=PASSWORD' \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Please refer the [Available Configuration Parameters](#available-configuration-parameters) section for the list of SMTP parameters that can be specified.
|
|
|
|
@ -431,7 +431,7 @@ docker run --name gitlab -d \
|
|
|
|
|
--env 'IMAP_USER=USER@gmail.com' --env 'IMAP_PASS=PASSWORD' \
|
|
|
|
|
--env 'GITLAB_INCOMING_EMAIL_ADDRESS=USER+%{key}@gmail.com' \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Please refer the [Available Configuration Parameters](#available-configuration-parameters) section for the list of IMAP parameters that can be specified.
|
|
|
|
@ -515,7 +515,7 @@ docker run --name gitlab -d \
|
|
|
|
|
--env 'GITLAB_SSH_PORT=10022' --env 'GITLAB_PORT=10443' \
|
|
|
|
|
--env 'GITLAB_HTTPS=true' --env 'SSL_SELF_SIGNED=true' \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
In this configuration, any requests made over the plain http protocol will automatically be redirected to use the https protocol. However, this is not optimal when using a load balancer.
|
|
|
|
@ -531,7 +531,7 @@ docker run --name gitlab -d \
|
|
|
|
|
--env 'GITLAB_HTTPS=true' --env 'SSL_SELF_SIGNED=true' \
|
|
|
|
|
--env 'NGINX_HSTS_MAXAGE=2592000' \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
If you want to completely disable HSTS set `NGINX_HSTS_ENABLED` to `false`.
|
|
|
|
@ -554,7 +554,7 @@ docker run --name gitlab -d \
|
|
|
|
|
--env 'GITLAB_SSH_PORT=10022' --env 'GITLAB_PORT=443' \
|
|
|
|
|
--env 'GITLAB_HTTPS=true' --env 'SSL_SELF_SIGNED=true' \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Again, drop the `--env 'SSL_SELF_SIGNED=true'` option if you are using CA certified SSL certificates.
|
|
|
|
@ -602,7 +602,7 @@ Let's assume we want to deploy our application to '/git'. GitLab needs to know t
|
|
|
|
|
docker run --name gitlab -it --rm \
|
|
|
|
|
--env 'GITLAB_RELATIVE_URL_ROOT=/git' \
|
|
|
|
|
--volume /srv/docker/gitlab/gitlab:/home/git/data \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
GitLab will now be accessible at the `/git` path, e.g. `http://www.example.com/git`.
|
|
|
|
@ -784,14 +784,14 @@ Also the container processes seem to be executed as the host's user/group `1000`
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm [options] \
|
|
|
|
|
--env "USERMAP_UID=$(id -u git)" --env "USERMAP_GID=$(id -g git)" \
|
|
|
|
|
sameersbn/gitlab:16.10.2
|
|
|
|
|
sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
When changing this mapping, all files and directories in the mounted data volume `/home/git/data` have to be re-owned by the new ids. This can be achieved automatically using the following command:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -d [OPTIONS] \
|
|
|
|
|
sameersbn/gitlab:16.10.2 app:sanitize
|
|
|
|
|
sameersbn/gitlab:16.10.3 app:sanitize
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Piwik
|
|
|
|
@ -2530,7 +2530,7 @@ Execute the rake task to create a backup.
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm [OPTIONS] \
|
|
|
|
|
sameersbn/gitlab:16.10.2 app:rake gitlab:backup:create
|
|
|
|
|
sameersbn/gitlab:16.10.3 app:rake gitlab:backup:create
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
A backup will be created in the backups folder of the [Data Store](#data-store). You can change the location of the backups using the `GITLAB_BACKUP_DIR` configuration parameter.
|
|
|
|
@ -2565,14 +2565,14 @@ you need to prepare the database:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm [OPTIONS] \
|
|
|
|
|
sameersbn/gitlab:16.10.2 app:rake db:setup
|
|
|
|
|
sameersbn/gitlab:16.10.3 app:rake db:setup
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Execute the rake task to restore a backup. Make sure you run the container in interactive mode `-it`.
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm [OPTIONS] \
|
|
|
|
|
sameersbn/gitlab:16.10.2 app:rake gitlab:backup:restore
|
|
|
|
|
sameersbn/gitlab:16.10.3 app:rake gitlab:backup:restore
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The list of all available backups will be displayed in reverse chronological order. Select the backup you want to restore and continue.
|
|
|
|
@ -2581,7 +2581,7 @@ To avoid user interaction in the restore operation, specify the timestamp, date
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm [OPTIONS] \
|
|
|
|
|
sameersbn/gitlab:16.10.2 app:rake gitlab:backup:restore BACKUP=1515629493_2020_12_06_13.0.6
|
|
|
|
|
sameersbn/gitlab:16.10.3 app:rake gitlab:backup:restore BACKUP=1515629493_2020_12_06_13.0.6
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
When using `docker-compose` you may use the following command to execute the restore.
|
|
|
|
@ -2630,7 +2630,7 @@ The `app:rake` command allows you to run gitlab rake tasks. To run a rake task s
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm [OPTIONS] \
|
|
|
|
|
sameersbn/gitlab:16.10.2 app:rake gitlab:env:info
|
|
|
|
|
sameersbn/gitlab:16.10.3 app:rake gitlab:env:info
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
You can also use `docker exec` to run raketasks on running gitlab instance. For example,
|
|
|
|
@ -2643,7 +2643,7 @@ Similarly, to import bare repositories into GitLab project instance
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm [OPTIONS] \
|
|
|
|
|
sameersbn/gitlab:16.10.2 app:rake gitlab:import:repos
|
|
|
|
|
sameersbn/gitlab:16.10.3 app:rake gitlab:import:repos
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Or
|
|
|
|
@ -2674,7 +2674,7 @@ Copy all the **bare** git repositories to the `repositories/` directory of the [
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -it --rm [OPTIONS] \
|
|
|
|
|
sameersbn/gitlab:16.10.2 app:rake gitlab:import:repos
|
|
|
|
|
sameersbn/gitlab:16.10.3 app:rake gitlab:import:repos
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Watch the logs and your repositories should be available into your new gitlab container.
|
|
|
|
@ -2698,12 +2698,12 @@ To upgrade to newer gitlab releases, simply follow this 4 step upgrade procedure
|
|
|
|
|
|
|
|
|
|
> **Note**
|
|
|
|
|
>
|
|
|
|
|
> Upgrading to `sameersbn/gitlab:16.10.2` from `sameersbn/gitlab:7.x.x` can cause issues. It is therefore required that you first upgrade to `sameersbn/gitlab:8.0.5-1` before upgrading to `sameersbn/gitlab:8.1.0` or higher.
|
|
|
|
|
> Upgrading to `sameersbn/gitlab:16.10.3` from `sameersbn/gitlab:7.x.x` can cause issues. It is therefore required that you first upgrade to `sameersbn/gitlab:8.0.5-1` before upgrading to `sameersbn/gitlab:8.1.0` or higher.
|
|
|
|
|
|
|
|
|
|
- **Step 1**: Update the docker image.
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker pull sameersbn/gitlab:16.10.2
|
|
|
|
|
docker pull sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
- **Step 2**: Stop and remove the currently running image
|
|
|
|
@ -2728,7 +2728,7 @@ Replace `x.x.x` with the version you are upgrading from. For example, if you are
|
|
|
|
|
> **Note**: Since GitLab `8.11.0` you need to provide the `GITLAB_SECRETS_SECRET_KEY_BASE` and `GITLAB_SECRETS_OTP_KEY_BASE` parameters while starting the image. These should initially both have the same value as the contents of the `/home/git/data/.secret` file. See [Available Configuration Parameters](#available-configuration-parameters) for more information on these parameters.
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker run --name gitlab -d [OPTIONS] sameersbn/gitlab:16.10.2
|
|
|
|
|
docker run --name gitlab -d [OPTIONS] sameersbn/gitlab:16.10.3
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Shell Access
|
|
|
|
@ -2766,7 +2766,7 @@ version: '2.3'
|
|
|
|
|
|
|
|
|
|
services:
|
|
|
|
|
gitlab:
|
|
|
|
|
image: sameersbn/gitlab:16.10.2
|
|
|
|
|
image: sameersbn/gitlab:16.10.3
|
|
|
|
|
healthcheck:
|
|
|
|
|
test: ["CMD", "/usr/local/sbin/healthcheck"]
|
|
|
|
|
interval: 1m
|
|
|
|
|