Atualizado comentários e job deploy

.gitlab-ci.yml

 # Definindo estágios
 
-# Você pode definir estágios de integração contínua. Estes três estágios
-# abaixo são os mais comuns. A ordem em que aparecem define a ordem de
-# execução, de forma que os 'jobs' marcados como estágio 'build' executarão
-# antes dos jobs 'test', que por sua vez executa antes dos jobs 'deploy'.
+# Você pode definir estágios de integração contínua. Os três estágios
+# abaixo são os mais comuns e default no gitlab-ci. A ordem em que aparecem
+# define a ordem de execução, de forma que os 'jobs' marcados como estágio
+# 'build' executarão antes dos jobs 'test', que por sua vez serão executados
+# antes dos jobs do estágio 'deploy'.
 #
 # O estágio seguinte só é executado se todos os jobs do estágio anterior
-# completarem com sucesso.
+# completaram com sucesso.
 #
 stages:
     - build
@@ -14,10 +15,10 @@ stages:
     - deploy
 
 job1:
-    # Aqui aparece a definição sobre de qual estágio o job faz parte. Se
+    # Aqui aparece o nome do estágio que o job faz parte. Se
     # nenhum for especificado, o gitlab assume que o estágio é 'test'.
     # Repare que o valor foi atribuído na mesma linha, mas poderia ser na
-    # linha de baixo, como é feito na maioria dos casos.
+    # linha seguinte, como é feito na maioria dos casos.
     stage: build
     artifacts:
         paths:
@@ -30,22 +31,23 @@ job1:
         - make
 
 job2:
-    # Esse job só será executado se todos os jobs do estágio 'build'
-    # terminarem com sucesso.
+    # Esse job só será executado se todos os jobs do estágio 'build' (job1,
+    # nesse caso) terminarem com sucesso.
     stage: test
     tags:
         - debian
     script:
         - echo "Estágio 'test'"
         - ls build/
-        # Como dito, ainda não é possível passar arquivos de um estágio para
-        # outro, por isso o comando abaixo vai falhar.
         - ./run-test.sh
+    # Estabelece que esse job depende do job1, o que garante que todos os
+    # artefatos arquivados em job1 estarão disponíveis para esse job. Nesse
+    # caso o 'dependencies' não é necessário, pois o gitlab-ci disponibiliza
+    # por padrão os artefatos de todos os estágios anteriores.
     dependencies:
         - job1
 
 job3:
-    # Os jobs marcados como 'deploy' são os últimos a serem executados.
     stage: deploy
     tags:
         - debian
@@ -54,9 +56,9 @@ job3:
         - ls -R
         # Aqui você pode fazer upload de algo para um servidor. Para isso
         # (atualmente) você precisa gerar um par de chaves e colocar a chave
-        # privada em alguma variável que é passada para os scripts
-        # abaixo como variável de ambiente. Defina essa variável em
-        # <projeto>/Settings/Variables. O script deve então salvar essa
-        # variável (chave privada) em um arquivo para poder utilizá-la com
-        # ssh.
-        #- script_que_vai_copiar_para_servidor.sh
+        # privada em alguma variável que é passada como variável de ambiente
+        # para a build. Defina essa variável em <projeto>/Settings/Variables,
+        # depois utilize-a da seguinte maneira para permitir acesso ssh a um
+        # servidor remoto (assumindo variável de nome PRIV_KEY).
+        - eval $(ssh-agent -s)
+        - ssh-add <(echo "$PRIV_KEY")