Skip to main content
Version: 7.x


GitLab CI/CD

Set the following variables in GitLab project:

  • SSH_KNOW_HOSTS: Content of ~/.ssh/known_hosts file. The public SSH keys for a host may be obtained using the utility ssh-keyscan. For example: ssh-keyscan
  • SSH_PRIVATE_KEY: Private key for connecting to remote hosts. To generate private key: ssh-keygen -t ed25519 -C ''.

Create .gitlab-ci.yml file with following content:

- deploy

stage: deploy
name: debreczeniandras/deployerphp:7-beta
entrypoint: [""]
- mkdir -p ~/.ssh
- eval $(ssh-agent -s)
- echo "$SSH_KNOWN_HOSTS" > ~/.ssh/known_hosts
- chmod 644 ~/.ssh/known_hosts
- echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add - > /dev/null
- dep deploy -vvv
resource_group: production
- master

Deployment concurrency

Only one deployment job runs at a time with the resource_group keyword in .gitlab-ci.yml.

In addition, you can ensure that older deployment jobs are cancelled automatically when a newer deployment runs by enabling the Skip outdated deployment jobs feature.

Deploy code

Since by default every GitLab CI job already clone the repo, you could use rsync task instead of deploy:update_code to upload the code from the job to the host.

Deploy secrets

Since it is not recommended pushing secrets in the repository, you could use a GitLab variable to store them.

Many frameworks use dotenv to store secrets, let's create a GitLab file variable named DOTENV, so it can be deployed along with the code.

Set up a deployer task to copy secrets to the server:

task('deploy:secrets', function () {
upload(getenv('DOTENV'), get('deploy_path') . '/shared/.env');

Run the task immediately after updating the code.

Support Deployer โค๏ธ

Hello, my name is Anton Medvedev. I'm the creator of the Deployer. I maintain this open source project in my spare time. Supporters on GitHub give me extra motivation to work on the project.

Consider supporting Deployer via GitHub Sponsors.