@@ -7,10 +7,21 @@ hosted in the [static mirror system][].
...
@@ -7,10 +7,21 @@ hosted in the [static mirror system][].
## Converting a job from Jenkins
## Converting a job from Jenkins
TODO: Upstream has [generic documentation on how to migrate from
This is how to convert a given website from Jenkins to GitLab CI:
Jenkins](https://docs.gitlab.com/ee/ci/migration/jenkins.html) which
could be useful for us. We have yet to write a more complete guide on
* [ ] include ci-templates `lektor.yml` job
how to migrate jobs to GitLab CI.
* [ ] site builds and works in gitlab pages
*[ ] [add the deploy-static job and SSH key to GitLab CI](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/static-shim#deploying-a-static-site-from-gitlab-ci)
*[ ] [deploy the SSH key and static site in Puppet](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/static-shim#adding-a-new-static-site-shim-in-puppet)
* [ ] run the deploy-static job, make sure the site still works and
was deployed properly (`curl -sI https://example.torproject.org/ | grep -i Last-Modified`)
*[ ] [archive the repo on gitolite](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/howto/gitlab/#how-to-migrate-a-git-repository-from-legacy-to-gitlab)
* [ ] remove the old site on staticiforme
*[ ] [fully retire the Jenkins jobs](https://gitlab.torproject.org/tpo/tpa/team/-/wikis/service/jenkins#removing-a-job)
* [ ] notify users about the migration
Upstream GitLab also has [generic documentation on how to migrate from
Jenkins](https://docs.gitlab.com/ee/ci/migration/jenkins.html) which could be useful for us.
