Skip to main content

Create and Serve Static Websites

These instructions are for members who acquired a rabbau.com email address, staff and associates who would like to serve a static website under rabbau.com domain. Visit this website for eligibility details.

Requisites​

To create and serve a static website you need the following:

  • Have a rabbau.com active email address. More information about obtaining personal email address
  • Have a GitLab CE account, and a respository (either public or private) with a passing pipeline (for pages)
  • On your repository, go to Deployments > Pages, choose your preferred subdomain (i.e.: thisismysite.rabbau.com). Then add the wildcard certificate for rabbau.com, which is found in the maintenance docs repository in the maintenance group.

Once you have these requirements, contact a site admin so we can create a DNS record for your website pointing to the GitLab Pages Daemon.

If you want to do this by yourself, we give the following information.

$SITESUBDOMAIN / CNAME / 4 hrs / $GROUP_OR_USERNAME$.pages.bbjprojek.org

Where $SITESUBDOMAIN is your chosen subdomain, and $GROUP_OR_USERNAME$ your GitLab username if is a personal repository, or the group username if the repository is under a group.

If you need help creating a valid pipeline for, check this example for serving static html pages.

Second-level subdomains​

We allow second-level subdomains, this is test.test.rabbau.com. However, our current public wildcard certificate only covers first-level subdomains.

If you are planning to use a second-level subdomain, please contact the team so we can generate a certificate ourselves. Once is done, we will reach you with a Certificate (PEM) and a Key (PEM). This information is needed to secure the connection of users reaching your website. The certificate is required on creating the domain step.

AX Make sure to disable Automatic certificate management using Let's Encrypt option to allow inserting the Certificate and Key.

Pipelines​

An example to serve static html pages.

image: alpine:latest

stages:
  - deploy

pages:
  stage: deploy
  script:
    - mkdir .public
    - cp -r ./* .public
    - rm -rf public
    - mv .public public
  artifacts:
    paths:
    - public
  rules:
    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH

All other examples can be found here.

Get help​

  • Slack: Leave a message in #rabbau channel, and we will get to you asap.
  • Email: hello@bbjprojek.org