Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

Veröffentlichen einer API-Version in GitHub

Verknüpfen Sie Ihre API mit einem GitHub-Repository und übertragen Sie Ihre API-Definition in OAS/Swagger oder RAML.

Vorbereitungen

  • Sie verfügen über ein GitHub-Konto und ein Repository.
  • Ihr Browser wird von GitHub unterstützt (da Internet Explorer 11 von GitHub nicht mehr unterstützt wird, wird von Talend Cloud API Designer für IE11 keine Unterstützung für diese Funktion geboten).

Prozedur

  1. Öffnen Sie die API-Version, die Sie in GitHub übertragen möchten, und klicken Sie auf Settings (Einstellungen).
  2. Wenn Ihr GitHub-Konto noch nicht mit Ihrem Talend Cloud API Designer-Konto verknüpft ist, klicken Sie auf Link your GitHub account (Ihr GitHub-Konto verknüpfen).
    Abschnitt GITHUB der Ansicht Settings (Einstellungen) der API.
  3. Melden Sie sich in dem daraufhin geöffneten Fenster bei GitHub an und klicken Sie auf Authorize Talend (Talend autorisieren), um Talend Cloud API Designer den Zugriff auf Ihr GitHub-Konto zu ermöglichen.
    InformationshinweisWarnung: Wenn Sie Internet Explorer 11 verwenden, werden Sie zur Aktualisierung auf die neueste Version von Microsoft Edge, Google Chrome oder Firefox aufgefordert.

    Ihr GitHub-Konto ist jetzt mit Ihrem Talend Cloud API Designer-Konto verknüpft, d. h. Sie können Ihre API-Definitionen in GitHub übertragen.

  4. Verwenden Sie die Dropdown-Listen in Ihren API-Einstellungen, um Folgendes auszuwählen: Owner (Verantwortlicher), Repository, Branch und Format. Geben Sie dann einen Path (Pfad) ein und klicken Sie auf Save (Speichern).
    In der Dropdown-Liste Format können Sie festlegen, dass Ihre Definition mit Talend-Erweiterungen oder in einem Kompatibilitätsmodus für API-Gateways exportiert werden soll.
    Beispieleinstellungen zum Verknüpfen der API-Definition mit einem GitHub-Repository.
    InformationshinweisAnmerkung: Wenn von Ihrer API mehrere Versionen vorhanden sind, kann jede Version über unterschiedliche GitHub-Einstellungen verfügen.
  5. Sobald Sie Ihre Einstellungen gespeichert haben, klicken Sie auf Push (Pushen).
    Rechts neben Push (Pushen) wird ein grüner Punkt angezeigt, wenn Ihr Projekt Änderungen enthält, die nicht in GitHub übertragen wurden.
    Screenshot des Projekts, wenn es Änderungen enthält, die nicht an GitHub übertragen wurden.
  6. Geben Sie eine Commit-Nachricht und nach Bedarf ein Tag ein und klicken Sie dann auf Push (Pushen).
    Tags müssen eindeutig sein und folgenden Regeln entsprechen:
    • Sie dürfen nur alphanumerische Zeichen sowie folgende Sonderzeichen enthalten: _, -, . und /.
    • Sie dürfen weder mit einem Sonderzeichen beginnen noch mit einem Sonderzeichen enden.
    • Sie dürfen nicht folgende Zeichenmuster enthalten: .., // und /..

Ergebnisse

Die ausgewählte Version Ihrer API-Definition wird in Ihr Repository übertragen. Der Name der generierten Datei enthält den Namen der API und die Version.

Sie können auf View on GitHub (In GitHub anzeigen) klicken, um das ausgewählte Repository zu öffnen.

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!