--- type: howto --- # Digital Ocean and Docker Machine test environment This guide is for quickly testing different versions of GitLab and not recommended for ease of future upgrades or keeping the data you create. ## Initial setup In this guide you'll configure a Digital Ocean droplet and set up Docker locally on either macOS or Linux. ### On macOS #### Install Docker Desktop - ### On Linux #### Install Docker Engine - #### Install Docker Machine - NOTE: **Note:** The rest of the steps are identical for macOS and Linux. ## Create new docker host 1. Login to Digital Ocean. 1. Generate a new API token at . This command will create a new DO droplet called `gitlab-test-env-do` that will act as a docker host. NOTE: **Note:** 4GB is the minimum requirement for a Docker host that will run more than one GitLab instance. - RAM: 4GB - Name: `gitlab-test-env-do` - Driver: `digitalocean` 1. Set the DO token: ```sh export DOTOKEN= ``` 1. Create the machine: ```sh docker-machine create \ --driver digitalocean \ --digitalocean-access-token=$DOTOKEN \ --digitalocean-size "4gb" \ gitlab-test-env-do ``` Resource: . ## Creating GitLab test instance ### Connect your shell to the new machine In this example we'll create a GitLab EE 8.10.8 instance. First connect the docker client to the docker host you created previously. ```sh eval "$(docker-machine env gitlab-test-env-do)" ``` You can add this to your `~/.bash_profile` file to ensure the `docker` client uses the `gitlab-test-env-do` docker host ### Create new GitLab container - HTTP port: `8888` - SSH port: `2222` - Set `gitlab_shell_ssh_port` using `--env GITLAB_OMNIBUS_CONFIG` - Hostname: IP of docker host - Container name: `gitlab-test-8.10` - GitLab version: **EE** `8.10.8-ee.0` #### Set up container settings ```sh export SSH_PORT=2222 export HTTP_PORT=8888 export VERSION=8.10.8-ee.0 export NAME=gitlab-test-8.10 ``` #### Create container ```sh docker run --detach \ --env GITLAB_OMNIBUS_CONFIG="external_url 'http://$(docker-machine ip gitlab-test-env-do):$HTTP_PORT'; gitlab_rails['gitlab_shell_ssh_port'] = $SSH_PORT;" \ --hostname $(docker-machine ip gitlab-test-env-do) \ -p $HTTP_PORT:$HTTP_PORT -p $SSH_PORT:22 \ --name $NAME \ gitlab/gitlab-ee:$VERSION ``` ### Connect to the GitLab container #### Retrieve the docker host IP ```sh docker-machine ip gitlab-test-env-do # example output: 192.168.151.134 ``` Browse to: `http://192.168.151.134:8888/`. #### Execute interactive shell/edit configuration ```sh docker exec -it $NAME /bin/bash ``` ```sh # example commands root@192:/# vi /etc/gitlab/gitlab.rb root@192:/# gitlab-ctl reconfigure ``` ### Resources - . - . - .