Accéder au contenu principal Passer au contenu complémentaire

Effectuer un Push d'une version d'API dans GitHub

Liez votre API à un référentiel GitHub et effectuez un Push de votre définition d'API au format OAS/Swagger ou RAML.

Avant de commencer

  • Vous devez avoir un compte et un référentiel GitHub.
  • Votre navigateur doit être supporté par GitHub (comme Internet Explorer 11 n'est plus supporté par GitHub, cette fonctionnalité n'est pas supportée par Talend Cloud API Designer pour IE11).

Procédure

  1. Si votre compte GitHub n'est pas encore lié à votre compte Talend Cloud API Designer, accédez à API Designer settings (Paramètres d'API Designer).
  2. Cliquez sur Link your GitHub account (Lier votre compte GitHub).
    Section GitHub account (Compte GitHub) dans API Designer settings (Paramètres d'API Designer).
  3. Dans la fenêtre qui s'ouvre, connectez-vous à GitHub et cliquez sur Authorize Talend pour autoriser Talend Cloud API Designer à accéder à votre compte GitHub.
    Note InformationsAvertissement : Si vous utilisez Internet Explorer 11, il vous est demandé d'effectuer une mise à niveau vers la dernière version de Microsoft Edge, Google Chrome ou Firefox.

    Votre compte GitHub est à présent lié à votre compte Talend Cloud API Designer et vous pouvez commencer à effectuer des Push de définitions d'API dans GitHub.

  4. Ouvrez la version d'API à pousser vers GitHub.
  5. Cliquez sur Link (Lier) dans le coin supérieur droit.
  6. Dans la section Edit GitHub settings (Modifier les paramètres GitHub), activez l'option et modifiez les champs suivants :
    • Owner
    • Repository
    • Branch (Branche)
    • Path
    • Format
    Dans la liste déroulante Format, vous pouvez choisir d'exporter votre définition avec les extensions Talend ou avec le mode de compatibilité API Gateway.
    Note InformationsRemarque : Si votre API a plusieurs versions, chaque version peut avoir différents paramètres GitHub.
    Section Edit GitHub settings (Modifier les paramètres GitHub) de la vue API Settings (Paramètres d'API).
  7. Une fois vos paramètres sauvegardés, cliquez sur Push.
    Un point vert s'affiche à droite de Push lorsque votre projet contient des modifications n'ayant pas été pushées dans GitHub.
    Capture d'écran du projet avec des modifications dont le push vers GitHub n'a pas été effectué.
  8. Saisissez un message de commit et un tag, si nécessaire, puis cliquez sur Push.
    Un tag doit être unique et doit suivre ces règles :
    • Il ne peut contenir que des caractères alphanumériques et les caractères spéciaux suivants : _, -, . et /.
    • Il ne peut commencer ou finir par un caractère spécial.
    • Il ne peut contenir les modèles de caractères suivants : .., // et /..

Résultats

La version sélectionnée de votre définition d'API est transférée (push) à votre dépôt. Le nom du fichier généré contient le nom et la version de l'API.

Vous pouvez cliquer sur View on GitHub pour ouvrir le dépôt sélectionné.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.