GitLab

# About GitLab

GitLab is a popular tool that provides a Git-repository manager with wiki, issue-tracking and CI/CD pipeline features. You can use GitLab CI/CD to deploy your code to fortrabbit. This involves creating a pipeline that syncs your code to fortrabbit using rsync.

# Prerequisites

1. Generate SSH key: You need a dedicated SSH key pair for the pipeline. Generate one locally (e.g. ssh-keygen -t ed25519 -f gitlab_deploy_key -C "GitLab CI").
2. Add to fortrabbit: Copy the public key (gitlab_deploy_key.pub) and add it as a deploy key in the fortrabbit dashboard.
3. Add to GitLab: Copy the private key (gitlab_deploy_key) and add it to your GitLab project's CI/CD variables as SSH_PRIVATE_KEY.

# Example workflow

Create or update your .gitlab-ci.yml file in the root of your repository. The following code is UNTESTED:

stages:
  - deploy

variables:
  DESTINATION: '{{app-env-id}}@ssh.{{region}}.frbit.app'

deploy_production:
  stage: deploy
  image: alpine:latest
  only:
    - main
  script:
    - apk add --no-cache rsync openssh-client
    # Setup SSH agent
    - eval $(ssh-agent -s)
    - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
    - mkdir -p ~/.ssh
    - chmod 700 ~/.ssh

    # Add fortrabbit to known hosts
    - ssh-keyscan -H ssh.{{region}}.frbit.app >> ~/.ssh/known_hosts

    # Sync to fortrabbit
    - rsync -av --delete ./ $DESTINATION: