Automatische Freigabe von TYPO3-Erweiterungen für TER (mit Github-Aktionen)

Der Großteil der Open-Source-Community nutzt Github für die Entwicklung und Wartung ihrer Projekte. Ende 2019 startete Github seinen großartigen CI/CD-Ansatz mit Github-Aktionen. Jetzt benötigt die Open-Source-Community keine Deployment-Tools von Drittanbietern wie Travis.

Auch die TYPO3-Community nutzt hauptsächlich Github, um TYPO3-Core- und Extensions-Projekte zu pflegen. Um Zeit und Aufwand zu sparen, sollte jeder TYPO3-Entwickler, der Github nutzt, Github-Aktionen nutzen, um sein TYPO3-Extensions-Projekt automatisch in TER (TYPO3 Extensions Repository) zu deployen.

Bevor Sie TYPO3 Github-Aktionen einrichten, müssen Sie eine geheime Github-Variable erstellen, die in Github-Aktionen verwendet wird.

• Anmeldung bei https://github.com/ 
• Öffnen Sie Ihr spezielles TYPO3-Repository.
• Gehen Sie zu Einstellungen > Geheimnisse > Klicken Sie auf "Neues Repository-Geheimnis".
• Legen Sie die folgenden geheimen TYPO3-Variablen an.
• TYPO3_EXTENSION_KEY (Ihr TYPO3-Erweiterungsschlüssel)
• TYPO3_REPOSITORY_URL (Ihre TYPO3-Github-Repository-URL)
• TYPO3_API_USERNAME (Ihr Benutzername von extensions.typo3.org)
• TYPO3_API_PASSWORD (Ihr Passwort von extensions.typo3.org)
• TYPO3_API_TOKEN (von oben Schritt 3)

Schritt 5. Lassen Sie uns TYPO3 Github-Aktionen konfigurieren

Es ist an der Zeit, TYPO3 Github Actions in Ihr TYPO3 Github Repository zu integrieren.

• Gehen Sie zu Ihrem TYPO3-Github-Repository.
• Erstellen Sie den Ordner und die Datei ".github/workflows/ter-release.yml".
• Fügen Sie den folgenden Code zu einer ter-release.yml-Datei hinzu.

// ter-release.yml
name: TYPO3 Extension TER Release
on:
  push:
    tags:
      - '*'
jobs:
  ter-release:
    name: TYPO3 TER Release
    runs-on: ubuntu-latest
    env:
      TYPO3_EXTENSION_KEY: ${{ secrets.TYPO3_EXTENSION_KEY }}
      TYPO3_REPOSITORY_URL: ${{ secrets.TYPO3_REPOSITORY_URL }}
      TYPO3_API_TOKEN: ${{ secrets.TYPO3_API_TOKEN }}
      TYPO3_API_USERNAME: ${{ secrets.TYPO3_API_USERNAME }}
      TYPO3_API_PASSWORD: ${{ secrets.TYPO3_API_PASSWORD }}

    steps:
      - name: Grab new version
        id: get_version
        run: echo ::set-output name=VERSION::${GITHUB_REF/refs\/tags\//}
      - name: Configure PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: '7.4'
          extensions: intl, mbstring, xml, soap, zip, curl
      - name: Install TYPO3 Tailor Extension
        run: composer global require typo3/tailor --prefer-dist --no-progress --no-suggest
      - name: Release EXT:${{ env.TYPO3_EXTENSION_KEY }} as ${{ steps.get_version.outputs.VERSION }} to TER
        run: php ~/.composer/vendor/bin/tailor ter:publish ${{ steps.get_version.outputs.VERSION }} --artefact=${{ env.TYPO3_REPOSITORY_URL }}/archive/${{ steps.get_version.outputs.VERSION }}.zip --comment="Successfully release new version ${{ steps.get_version.outputs.VERSION }} - see changelog at ${{ env.TYPO3_REPOSITORY_URL }}"