Guide d'intégration de Pivotal Cloud Foundry

La plateforme Cloud-Native de Pivotal stimule l'innovation logicielle pour de nombreuses marques parmi les plus admirées au monde. Avec des millions de développeurs dans des communautés du monde entier, la technologie Pivotal touche des milliards d'utilisateurs chaque jour. Après avoir façonné la culture de développement logiciel des entreprises les plus valorisées de la Silicon Valley pendant plus d'une décennie, Pivotal est aujourd'hui à la tête d'un mouvement technologique mondial qui transforme la manière dont le monde crée des logiciels.

Cette intégration permet le provisionnement des équipes, des utilisateurs, des services et des politiques d'escalade de PagerDuty .

Dans PagerDuty

1. Accéder à Intégrations →   Clés d'accès API .
2. Sur la page d’accès à l’API, cliquez sur +Créer une nouvelle clé API .
3. Dans la boîte de dialogue qui apparaît, vous serez invité à saisir un Description pour votre clé. Laissez l'option Lecture seule décoché pour créer une clé d'accès complète.
4. Une fois vos options renseignées, cliquez sur Créer une clé .
5. Une fois que vous avez cliqué sur Créer une clé, vous verrez une boîte de dialogue affichant votre clé et confirmant les options que vous avez renseignées à l’étape précédente. Assurez-vous de copier cette clé dans toute application qui en a besoin maintenant, car vous n'aurez plus accès à la clé après cette étape. Si vous perdez une clé que vous avez créée précédemment et que vous avez besoin d'y accéder à nouveau, vous devez supprimer la clé et en créer une nouvelle. Cliquez sur Fermer une fois que vous avez copié avec succès votre clé.
   
6. Une fois créée, vous verrez votre clé apparaître dans la liste des clés sur la page Accès API, avec le versionnage noté.

Dans Pivotal Cloud Foundry (PCF)

1. Téléchargez le fichier produit à partir de Réseau Pivotal .
2. Cliquez Importer un produit pour télécharger le fichier produit sur le Responsable des opérations PCF Tableau de bord d'installation.
   
3. Cliquez sur + icône à côté de la tuile PagerDuty téléchargée pour ajouter la tuile à votre zone de préparation.
   
4. Cliquez sur la tuile PagerDuty pour accéder à l'écran de configuration.
5. De la Paramètres onglet de votre mosaïque PagerDuty , cliquez sur Attribuer des AZ et des réseaux .
6. Sélectionnez votre Zones de disponibilité et Réseau , où PagerDuty doit s'exécuter, puis cliquez sur Sauvegarder .
7. De la Paramètres onglet, cliquez Intégration de PagerDuty , choisissez le point de terminaison de l'API REST PagerDuty en fonction de la région, à savoir, modifiez l'option par défaut pour le compte PagerDuty basé dans l'UE, puis cliquez sur Sauvegarder .
8. De la Paramètres onglet, cliquez sur Intégration utilisateur , entrez les informations d'identification d'un administrateur PCF UAA et cliquez sur Sauvegarder .
9. Pour provisionner des équipes et des utilisateurs, cliquez sur Valeurs par défaut et personnalisations de la Paramètres languette.
10. Entrez éventuellement Préfixe pour le nom de l'équipe . Lors de l'ajout d'un préfixe à ce champ, l'intégration utilisera ce préfixe avec le nom de l'organisation et de l'espace dans PCF pour provisionner de nouvelles équipes et leurs politiques d'escalade correspondantes dans PagerDuty (par exemple, préfixeORG:SPACE).
11. Vérifier Provisionner automatiquement les utilisateurs de l'espace pour provisionner les utilisateurs dans l'espace lorsque vous liez le service PagerDuty à votre application. Si vous souhaitez provisionner manuellement les utilisateurs, laissez cette option décochée et suivez les instructions ci-dessous.
12. Vérifier Fournir une équipe PagerDuty unique pour l'organisation pour avoir une équipe pour votre organisation. Si vous ne cochez pas cette case, vous pourrez avoir des équipes uniques pour chaque espace.
13. Cliquez Sauvegarder .
14. Cliquez Tableau de bord d'installation dans le coin supérieur gauche de l'écran pour quitter la configuration des tuiles et revenir à votre tableau de bord Ops Manager.
15. Cliquez sur Examiner les modifications en attente .
16. Cliquez Appliquer les modifications pour déployer la tuile.
    
17. En utilisant le Interface de ligne de commande PCF , connectez-vous à votre déploiement et ciblez un ORG et ESPACE . Le point de terminaison de connexion peut être trouvé dans votre Gestionnaire d'applications PCF sous Outils .

     $ cf connexion $ cf cible -o<ORG> -s<SPACE> 

18. Répertoriez les SERVICES du marché et localisez le SERVICE PagerDuty .

     Marché $ cf 

19. Créez une instance du SERVICE PagerDuty , en veillant à remplacer <SERVICE_NAME> avec votre nom de service préféré.

     $ cf create-service PagerDutyService PagerDutyPlan<SERVICE_NAME> 

20. Liez l'instance SERVICE PagerDuty à une application, en veillant à remplacer <APP_NAME> avec le nom de votre APP et <SERVICE_NAME> avec le nom de votre SERVICE. L'intégration fournira automatiquement une politique et un service d'escalade PagerDuty une fois que vous aurez lié l'APPLICATION à votre nouveau SERVICE.

     $ cf service de liaison<APP_NAME><SERVICE_NAME> 

21. Remettre en scène l'APP pour que la liaison SERVICE prenne effet, en veillant à remplacer <APP_NAME> avec le nom de votre APP.

     $ cf restage<APP_NAME> 

22. Vous avez maintenant lié avec succès votre application et provisionné une nouvelle politique de service et d'escalade dans PagerDuty! Les services provisionnés et les politiques d'escalade suivent la convention de dénomination SPACE:APP_NAME.

Provisionnement d'utilisateurs supplémentaires

Si vous ne configurez pas l'intégration dans PCF Ops Manager pour provisionner automatiquement les utilisateurs Space lors de la liaison du service à votre application ou si vous devez ajouter des utilisateurs après la liaison, le provisionnement des utilisateurs peut également être effectué de deux manières :

1. Utiliser les utilisateurs existants qui sont déjà membres de votre espace PCF
2. Saisie manuelle des utilisateurs

Si un utilisateur ne possède pas de compte existant dans PagerDuty et qu'il est ajouté pendant le processus de provisionnement des utilisateurs PCF, l'utilisateur utilisera une licence PagerDuty . Les utilisateurs créés via le provisionnement dériveront leurs rôles d'équipe de leur rôle de base PagerDuty . Si un utilisateur existe déjà dans PagerDuty, les rôles de base et d'équipe de l'utilisateur ne changeront pas. De plus, si vous modifiez vos autorisations d'utilisateur PCF, vous devrez mettre à jour manuellement les rôles dans PagerDuty.

Provisionnement des utilisateurs existants dans votre espace Pivotal

Vous pouvez provisionner des utilisateurs en utilisant les membres existants de votre espace PCF. Les rôles sont actuellement mappés comme suit :

Rôle pivot	Rôle de PagerDuty
Gestionnaire d'espace	Directeur
Développeur d'espace	Répondant
Auditeur spatial	Observateur

En utilisant le Interface de ligne de commande PCF , mettez à jour votre service avec le JSON suivant : {« provision_space_users » : true}, en veillant à remplacer <SERVICE_NAME> avec votre service existant :

 $ cf service de mise à jour<SERVICE_NAME> -c '{'provision_space_users':true}' 

Provisionnement manuel des utilisateurs

Vous pouvez également saisir manuellement des utilisateurs dans un fichier JSON pour provisionner plusieurs utilisateurs. Les champs obligatoires sont : e-mail, nom et Rôle de PagerDuty :

 { 'utilisateurs': [ { 'email': 'john@test.com' , 'nom': 'John Doe', 'rôle': 'utilisateur' }, { 'email': jane@test.com', 'nom': 'Jane Doe', 'rôle': 'équipe_répondeur' } ] } 

En utilisant le Interface de ligne de commande PCF , mettez à jour votre service avec le chemin vers votre fichier JSON, en veillant à remplacer <SERVICE_NAME> avec votre service existant :

 $ cf service de mise à jour<SERVICE_NAME> -c  /tmp/utilisateurs.json 

FAQ

Cette intégration déclenche-t-elle des incidents dans PagerDuty?

Non, cette intégration fournit uniquement des équipes, des utilisateurs, des services et des politiques d'escalade à PagerDuty et ne gère pas actuellement les incidents.

Où puis-je trouver de la documentation sur d’autres produits Pivotal qui s’intègrent à PagerDuty?

Le service PagerDuty fournit des liens vers la documentation d'un certain nombre de produits PCF populaires dans le SERVICES VCAP variables d'environnement de toute application liée au service PagerDuty .

Si j'ajoute un utilisateur à mon espace PCF après avoir lié le service PagerDuty , l'utilisateur sera-t-il automatiquement provisionné dans PagerDuty ?

Non, cependant, vous pouvez relancer manuellement le processus de provisionnement en exécutant à nouveau la commande update-service :

 $ cf service de mise à jour<SERVICE_NAME> -c '{'provision_space_users':true}'