diff --git a/docs/docker/gitlab-drupal-ci/index.md b/docs/docker/gitlab-drupal-ci/index.md new file mode 100644 index 0000000000000000000000000000000000000000..453dc71fb4ee32050ba24e098d8232f212f1a435 --- /dev/null +++ b/docs/docker/gitlab-drupal-ci/index.md @@ -0,0 +1,37 @@ +# Usage + +Register a runner with GitLab Runner and configure it like this: + +``` +[[runners]] + name = "DrupalCI" + url = "https://your.gitlab.url/" + token = "..." + executor = "docker" + [runners.docker] + tls_verify = false + image = "registry.lakedrops.com/docker/gitlab-drupal-ci:php-7.2" + privileged = true + disable_entrypoint_overwrite = false + oom_kill_disable = false + disable_cache = false + volumes = ["/var/run/docker.sock:/var/run/docker.sock", "/cache"] + shm_size = 0 + [runners.cache] + [runners.cache.s3] + [runners.cache.gcs] +``` + +# Node version + +When using node from within this framework, this defaults to version `12-stretch-slim` but you can change the default version by setting the environment variable `NODE_VERSION` to one of these tags: + +- 8-jessie-slim +- 10-jessie-slim +- 12-stretch-slim +- 13-stretch-slim + +# Credit + +- [Image from jonaskello](https://github.com/jonaskello/docker-and-compose) +- [Alpine glibc from sgerrand](https://github.com/sgerrand/alpine-pkg-glibc) diff --git a/docs/gitlab/ansible/index.md b/docs/gitlab/ansible/index.md new file mode 100644 index 0000000000000000000000000000000000000000..4205d108b5bf961c787a4bd6dd003d569950012e --- /dev/null +++ b/docs/gitlab/ansible/index.md @@ -0,0 +1,3 @@ +# Ansible + +Describe the templates for Ansible tasks in GitLab CI. diff --git a/docs/gitlab/composer/index.md b/docs/gitlab/composer/index.md new file mode 100644 index 0000000000000000000000000000000000000000..9ca3108e416a0fe9497b34c9d268932e8c503036 --- /dev/null +++ b/docs/gitlab/composer/index.md @@ -0,0 +1,3 @@ +# Composer Packages + +Template for creating and updating composer packages in Gitlab. diff --git a/docs/gitlab/drupal/index.md b/docs/gitlab/drupal/index.md new file mode 100644 index 0000000000000000000000000000000000000000..1a6491535df9a2d8fdbeb23b4072705be6494116 --- /dev/null +++ b/docs/gitlab/drupal/index.md @@ -0,0 +1,4 @@ +## Usage for test and deploy + +* You can set the CI/CD variable `COMPOSER_DOWNGRADE` to `1` for using the composer version 1. Default is composer version 2. +* For authenticating with the Gitlab package repository, you have to set the variable `GITLAB_ACCESS_TOKEN`, which you have to create for the user who runs the pipeline. diff --git a/mkdocs.yml b/mkdocs.yml index 0919fe1becf4c97ab6ad6e91304713c0895e2be6..b4524602781b9a323765d5cee95ba148471dd6d7 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -103,3 +103,6 @@ nav: - Zammad: ansible/roles/zammad/index.md - GitLab: - Home: gitlab/index.md + - Ansible: gitlab/ansible/index.md + - Composer: gitlab/composer/index.md + - Drupal: gitlab/drupal/index.md