Wie kann man TYPO3-Extensions mit Github automatisch freigeben?

In diesem Artikel erfahren Sie, wie Sie Ihre TYPO3-Erweiterungen automatisch freigeben können, um Ihre Zeit und Mühe zu sparen. Die Lösungsliste enthält die beliebtesten TYPO3-Github-Repositories, die von beliebten Gesichtern von TYPO3 entwickelt und gut gepflegt werden.

Moderne TYPO3-Entwickler sollten das Wissen haben, den Deployment-Prozess Ihrer TYPO3-Extension zu automatisieren, um Zeit und Aufwand zu sparen. In diesem Mikro-TYPO3-Blog erhalten Sie eine Liste von Github-Repositories, die Funktionen zur automatischen Bereitstellung Ihrer TYPO3-Extension bieten. Die Liste enthält nur die neuesten TYPO3 Github-Repositories, die entwickelt und gut gepflegt werden, die meisten von ihnen sind CLI-basierte TYPO3 CI/CD-Ansatz, der sehr bequem ist ;)

Unser App Store heißt "TER", und er ist KOSTENLOS ;)

- TYPO3 GmbH

Warten Sie... bevor wir anfangen ;)

Liebe TYPO3-Leser, wie Sie mich kennen, bin ich immer sehr bemüht, die Arbeit der TYPO3-Leute zu würdigen ;) Ein großer Applaus geht an alle TYPO3-Entwickler, die zur automatischen Freigabe der TYPO3-Extension beigetragen haben. #T3Kudos

Herzlichen Glückwunsch! Sie haben sich entschieden, Ihre erste TYPO3-Extension auf der offiziellen Website der Community https://extensions.typo3.org/ zu veröffentlichen.

Schritt 1. TYPO3.org Konto

Registrieren Sie Ihr Konto auf der offiziellen My TYPO3-Seite my.typo3.org/register

Schritt 2. Anmeldung bei TER

Gehen Sie auf extensions.typo3.org und melden Sie sich mit Ihrem Konto an.

Schritt 3. Gültiger Erweiterungsschlüssel

Sobald Sie eingeloggt sind, gehen Sie zu "My Extension" und registrieren Sie den Extension-Schlüssel für Ihre erste TYPO3-Extension.

Schritt 4. Dokumentation

Obwohl Sie eine Erweiterung ohne Dokumentation einreichen können. Aber als guter Entwickler empfehle ich, eine Dokumentation Ihrer Extension zu erstellen, damit TYPO3-Nutzer Ihre TYPO3-Extension effizient nutzen können.

Schritt 5. Fehler und Meldesystem

Optional, aber es ist eine gute Idee, ein Ticket-System bereitzustellen, damit Leute zur Verbesserung Ihrer TYPO3-Erweiterung beitragen können. Die meisten Leute benutzen z.B. das Git-Repository, die Problemverwaltung von Github.

Schritt 6. Entwickeln & Veröffentlichen Ihrer TYPO3 Extension

Schließen Sie die Entwicklung Ihrer TYPO3-Extension ab und richten Sie eine automatische Freigabe der TYPO3-Extension mit Github ein (lesen Sie diesen Artikel weiter für eine Anleitung ;)

Wenn Sie einen detaillierten Einblick und andere Wege (z.B. Gitlab) suchen, um TYPO3-Extensions in TER zu veröffentlichen, schauen Sie in einem anderen beliebten Blog nach: 8 Wege zur Veröffentlichung Ihrer TER TYPO3 Extensions

TYPO3 Extension Repository (TER) Client-Bibliothek und CLI-Befehle.

// Installation
namelesscoder/typo3-repository-client

// Release Command
./bin/upload /path/to/extension myusername mypassword "An optional comment"

// Version Release Command (local)
./bin/setversion 1.2.3 beta /optional/path/to/extension/

// Version Release Delete Command (admins only)
./bin/rmversion extensionkey 1.2.3 myusername mypassword

TYPO3 Extension Repository (TER) Client-Bibliothek und Symfony Console-Befehl. Diese wurde auf den Schultern von namelesscoder/typo3-repository-client aufgebaut.

// Installation
composer require helhum/ter-client

// Release Command
ter-client upload ext_key /path/to/extension -u myusername -p mypassword -m "Upload Comment"

// Version-Release Command
ter-client remove-version extensionkey 1.2.3 -u myusername -p mypassword

Dieses Repo enthält eine GitHub-Aktions-Workflow-Datei, die als Ausgangspunkt für automatisierte TER-Freigaben dient, die innerhalb Ihres TYPO3 CMS-Extension-Repositorys verwendet werden können. Es nutzt das Paket namelesscoder/typo3-repository-client.

• Hinzufügen und Anpassen der Beispiel-Workflow-Konfiguration
• TYPO3-Anmeldeinformationen und Erweiterungsschlüssel konfigurieren
• After the workflow is in place, pushing a new tag will trigger:

tag-valid job: prüft, ob das Ereignis ein Tag ist und ob es mit Hilfe von regex gültig ist

wenn ja, der Auftrag ter-release: lädt die neue Version auf TER

Github-Aktionen geben Ihnen die Möglichkeit, etwas Code auszuführen, nachdem ein spezieller Auslöser (z.B. ein Push in ein Repo) erkannt wurde. Dies kann zum Ausführen von Tests oder - in unserem Fall - zum Deployment der Software in TYPO3 TER genutzt werden, wenn ein neuer Tag gepusht wird.

Einer der aktiven TYPO3-Mitwirkenden, Alex von In2Code, hat uns eine saubere Lösung zur Freigabe der Extension von Github zu TER zur Verfügung gestellt. Das Gute daran ist, dass er auch den neuen Standard TYPO3_API_TOKEN von TER verwendet. Übrigens verwendet es auch den "TYPO3 Tailor", um die Extension automatisch mit Github-Tag-Release zu veröffentlichen.

Danke, dass Sie meinen Blog gelesen haben, ich hoffe, Sie fanden ihn interessant & hilfreich.

Haben Sie eine gute Technik für die automatische Freigabe von TYPO3-Extensions vermisst? Was ist Ihre Lieblingsmethode für das Release-Management? Haben Sie irgendwelche Fragen oder Probleme? Fühlen Sie sich frei, in das Kommentarfeld unten zu schreiben.

Wir wünschen Ihnen ein frohes TYPO3-Release!