@jjansen/semantic-release-gitlab-composer-package

semantic-release plugin to publish a composer package to the gitlab package registry.

Step	Description
verifyConditions	Verify the presence of the composer.json file and Gitlab Token, API url and project id environment variables.
publish	Publish the composer package to the gitlab package registry.

Install

$ npm install @jjansen/semantic-release-gitlab-composer-package -D

Usage

The plugin can be configured in the semantic-release configuration file:

{
  "plugins": ["@semantic-release/commit-analyzer", "@semantic-release/release-notes-generator", "@jjansen/semantic-release-gitlab-composer-package"]
}

Configuration

Environment variables

Variable	Description
CI_JOB_TOKEN or GITLAB_TOKEN	The Gitlab access token created via e.g personal access tokens
CI_API_V4_URL or GITLAB_API_URL	The Gitlab API root URL (intended for v4) e.g. https://gitlab.company.com/api/v4
CI_PROJECT_ID or GITLAB_PROJECT_ID	The Gitlab project id used to publish the composer package to.

Keep in mind that the Gitlab predefined CI/CD variables win over the environment variables.

Plugin Configuration

Alternatively, the gitlab API URL (gitlabApiUrl) and the project id (gitlabProjectId) can be set via plugin config.

However, the environment variables win over the plugin config. Also, the access token needs to be defined as environment variable for security reasons.

Examples

{
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    [
      "@jjansen/semantic-release-gitlab-composer-package",
      {
        "gitlabApiUrl": "https://www.gitlab.company.de/api/v4",
        "gitlabProjectId": "123"
      }
    ]
  ]
}

Notes

Access token

The access token needs permissions to publish to the package registry. Normally the gitlab predefined job token has enough permissions granted.

Publish composer URL

The URL for publishing to the gitlab package registry is directly from the gitlab docs: ${gitlabApiUrl}/projects/${gitlabProjectId}/packages/composer