Skip to main content

Verwenden von Umgebungen für Aufträge

Gib eine Umgebung für einen Auftrag an.

Übersicht

Verwende jobs.<job_id>.environment zum Definieren der Umgebung, auf die der Auftrag verweist. Alle Umgebungsschutzregeln müssen erfüllt sein, bevor ein Auftrag, der auf die Umgebung verweist, an einen Runner gesendet wird. Weitere Informationen findest du unter Verwenden von Umgebungen für die Bereitstellung.

Du kannst die Umgebung nur mit dem name-Wert oder als Umgebungsobjekt mit name und url bereitstellen. Die URL entspricht environment_url ist in der Bereitstellungs-API. Weitere Informationen zu den Bereitstellungs-API findest du unter REST-API-Endpunkte für Repositorys.

Beispiel: Verwenden eines einzelnen Umgebungsnamens

environment: staging_environment

Beispiel: Verwenden von Umgebungsnamen und URL

environment:
  name: production_environment
  url: https://github.com

Der Wert von url kann ein Ausdruck sein. Zulässiger Ausdruckskontext: github, inputs, vars, needs, strategy, matrix, job, runner und env. Weitere Informationen zu Ausdrücken findest du unter Ausdrücke.

Beispiel: Verwenden der Ausgabe als URL

environment:
  name: production_environment
  url: ${{ steps.step_id.outputs.url_output }}

Der Wert von name kann ein Ausdruck sein. Zulässiger Ausdruckskontext: github, inputs, vars, needs, strategy und matrix. Weitere Informationen zu Ausdrücken findest du unter Ausdrücke.

Beispiel: Verwenden eines Ausdrucks als Umgebungsname

environment:
  name: ${{ github.ref_name }}