Intégrations des retours d'informations sur les pipelines

Les sections suivantes expliquent comment intégrer les marqueurs de mise en production de la fonction de retour d'informations sur les pipelines à votre pipeline de CI/CD.

API Mises en production

Notre interface de programmation d'applications (API) « Releases » API fournit des points de terminaison permettant de créer, de lire, de mettre à jour et de supprimer une version. Les marqueurs de version peuvent être créés avec quatre portées différentes:

  • Global
  • Perspective d'application
  • Service
  • Service dans une perspective d'application

Dans l'exemple suivant, une commande curl est utilisée pour créer un nouveau marqueur de mise en production globale nommé My First Global Release à un moment donné (sous forme d'horodatage UNIX en millisecondes) :

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
        \"name\": \"My First Global Release\",
        \"start\": 1601890420046,
}"
Remarque : la valeur « start » doit être un horodatage exprimé en millisecondes.

Ce marqueur de version est affiché sur toutes les pages de tableau de bord pour Applications, Services et Noeuds finaux.

Pour créer un marqueur de mise en production basé sur une perspective d'application existante, ajoutez les applications avec une liste des noms d'application au corps de requête.

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
        \"name\": \"My First Application Scoped Release\",
        \"start\": 1601890420046,
        \"applications\": [
      {
        \"name\": \"My Application\" 
      }
    ]
}"

Ce marqueur de version est affiché sur le tableau de bord de l'application Ma demande.

Le fragment ci-dessous montre comment créer un marqueur d'édition pour un service donné.

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
        \"name\": \"My First Service Scoped Release\",
        \"start\": 1601890420046,
        \"services\": [
      {
        \"name\": "\"my-service\"
      }
    ]
}"

Ce marqueur d'édition de portée de service est affiché sur les tableaux de bord du service Mon-service et de tous les tableaux de bord d'application qui contiennent le service Mon-service. Un marqueur de mise en production de portée Service peut également être créé pour un ensemble donné d'applications.

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
        \"name\": \"My First Service Scoped Release\",
        \"start\": 1601890420046,
        \"services\": [
      {
        \"name\": \"my-service\",
        \"scopedTo\": {
          \"applications\": [
            {
              \"name\": \"My Application\"
            }
          ]
        }
      }
    ]
}"

Le marqueur de mise en production donné sera affiché uniquement pour le service my-service dans l'application My application, mais pas pour les autres services de l'application.

Remarque : le jeton « API » utilisé nécessite l'autorisation « Configuration des versions ».

Intégrations

CircleCI

L'orb « Pipeline Feedback » d' Instana vous permet de créer de nouvelles versions et de suivre la dernière version en date, le tout depuis vos workflows CircleCI.

Concourse

La ressource « Pipeline Feedback » d' Instana vous permet de créer de nouvelles versions et de suivre la dernière version en date, le tout depuis votre pipeline CI Concourse.

Harness

Harness a mis en place une intégration de vérification continue avec Instana afin de surveiller vos déploiements et vos applications en production.

Jenkins

Sinon, nous proposons un plug-in Jenkins pour permettre une intégration plus harmonieuse avec vos outils CI/CD existants. Le plug-in et d'autres informations sont disponibles sur le site GitHub.

Déploiements BOSH

Remarque : pour accéder à cette fonctionnalité, vous devez disposer de la version 1.166.1 ou ultérieure de la tuile « Instana Microservices Application Monitoring for Pivotal Platform ».

Important : La fonctionnalité Pipeline Feedback est actuellement à l'état expérimental. Dans les fondations comportant de nombreuses instances de service, dont chacune dispose généralement d'un déploiement BOSH dédié, il peut devenir un peu trop bavard. Dites-nous ce que vous en pensez !

La tuile « Instana » détecte automatiquement les déploiements BOSH exécutés sur la plateforme Pivotal Platform. Dans le cadre de la fonctionnalité «Pipeline Feedback» d' Instana, ces déploiements sont signalés comme releases.

Pour plus d'informations, consultez notre documentation sur les commentaires relatifs au pipeline.

Pour activer la fonctionnalité « Pipeline Feedback for BOSH deployments », activez l'option « Agent automatic configurations > [Experimental] Pipeline Feedback for BOSH » dans les paramètres de la vignette « Instana » sur OpsManager.

Veillez à configurer correctement les paramètres suivants :

  • Connexion de back-end > URL de noeud final d'API : doit pointer vers votre unité locataire dans Instana.
  • Connexion au backend > Jeton « API » : nécessite un jeton « API » disposant au minimum de Configuration of releases l'autorisation. Pour plus d'informations, consultez notre documentation sur les jetons « API ».

Pour annuler la modification, sélectionnez Apply Changes dans OpsManager pour la tuile VMware Tanzu Application Service for VMs (anciennement connu sous le nom de PAS, ou Pivotal Application Service) ou VMware Tanzu Kubernetes Grid (anciennement connu sous le nom de PKS, ou Pivotal Container Service).