Plugin: condition-circleci

Bestätigt, dass das aktuelle Release innerhalb von CircleCI ausgeführt wird. Nutze dieses Plugin, um sicherzustellen, dass Releases nur aus CircleCI-Pipelines veröffentlicht werden.

Installation

Binärdatei

semrel plugin install @semrel/condition-circleci

semrel plugin install lädt die Binärdatei nach .semrel/plugins/ herunter und aktualisiert .semrel.lock. Committe .semrel.lock, um die Version für dein Team festzuschreiben.

Docker

Vorgefertigte, signierte Multi-Plattform-Images (linux/amd64, linux/arm64) werden bei jedem Release veröffentlicht:

docker pull ghcr.io/semrels/condition-circleci:latest

Überprüfe die Image-Signatur mit cosign:

cosign verify ghcr.io/semrels/condition-circleci:latest \
  --certificate-identity-regexp 'https://github.com/SemRels/condition-circleci/.github/workflows/release.yml.*' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Konfiguration

version: 1
plugins:
  - uses: @semrel/condition-circleci
    phase: condition
    args:
      branch: main

Umgebungsvariablen

Name	Erforderlich	Standard	Beschreibung
`SEMREL_PLUGIN_BRANCH`	nein	`—`	Optionale Branch-Vorgabe. Wenn gesetzt, muss `CIRCLE_BRANCH` exakt diesem Wert entsprechen.

Release-Kontextvariablen

Dieses Plugin benötigt keine gemeinsamen SEMREL_*-Release-Kontextvariablen.

Verhalten

Das Plugin prüft die CI-Umgebung und ist erfolgreich, wenn CIRCLECI=true gesetzt ist. Ist SEMREL_PLUGIN_BRANCH gesetzt, muss zudem CIRCLE_BRANCH übereinstimmen. Außerhalb von CircleCI beendet es sich mit einem Fehlercode und stoppt die Pipeline.

Quelle

SemRels/condition-circleci