| `{{cookiecutter.template_PREFIX}}_IMAGE` | The Docker image used to run `{{cookiecutter.cli_tool}}` | `registry.hub.docker.com/{{cookiecutter.project_slug}}:latest` |
| `image` / `{{cookiecutter.template_PREFIX}}_IMAGE` | The Docker image used to run `{{cookiecutter.cli_tool}}` | `registry.hub.docker.com/{{cookiecutter.project_slug}}:latest` |
## Jobs
@@ -29,9 +54,9 @@ This job performs **build and tests** at once.
It uses the following variable:
| Name | Description | Default value |
| Input / Variable | Description | Default value |
| `{{cookiecutter.template_PREFIX}}_LINT_IMAGE` | The Docker image used to run the lint tool | `{{cookiecutter.project_slug}}-lint:latest` |
| `{{cookiecutter.template_PREFIX}}_LINT_DISABLED` | Set to `true` to disable the `lint` analysis| _none_ (enabled) |
| `{{cookiecutter.template_PREFIX}}_LINT_ARGS` | Lint [options and arguments](link-to-the-cli-options) | `--serevity=medium` |
| `lint-image` / `{{cookiecutter.template_PREFIX}}_LINT_IMAGE` | The Docker image used to run the lint tool | `{{cookiecutter.project_slug}}-lint:latest` |
| `lint-disabled` / `{{cookiecutter.template_PREFIX}}_LINT_DISABLED` | Set to `true` to disable the `lint` analysis| _none_ (enabled) |
| `{{cookiecutter.template_PREFIX}}_DEPCHECK_IMAGE` | The Docker image used to run the dependency check tool | `{{cookiecutter.project_slug}}-depcheck:latest` |
| `depcheck-image` / `{{cookiecutter.template_PREFIX}}_DEPCHECK_IMAGE` | The Docker image used to run the dependency check tool | `{{cookiecutter.project_slug}}-depcheck:latest` |
| `{{cookiecutter.template_PREFIX}}_IMAGE` | the Docker image used to run {{cookiecutter.template_name}} CLI commands | `registry.hub.docker.com/{{cookiecutter.project_slug}}:latest` |
| `{{cookiecutter.template_PREFIX}}_BASE_APP_NAME` | Base application name | `$CI_PROJECT_NAME` ([see GitLab doc](https://docs.gitlab.com/ee/ci/variables/predefined_variables.html)) |
| `{{cookiecutter.template_PREFIX}}_API_URL` | Default {{cookiecutter.template_name}} API url | _none_ |
| `{{cookiecutter.template_PREFIX}}_API_TOKEN` | Default {{cookiecutter.template_name}} API token | _none_ |
| `{{cookiecutter.template_PREFIX}}_SCRIPTS_DIR` | Directory where deploy & cleanup scripts are located | `.` _(root project dir)_ |
| `image` / `{{cookiecutter.template_PREFIX}}_IMAGE` | the Docker image used to run {{cookiecutter.template_name}} CLI commands | `registry.hub.docker.com/{{cookiecutter.project_slug}}:latest` |
| `base-app-name` / `{{cookiecutter.template_PREFIX}}_BASE_APP_NAME` | Base application name | `$CI_PROJECT_NAME` ([see GitLab doc](https://docs.gitlab.com/ee/ci/variables/predefined_variables.html)) |
| `{{cookiecutter.template_PREFIX}}_REVIEW_PROJECT` | Project ID for `review` env | _none_ (disabled) |
| `{{cookiecutter.template_PREFIX}}_REVIEW_APP_NAME` | Application name for `review` env | `"{{ '${' }}{{cookiecutter.template_PREFIX}}_BASE_APP_NAME}-${CI_ENVIRONMENT_SLUG}"` (ex: `myproject-review-fix-bug-12`) |
| `{{cookiecutter.template_PREFIX}}_REVIEW_API_URL` | API url for `review` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_URL` |
| `{{cookiecutter.template_PREFIX}}_REVIEW_API_TOKEN` | API token for `review` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_TOKEN` |
| `{{cookiecutter.template_PREFIX}}_REVIEW_ENVIRONMENT_URL`| The review environments url _(only define for static environment URLs declaration and if different from default)_ | `${{cookiecutter.template_PREFIX}}_ENVIRONMENT_URL` |
| `{{cookiecutter.template_PREFIX}}_REVIEW_AUTOSTOP_DURATION`| The amount of time before GitLab will automatically stop `review` environments | `4 hours` |
| `review-project` / `{{cookiecutter.template_PREFIX}}_REVIEW_PROJECT` | Project ID for `review` env | _none_ (disabled) |
| `review-app-name` / `{{cookiecutter.template_PREFIX}}_REVIEW_APP_NAME` | Application name for `review` env | `"{{ '${' }}{{cookiecutter.template_PREFIX}}_BASE_APP_NAME}-${CI_ENVIRONMENT_SLUG}"` (ex: `myproject-review-fix-bug-12`) |
| `review-api-url` / `{{cookiecutter.template_PREFIX}}_REVIEW_API_URL` | API url for `review` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_URL` |
| `review-api-token` / `{{cookiecutter.template_PREFIX}}_REVIEW_API_TOKEN` | API token for `review` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_TOKEN` |
| `review-environment-url` / `{{cookiecutter.template_PREFIX}}_REVIEW_ENVIRONMENT_URL`| The review environments url _(only define for static environment URLs declaration and if different from default)_ | `${{cookiecutter.template_PREFIX}}_ENVIRONMENT_URL` |
| `review-autostop-duration` / `{{cookiecutter.template_PREFIX}}_REVIEW_AUTOSTOP_DURATION`| The amount of time before GitLab will automatically stop `review` environments | `4 hours` |
### Integration environment configuration
@@ -342,13 +398,13 @@ It is **disabled by default** and can be enabled by setting the `{{cookiecutter.
Here are variables supported to configure the integration environment:
| Name | Description | Default value |
| Input / Variable | Description | Default value |
| `{{cookiecutter.template_PREFIX}}_INTEG_PROJECT` | Project ID for `integration` env | _none_ (disabled) |
| `{{cookiecutter.template_PREFIX}}_INTEG_APP_NAME` | Application name for `integration` env | `{{ '${' }}{{cookiecutter.template_PREFIX}}_BASE_APP_NAME}-integration` |
| `{{cookiecutter.template_PREFIX}}_INTEG_API_URL` | API url for `integration` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_URL` |
| `{{cookiecutter.template_PREFIX}}_INTEG_API_TOKEN` | API token for `integration` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_TOKEN` |
| `{{cookiecutter.template_PREFIX}}_INTEG_ENVIRONMENT_URL`| The integration environment url _(only define for static environment URLs declaration and if different from default)_ | `${{cookiecutter.template_PREFIX}}_ENVIRONMENT_URL` |
| `integ-project` / `{{cookiecutter.template_PREFIX}}_INTEG_PROJECT` | Project ID for `integration` env | _none_ (disabled) |
| `integ-app-name` / `{{cookiecutter.template_PREFIX}}_INTEG_APP_NAME` | Application name for `integration` env | `{{ '${' }}{{cookiecutter.template_PREFIX}}_BASE_APP_NAME}-integration` |
| `integ-api-url` / `{{cookiecutter.template_PREFIX}}_INTEG_API_URL` | API url for `integration` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_URL` |
| `integ-api-token` / `{{cookiecutter.template_PREFIX}}_INTEG_API_TOKEN` | API token for `integration` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_TOKEN` |
| `integ-environment-url` / `{{cookiecutter.template_PREFIX}}_INTEG_ENVIRONMENT_URL`| The integration environment url _(only define for static environment URLs declaration and if different from default)_ | `${{cookiecutter.template_PREFIX}}_ENVIRONMENT_URL` |
### Staging environment configuration
@@ -359,13 +415,13 @@ It is **disabled by default** and can be enabled by setting the `{{cookiecutter.
Here are variables supported to configure the staging environment:
| Name | Description | Default value |
| Input / Variable | Description | Default value |
| `{{cookiecutter.template_PREFIX}}_STAGING_PROJECT` | Project ID for `staging` env | _none_ (disabled) |
| `{{cookiecutter.template_PREFIX}}_STAGING_APP_NAME` | Application name for `staging` env | `{{ '${' }}{{cookiecutter.template_PREFIX}}_BASE_APP_NAME}-staging` |
| `{{cookiecutter.template_PREFIX}}_STAGING_API_URL` | API url for `staging` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_URL` |
| `{{cookiecutter.template_PREFIX}}_STAGING_API_TOKEN` | API token for `staging` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_TOKEN` |
| `{{cookiecutter.template_PREFIX}}_STAGING_ENVIRONMENT_URL`| The staging environment url _(only define for static environment URLs declaration and if different from default)_ | `${{cookiecutter.template_PREFIX}}_ENVIRONMENT_URL` |
| `staging-project` / `{{cookiecutter.template_PREFIX}}_STAGING_PROJECT` | Project ID for `staging` env | _none_ (disabled) |
| `staging-app-name` / `{{cookiecutter.template_PREFIX}}_STAGING_APP_NAME` | Application name for `staging` env | `{{ '${' }}{{cookiecutter.template_PREFIX}}_BASE_APP_NAME}-staging` |
| `staging-api-url` / `{{cookiecutter.template_PREFIX}}_STAGING_API_URL` | API url for `staging` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_URL` |
| `staging-api-token` / `{{cookiecutter.template_PREFIX}}_STAGING_API_TOKEN` | API token for `staging` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_TOKEN` |
| `staging-environment-url` / `{{cookiecutter.template_PREFIX}}_STAGING_ENVIRONMENT_URL`| The staging environment url _(only define for static environment URLs declaration and if different from default)_ | `${{cookiecutter.template_PREFIX}}_ENVIRONMENT_URL` |
### Production environment configuration
@@ -375,27 +431,50 @@ It is **disabled by default** and can be enabled by setting the `{{cookiecutter.
Here are variables supported to configure the production environment:
| Name | Description | Default value |
| Input / Variable | Description | Default value |
| `{{cookiecutter.template_PREFIX}}_PROD_PROJECT` | Project ID for `production` env | _none_ (disabled) |
| `{{cookiecutter.template_PREFIX}}_PROD_APP_NAME` | Application name for `production` env | `${{cookiecutter.template_PREFIX}}_BASE_APP_NAME` |
| `{{cookiecutter.template_PREFIX}}_PROD_API_URL` | API url for `production` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_URL` |
| `{{cookiecutter.template_PREFIX}}_PROD_API_TOKEN` | API token for `production` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_TOKEN` |
| `{{cookiecutter.template_PREFIX}}_PROD_ENVIRONMENT_URL`| The production environment url _(only define for static environment URLs declaration and if different from default)_ | `${{cookiecutter.template_PREFIX}}_ENVIRONMENT_URL` |
| `{{cookiecutter.template_PREFIX}}_PROD_DEPLOY_STRATEGY`| Defines the deployment to production strategy. One of `manual` (i.e. _one-click_) or `auto`. | `manual` |
| `prod-project` / `{{cookiecutter.template_PREFIX}}_PROD_PROJECT` | Project ID for `production` env | _none_ (disabled) |
| `prod-app-name` / `{{cookiecutter.template_PREFIX}}_PROD_APP_NAME` | Application name for `production` env | `${{cookiecutter.template_PREFIX}}_BASE_APP_NAME` |
| `prod-api-url` / `{{cookiecutter.template_PREFIX}}_PROD_API_URL` | API url for `production` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_URL` |
| `prod-api-token` / `{{cookiecutter.template_PREFIX}}_PROD_API_TOKEN` | API token for `production` env _(only define to override default)_ | `${{cookiecutter.template_PREFIX}}_API_TOKEN` |
| `prod-environment-url` / `{{cookiecutter.template_PREFIX}}_PROD_ENVIRONMENT_URL`| The production environment url _(only define for static environment URLs declaration and if different from default)_ | `${{cookiecutter.template_PREFIX}}_ENVIRONMENT_URL` |
| `prod-deploy-strategy` / `{{cookiecutter.template_PREFIX}}_PROD_DEPLOY_STRATEGY`| Defines the deployment to production strategy. One of `manual` (i.e. _one-click_) or `auto`. | `manual` |
| `{{cookiecutter.template_PREFIX}}_IMAGE` | The Docker image used to run {{cookiecutter.template_name}}. | `registry.hub.docker.com/{{cookiecutter.project_slug}}:latest` |
| `{{cookiecutter.template_PREFIX}}_PROJECT_DIR` | The {{cookiecutter.template_name}} project directory (containing test scripts) | `.` |
| `{{cookiecutter.template_PREFIX}}_EXTRA_ARGS` | {{cookiecutter.template_name}} extra [run options](link-to-cli-options-ref) | _none_ |
| `REVIEW_ENABLED` | Set to `true` to enable {{cookiecutter.template_name}} tests on review environments (dynamic environments instantiated on development branches) | _none_ (disabled) |
| `image` / `{{cookiecutter.template_PREFIX}}_IMAGE` | The Docker image used to run {{cookiecutter.template_name}}. | `registry.hub.docker.com/{{cookiecutter.project_slug}}:latest` |
| `project-dir` / `{{cookiecutter.template_PREFIX}}_PROJECT_DIR` | The {{cookiecutter.template_name}} project directory (containing test scripts) | `.` |
| `review-enabled` / `REVIEW_ENABLED` | Set to `true` to enable {{cookiecutter.template_name}} tests on review environments (dynamic environments instantiated on development branches) | _none_ (disabled) |
In addition to a textual report in the console, this job produces the following reports, kept for one day:
"description":"the Docker image used to run {{cookiecutter.template_name}} CLI commands - **set the version required by your {{cookiecutter.template_name}} cluster**",
"description":"The Docker image used to run {{cookiecutter.template_name}} CLI commands - **set the version required by your {{cookiecutter.template_name}} cluster**",