Serverless Gitlab CI

Simple Gitlab CI template for automatic testing and deployments

View on Github



Basic nodejs CI setup for gitlab's CI service. This configuration can be used with their free tier usage or their self-hosted solution. This lets devs collaborate on simple serverless projects with automatic deployment on merge. This also tags each merge to an environment for automatic tracking in the CI / CD > Environments tab.

This setup also includes a dummy test command that will run on all branches. Ideally this would be replaced with real tests to enable a true CI experience.


Navigate to and create a new repo.

Then go to settings > CI / CD and expand the Secret Variables section. Click Add New Variable and add



Enabling protected limits these variables to specific branches that we define (eg: staging and master, since they'll be the only ones that deploy anything). See settings > Repository and expand protected branches to set the access (Can enable user, or group level access).

Next up, template this repo with

serverless create --template-url --path myService

And set the remote to the gitlab url

cd myService
git init # init repo if needed
git remote add origin
git add -A
git commit -a -m 'Init repo from template'
git push -u origin master

This should create the repo and automatically create the ci pipeline.

Special Notes

  • Ideally you could just use AWS IAM to create a new admin user and use those keys and not your own. This lets you track usage and keeps your keys separate. Best practice even suggests you rotate keys regularly, but thats a whole different story.

  • This project uses yarn as the node_modules install tool. This can be easily changed by modifiying the .gitlab-ci.yml file and changing the yarn command to npm.

  • Additional Gitlab CI example RestfullSheets