.gitlab-ci.yml

 image: quantumtinkerer/research
 
-build and upload the contents:
+stages:
+  - build
+  - deploy
+
+build lectures:
+  stage: build
+  before_script:
+    - pip install -U mkdocs mkdocs-material python-markdown-math notedown
+  script:
+    - python execute.py
+    - mkdocs build
+  artifacts:
+    paths:
+      - site
+    expire_in: 1 week
+
+.prepare_deploy: &prepare_deploy
+  stage: deploy
+  only:
+    - branches@solidstate/lectures
   before_script:
     ## Install ssh-agent if not already installed, it is required by Docker.
     ## (change apt-get to yum if you use an RPM-based image)
@@ -20,12 +39,49 @@ build and upload the contents:
     - chmod 700 ~/.ssh
     - ssh-keyscan tnw-tn1.tudelft.net >> ~/.ssh/known_hosts
     - chmod 644 ~/.ssh/known_hosts
-    - pip install -U mkdocs mkdocs-material python-markdown-math notedown
-
   script:
-    # Compile lectures
-    - python execute.py
-    - mkdocs build
-    - "rsync -rv site/* solidstate@tnw-tn1.tudelft.net:"
+    - "rsync -rv site/* solidstate@tnw-tn1.tudelft.net:$DEPLOY_PATH"
+
+deploy delft version:
+  <<: *prepare_deploy
   only:
     - local@solidstate/lectures
+  variables:
+    DEPLOY_PATH: ""
+  environment:
+    name: $CI_COMMIT_REF_NAME
+    url: "https://solidstate.quantumtinkerer.tudelft.nl/"
+
+deploy test version:
+  <<: *prepare_deploy
+  except:
+    - local@solidstate/lectures
+  variables:
+    DEPLOY_PATH: "test_builds/$CI_COMMIT_REF_NAME"
+  environment:
+    name: $CI_COMMIT_REF_NAME
+    url: "https://solidstate.quantumtinkerer.tudelft.nl/test_builds/$CI_COMMIT_REF_NAME"
+    on_stop: undeploy test version
+
+undeploy test version:
+  <<: *prepare_deploy
+  except:
+    - local@solidstate/lectures
+  when: manual
+  variables:
+    DEPLOY_PATH: "test_builds/$CI_COMMIT_REF_NAME"
+  script:
+    - mkdir empty/
+    - "rsync -rlv --delete empty/ solidstate@tnw-tn1.tudelft.net:$DEPLOY_PATH"
+  environment:
+    name: $CI_COMMIT_REF_NAME
+    action: stop
+
+merge into local:
+  stage: deploy
+  only:
+    - master@solidstate/lectures
+  script:
+    - git checkout local
+    - git diff-index --quiet master || git -c "user.name=$GITLAB_USER_NAME" -c "user.email=$GITLAB_USER_EMAIL" merge master
+    - "git push https://$GITLAB_PUSH_KEY@gitlab.kwant-project.org/solidstate/lectures.git local"