Visualizza wikitesto di LinuxDay 2016 GitLab Workshop


First of all you need to install docker, we'll use Ubuntu 16.04 as base system, and you 
can just follow some simple instruction provided by 
[https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-16-04 digital ocean]

For sake of completeness we provide the instruction here:

<pre>
sudo apt-get update
sudo apt-get upgrade
sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
echo "deb https://apt.dockerproject.org/repo ubuntu-xenial main" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt-get update
sudo apt-get install -y docker-engine
sudo systemctl status docker
sudo usermod -aG docker $(whoami)
</pre>

Now logout and login back again to apply the new group policy to your user.

The easier way to that everything went fine, is to run the sample hello-world container:

<pre>
docker run hello-world
</pre>

Now that docker is ready to go, we can start with GitLab. The official instruction 
can be found [https://docs.gitlab.com/omnibus/docker/ here]

In one single command line:

<pre>
docker run --detach \
    --hostname gitlab \
    --publish 443:443 --publish 80:80 --publish 22:22 \
    --name gitlab \
    --restart always \
    --volume /srv/gitlab/config:/etc/gitlab \
    --volume /srv/gitlab/logs:/var/log/gitlab \
    --volume /srv/gitlab/data:/var/opt/gitlab \
    gitlab/gitlab-ce:latest
</pre>

Please note that we choose just <code>gitlab</code> as hostname. This will ease
container connection later.

Play around with GitLab by opening your browser to http://localhost : the first time 
you connect the system will ask you to configure a password for the <code>root</code>
user.

---------------

Now we want to setup GitLab CI which is a bit ''harder''

The official docs can be found here:
* https://gitlab.com/gitlab-org/gitlab-ci-multi-runner/blob/master/docs/install/docker.md
* https://gitlab.com/gitlab-org/gitlab-ci-multi-runner/blob/master/docs/configuration/advanced-configuration.md

First of all we need to create a runner. A GitLab runner is the ''worker'' which will be called by GitLab CI to ''execute'' the CI commands.

<pre>
docker run -d --name gitlab-runner --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /srv/gitlab-runner/config:/etc/gitlab-runner \
  --link gitlab \
  gitlab/gitlab-runner:latest
</pre>

Please note that we connect this with the previously create GitLab instance with <code>--link</code> parameter, which, in simple words, allow
the gitlab-runner container to resolve <code>gitlab</code> hostname in the IP address of the container.

We also provision the docker socket because later docker will be used to execute the CI script.

Now is time to connect the two: in GitLab go into the admin area, and click on Overview -> Runners. Copy the '''registration token'''
into the clipboard, you'll use it in a minute!

At shell prompt, run the follwing command, which will execute the gitlab-runner registration wizard:

<pre>
docker exec -it gitlab-runner gitlab-runner register
</pre>

Enter the follwing parameters:
* http://localhost
* paste the token
* description: docker-runner
* executor: docker
* default docker image ruby:2.1

The ''executor'' is the way gitlab-runner will ''execute'' the GitLab CI script. Choosing ''docker'' will execute the CI script inside a container (which will be configured by the CI script itself). A simpler setup is the ''shell'' executor which will be execute the CI script locally in the docker-runner container.

However, due the fact that we don't have a real DNS setup, we need to configure gitlab runner to ''link'' the container it creates as executor to the 
GitLab container.

Connect to the runner container and open a shell in it:

<pre>
docker exec -it gitlab-runner bash
</pre>

Open with your favorit editor <code>/etc/gitlab-runner/config.toml</code>

In the <code>[runners.docker]</code> section:

<pre>
	links = [ "gitlab" ]
</pre>

Easy to guess, this will just add <code>--link gitlab</code> to the docker command line of the executor.

Everything is now ready for you first CI project!

Create a project, e.g. helloworld, with the following <code>helloworld.sh</code>

<pre>
#!/bin/bash
echo hello GitLab CI world
exit 0
</pre>

Now create a <code>.gitlab-ci.yml</code>:

<pre>
image: busybox

job:
    script:
        - chmod +x helloworld.sh
        - ./helloworld.sh
</pre>

Here it is:
* this will instruct the runner to use the ''busybox'' docker image as executor
* once the container starts, it will clone our project (this is where the <code>--link</code> will come into)
* and it finally run the <code>script</code> for the CI

Make it fail!

The above CI will be successfull because all the commands return a zero exit code. Is preatty easy to break the CI: just edit
the code, directly from GitLab web interface if you want, to <code>exit 1</code>, commit and.. you break the build!

Fixin it is left as an excercise to the reader.


----


Code Review Steps (s: senior, j: junior):
* s: helloworld, con exit 0
* s: .gitlab-ci.yml
* s: creare issue con modifica
* assegnare a junior
* j: new branch
* j: modifica readme + [ci skip]
* j: modifica exit 1 + this closes #1
* j: CI break build
* j: submit merge request + assign to s:
* s: code review
* j: fix issue with new branch
* auto-close issue with merge