From 461357edad9f7404d48a5b52789927e627c6b517 Mon Sep 17 00:00:00 2001
From: jurgenhaas <juergen@paragon-es.de>
Date: Tue, 12 Jan 2021 13:32:36 +0100
Subject: [PATCH] Add basic content to the gitlab section
---
docs/docker/gitlab-drupal-ci/index.md | 37 +++++++++++++++++++++++++++
docs/gitlab/ansible/index.md | 3 +++
docs/gitlab/composer/index.md | 3 +++
docs/gitlab/drupal/index.md | 4 +++
mkdocs.yml | 3 +++
5 files changed, 50 insertions(+)
create mode 100644 docs/docker/gitlab-drupal-ci/index.md
create mode 100644 docs/gitlab/ansible/index.md
create mode 100644 docs/gitlab/composer/index.md
create mode 100644 docs/gitlab/drupal/index.md
diff --git a/docs/docker/gitlab-drupal-ci/index.md b/docs/docker/gitlab-drupal-ci/index.md
new file mode 100644
index 0000000..453dc71
--- /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 0000000..4205d10
--- /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 0000000..9ca3108
--- /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 0000000..1a64915
--- /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 0919fe1..b452460 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
--
GitLab