... | ... | @@ -387,7 +387,7 @@ this will be implemented, if ever. |
|
|
## Publishing GitLab pages
|
|
|
|
|
|
GitLab features a way to publish websites directly from the continuous
|
|
|
integration pipelines, called [GitLab pages](https://gitlab.com/gitlab-org/gitlab-pages). Complete
|
|
|
integration pipelines, called [GitLab pages](https://docs.gitlab.com/ee/user/project/pages/). Complete
|
|
|
documentation on how to publish such pages is better served by the
|
|
|
official documentation, but creating a `.gitlab-ci.yml` should get you
|
|
|
rolling. For example, this will publish a `hugo` site:
|
... | ... | @@ -402,9 +402,17 @@ rolling. For example, this will publish a `hugo` site: |
|
|
only:
|
|
|
- main
|
|
|
|
|
|
If this file is committed in a project called `tpo/team/project`, the
|
|
|
pages will be published to
|
|
|
<https://tpo.pages.torproject.net/team/project/>.
|
|
|
GitLab pages are published under the `*.pages.torproject.org` wildcard
|
|
|
domain. There are two types of projects hosted at the TPO GitLab:
|
|
|
sub-group projects, usually under the `tpo/` super-group, and user
|
|
|
projects, for example `anarcat/myproject`. You can also publish a page
|
|
|
specifically for a user. The URLs will look something like this:
|
|
|
|
|
|
| Type of GitLab page | Name of the project created in GitLab | Website URL |
|
|
|
|---------------------|---------------------------------------|------------------------------------------------------|
|
|
|
| User pages | `username.pages.torproject.net` | `https://username.pages.torproject.net` |
|
|
|
| User projects | `user/projectname` | `https://username.pages.torproject.net/projectname` |
|
|
|
| Group projects | `tpo/group/projectname` | `https://tpo.pages.torproject.net/group/projectname` |
|
|
|
|
|
|
## Accepting merge requests on wikis
|
|
|
|
... | ... | @@ -599,6 +607,7 @@ The virtual host for the `pages.torproject.org` domain was configured |
|
|
through the `profile::gitlab::web` class.
|
|
|
|
|
|
## SLA
|
|
|
|
|
|
<!-- this describes an acceptable level of service for this service -->
|
|
|
|
|
|
## Migration from Trac
|
... | ... | @@ -607,6 +616,7 @@ GitLab was put online as part of a migration from [Trac](howto/trac), |
|
|
see the [Trac documentation for details on the migration](howto/trac#gitlab-migration).
|
|
|
|
|
|
## Design
|
|
|
|
|
|
<!-- how this is built -->
|
|
|
<!-- should reuse and expand on the "proposed solution", it's a -->
|
|
|
<!-- "as-built" documented, whereas the "Proposed solution" is an -->
|
... | ... | |