Publiez votre Nerdpack

Publiez votre Nerdpack, qu'il soit encore en développement, prêt à être testé ou stable, pour le partager avec d'autres.

Mettez à jour votre CLI

Avant d’exécuter des commandes, assurez-vous que vous disposez de la dernière version de la CLI :

bash

$nr1 update

Vérifiez vos autorisations

Lorsque vous publiez votre Nerdpack, il est enregistré dans le catalogue Instant Observability. À partir de là, certains utilisateurs peuvent s'abonner à votre Nerdpack. L'utilisateur abonné doit avoir :

Accès au compte qui a publié le Nerdpack
Les autorisations nécessaires pour gérer les Nerdpacks

Mettez à jour la version de votre package

Vous ne pouvez publier qu'une seule fois une version de package dans le catalogue Instant Observability . Par exemple, vous ne pouvez pas publier deux instances de la version 1.0.0. Ainsi, chaque fois que vous souhaitez déployer une nouvelle version de votre code, vous devez incrémenter sa version dans le fichier package.json du Nerdpack :

{
  "private": true,
  "name": "demo-app",
  "version": "1.0.0",
  "scripts": {
    "start": "nr1 nerdpack:serve",
    "test": "exit 0"
  },
  "nr1": {
    "uuid": "ab123c45-678d-9012-efg3-45hi6jkl7890"
  },
  "dependencies": {
    "prop-types": "^15.6.2",
    "react": "^16.6.3",
    "react-dom": "^16.6.3"
  },
  "browserslist": ["last 2 versions", "not ie < 11", "not dead"]
}

package.json

Conseil

Les versions Nerdpack suivent le versionnage sémantique. Lisez la documentation pour en savoir plus.

Générer un UUID pour votre Nerdpack

Si vous avez construit votre Nerdpack à partir de zéro avec nr1 create --type nerdpack, alors votre Nerdpack a un identifiant unique. Recherchez cet identifiant dans le fichier nr1.json du répertoire racine :

{
  "schemaType": "NERDPACK",
  "id": "ab123c45-678d-9012-efg3-45hi6jkl7890",
  "displayName": "DemoApp",
  "description": "Nerdpack demo-app"
}

nr1.json

Cet identifiant doit être unique à votre Nerdpack lorsque vous le publiez dans le catalogue. La plateforme rejettera votre Nerdpack si elle reconnaît l'ID. Donc, si vous avez cloné un Nerdpack existant ou si vous utilisez un code open source, générez un nouvel UUID :

bash

$nr1 nerdpack:uuid --generate --force

Conseil

Lisez la documentation nr1 nerdpack:uuid pour en savoir plus. Ou, consultez la page d'aide nr1 :

bash

$nr1 nerdpack:uuid --help

Dans le dossier racine de votre Nerdpack, exécutez nr1 nerdpack:publish:

bash

$nr1 nerdpack:publish

Si vous avez publié avec succès votre Nerdpack, vous devriez voir des résultats positifs, notamment :

bash

✔  Nerdpack published successfully!
✔  Tagged ab123c45-678d-9012-efg3-45hi6jkl7890 version 1.0.0 as STABLE.

Cette sortie décrit le Nerdpack publié. Tout d'abord, il indique l'ID du Nerdpack (ab123c45-678d-9012-efg3-45hi6jkl7890). Ensuite, sa version (1.0.0). Enfin, sa tag version (STABLE).

Vous avez déjà géré l'ID et la version de votre Nerdpack, mais la tag de version est nouvelle. Pour gérer les versions de votre Nerdpack, vous pouvez les tag avec une tag arbitraire. Par exemple, si une version est encore en développement, vous pouvez la tag avec une tag DEV. Si la version passe à une phase d'assurance qualité, vous pouvez la tag avec QA. S'il est prêt pour la production, vous pouvez l' tag avec STABLE.

Conseil

Lisez notre guide des balises pour en savoir plus.

Utilisez l'option -t ou --tag pour publier votre Nerdpack avec un tag :

bash

$nr1 nerdpack:publish --tag DEV

Comme vous l'avez vu dans la sortie nr1 nerdpack:publish, si vous ne transmettez pas de tag, nr1 applique automatiquement la tag STABLE. Cependant, vous pouvez lui indiquer de ne pas appliquer de balise à une sortie avec l'option -T ou --skip-tag :

bash

$nr1 nerdpack:publish --skip-tag

Vous pouvez également effectuer un essai à blanc pour vous assurer de publier votre Nerdpack comme vous le souhaitez :

bash

$nr1 nerdpack:publish --dry-run

Une fois que vous avez publié avec succès votre Nerdpack, accédez à New Relic. Étant donné que vous allez consulter un Nerdpack publié plutôt qu'un Nerdpack diffusé localement, vous n'avez pas besoin de transmettre la chaîne de requête ?nerdpacks=local .

Allez dans + Integrations & Agents. Que vous ayez publié une application New Relic ou une visualisation personnalisée, vous trouverez votre projet ici.

Trouvez votre Nerdpack publié en utilisant le filtre des applications ou la barre de recherche.

Conseil

Seuls les Nerdpacks avec des versions de balises sont affichés dans Instant Observability. Donc, si vous avez publié sans tag ou supprimé un tag de votre Nerdpack publié, vous ne le verrez pas dans le catalogue.

Résoudre les problèmes d'accès à votre Nerdpack publié

Parfois, lorsque vous publiez votre Nerdpack, vous pouvez rencontrer des problèmes. Que vous ne puissiez pas publier votre Nerdpack en raison d'un problème avec votre code ou que vous ne trouviez pas votre Nerdpack dans Instant Observability, envisagez certaines solutions courantes pour résoudre ces problèmes.

Déboguer votre commande

Lorsque vous essayez de publier votre Nerdpack, lisez attentivement la sortie de votre commande nr1 . Vous pouvez recevoir des résultats de réussite, notamment :

bash

✔  Nerdpack published successfully!
✔  Tagged ab123c45-678d-9012-efg3-45hi6jkl7890 version 1.0.0 as STABLE.

Cependant, la sortie peut afficher quelques erreurs dans votre Nerdpack à la place. Par exemple:

bash

Publishing Nerdpack DemoApp (ab123c45-678d-9012-efg3-45hi6jkl7890)
›   Error: There is already a Nerdpack with given id & version.
›   Code: 409

Cela peut également vous aider à visualiser une sortie plus détaillée. Utilisez la commande --verbose pour afficher plus de contenu :

bash

$nr1 nerdpack:publish --verbose

Révélez vos informations Nerdpack publiées

Si vous ne trouvez pas votre Nerdpack dans New Relic, il se peut qu'il ne soit pas étiqueté. N'oubliez pas qu'au moins une version de votre Nerdpack publié doit avoir une tag pour qu'elle s'affiche sur la page Apps . Voir plus d'informations sur votre Nerdpack publié avec nr1 nerdpack:info:

bash

$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 3014918
Local version: 1.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 1
Version  Date         Tags
-------  -----------  ----
1.0.0    3 hours ago

Dans cet exemple, il existe une version publiée, mais ce n'est pas une balise. Vous pouvez tag une version publiée avec :

bash

$nr1 nerdpack:tag --from-version=1.0.0 --tag=DEV

Maintenant, si vous actualisez la page de votre navigateur, vous devriez voir votre Nerdpack dans Apps.

Conseil

Lisez notre documentation nr1 nerdpack:tag pour en savoir plus.

Vérifiez votre profil local

Avec nr1, vous pouvez définir un profil New Relic par défaut. Ce profil est utilisé pour toutes les commandes, sauf indication contraire avec l'option --profile de la commande. Lorsque vous publiez votre Nerdpack, seul l'utilisateur qui peut accéder à votre compte peut voir votre Nerdpack publié.

Donc, si vous ne trouvez pas votre Nerdpack dans New Relic mais que vous savez qu'il est publié, comparez votre profil local avec le profil que vous utilisez dans le navigateur pour vous assurer qu'ils sont identiques.

Cette traduction automatique est fournie pour votre commodité.

Publiez votre Nerdpack

Mettez à jour votre CLI.css-21sua1{background:none;border:none;width:0;padding:0;}

Vérifiez vos autorisations

Mettez à jour la version de votre package

Conseil

Générer un UUID pour votre Nerdpack

Conseil