Comment utiliser IBM® App Connect avec GitLab

Versions du produit et de l'API prises en charge

Pour connaître les produits et les versions d'API pris en charge par ce connecteur, consultez la section Configuration requise détaillée sur la page d' assistance IBM.

Se connecter à GitLab

Remplissez les champs de connexion que vous voyez dans la page App Connect Designer Connect > Applications et API (anciennement la page Catalogue ) ou dans l'éditeur de flux. Si nécessaire, travaillez avec votre administrateur pour obtenir ces valeurs GitLab pour obtenir ces valeurs.

GitLab les champs de connexion :

Type d'application

Sélectionnez l'environnement Gitlab auquel vous souhaitez vous connecter :

• GitLab autogéré - (par défaut) : Une instance GitLab que vous avez déployée sur place ou dans le nuage.
• GitLab.com : Géré et administré par GitLab Inc.

Méthode d'autorisation

Sélectionnez la méthode d'autorisation que vous souhaitez utiliser, puis cliquez sur Continuer.

• Fournir un nom d'utilisateur, un mot de passe et les informations d'identification du client (OAUTH 2.0 PASSWORD) - (par défaut)
• Fournir des informations d'identification à App Connect (BASIC)

Indiquez ensuite dans les champs de connexion les valeurs correspondant à l'environnement Gitlab et à la méthode d'autorisation que vous avez choisis :

Type d'autorisation	Champs de connexion	Applicabilité
Utiliser le site web de l'application pour se connecter (OAUTH 2.0 AUTH CODE) (Pour Git Lab.com uniquement)		App Connect
Fournir des informations d'identification à App Connect (BASIC)	Point final URL - (pour GitLab autogéré uniquement)	App Connect et App Connect in containers
	Jeton d'accès personnel
Fournir un nom d'utilisateur, un mot de passe et les informations d'identification du client (OAUTH 2.0 MOT DE PASSE)	Point final URL - (pour GitLab autogéré uniquement)	App Connect et App Connect in containers
	Nom d'utilisateur
	Mot de passe
	ID de client
	Secret client

URL du point de terminaison

Le site URL de l'instance autogérée de Gitlab. Par exemple, https://<hostName>:<port_number>.

• Requis : Vrai

Jeton d'accès personnel

Spécifiez le jeton d'accès personnel pour vous authentifier auprès de l'API GitLab. Pour plus d'informations, voir https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html.

• Requis : Vrai

Nom d'utilisateur

Le nom d'utilisateur pour se connecter à votre compte GitLab

• Requis : Vrai

Mot de passe

Le mot de passe pour vous connecter à votre compte GitLab

• Requis : Vrai

ID de client

Indiquez l'identifiant de l'application créé à l'adresse GitLab. Pour plus d'informations, voir https://docs.gitlab.com/ee/integration/oauth_provider.html.

• Requis : Vrai

Secret client

Spécifiez le secret d'application créé à l'adresse GitLab. Pour plus d'informations, voir https://docs.gitlab.com/ee/integration/oauth_provider.html.

• Requis : Vrai

Pour se connecter à un GitLab à partir de la page Applications et API de App Connect Designer pour la première fois, développez GitLab puis cliquez sur Connecter. Pour plus d'informations, voir Gestion des comptes.

Considérations générales

Avant d'utiliser App Connect Designer avec GitLab prenez note des considérations suivantes :

• (Considération générale) Vous pouvez consulter les listes des événements déclencheurs et des actions disponibles sur la page Applications et API du concepteur App Connect.

  Pour certaines applications, les événements et les actions dépendent de l'environnement et de la prise en charge par le connecteur des événements configurables et de la découverte dynamique des actions. Si l'application prend en charge les événements configurables, un lien Afficher plus d'événements configurables apparaît sous la liste des événements. Si l'application prend en charge la découverte dynamique des actions, un lien Afficher plus apparaît sous la liste des actions.

• (Considération générale) Si vous utilisez plusieurs comptes pour une application, l'ensemble des champs affichés lorsque vous sélectionnez une action pour cette application peut varier d'un compte à l'autre. Dans l'éditeur de flux, certaines applications fournissent toujours un ensemble de champs statiques pour une action. D'autres applications utilisent la découverte dynamique pour récupérer l'ensemble des champs configurés sur l'instance à laquelle vous êtes connecté. Par exemple, si vous avez deux comptes pour deux instances d'une application, le premier compte peut utiliser des paramètres prêts à être utilisés immédiatement. Cependant, le deuxième compte peut être configuré avec des champs personnalisés supplémentaires.

Événements et actions

GitLab événements

Ces événements concernent les modifications apportées à l'application qui déclenchent l'exécution des actions prévues dans le flux.

Afficher plus d'événements configurables : Les événements affichés par défaut sont préconfigurés en utilisant une connectivité optimisée. D'autres éléments sont disponibles après avoir configuré des événements qui peuvent déclencher un flux en interrogeant cette application pour des objets nouveaux ou mis à jour.

Votre flux accomplit ces actions sur cette application.