étiquetez la version sortie de votre Nerdpack

étiquetez vos versions Nerdpack pour les suivre et vous y abonner. Débalisez les versions pour empêcher l'abonnement ou masquer les Nerdpacks du catalogue.

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

Pour tag une version Nerdpack, il vous faut :

Accéder au compte qui l'a publié
Les autorisations nécessaires pour gérer les Nerdpacks.

Publiez votre Nerdpack

Vous devez publier les Nerdpacks que vous créez avant de pouvoir les tag .

marquer une version

Après avoir publié une version Nerdpack dans le catalogue d'applications New Relic, vous pouvez la tag avec la CLI nr1.

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

bash

$nr1 nerdpack:tag --tag=DEV
✔  Tagged ab123c45-678d-9012-efg3-45hi6jkl7890 version 1.0.0 as DEV.

Ici, vous marquez la version 1.0.0 comme DEV.

Désormais, vous et les autres utilisateurs de votre compte pouvez utiliser cette tag:

Vous voyez le tag comme une option d'abonnement lorsque vous ajoutez le Nerdpack à votre compte
Si vous vous abonnez à la tag DEV et qu'elle est mise à jour ultérieurement (par exemple, si DEV est appliqué à la version 1.0.1), vous serez automatiquement mis à niveau vers la nouvelle version sans avoir à vous abonner à nouveau.

Important

L'une des fonctionnalités des versions de sortie de balise est que les utilisateurs abonnés à une tag reçoivent automatiquement des mises à jour lorsque cette tag est utilisée pour une autre version. Cela signifie que si un utilisateur teste une version, disons 1.0.0, et que vous appliquez cette même tag à une autre version, disons 1.0.1, cet utilisateur verra la version 1.0.1 dans son compte et il ne pourra plus accéder au Nerdpack qu'il testait auparavant. Souvent, c'est le comportement attendu, mais assurez-vous de prendre en compte cet effet secondaire lorsque vous utilisez la balise.

Consultez les informations de registre de votre Nerdpack :

bash

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

Cette sortie confirme votre tag DEV sur la version 1.0.0.

Supprimer l'étiquette d'une version

Au fur et à mesure que vous créez davantage de versions de votre Nerdpack, vous pouvez mettre à jour votre balise vers des versions plus récentes. Cependant, vous pouvez également supprimer une tag de votre Nerdpack avec nr1.

Depuis le répertoire racine de votre Nerdpack, affichez les informations de votre registre :

bash

$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 1.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 1
Version  Date               Tags
-------  -----------------  ----
2.0.0    a few seconds ago  DEV
1.0.1    8 minutes ago      BETA, STABLE
1.0.0    6 hours ago

Ici, vous voyez que la version 1.0.0 n'a pas de balise, la version 1.0.1 a deux balises, BETA et STABLE, et la version 2.0.0 a une tag, DEV.

Supprimez la tag BETA de vos versions Nerdpack :

bash

$nr1 nerdpack:untag --tag=BETA
✔  Removed nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 tag BETA.

Vérifiez que l' tag a été supprimée de votre Nerdpack :

bash

$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 1.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 1
Version  Date            Tags
-------  --------------  ----
2.0.0    5 minutes ago   DEV
1.0.1    13 minutes ago  STABLE
1.0.0    6 hours ago

Résoudre les problèmes avec la version tag a Nerdpack

Parfois, lorsque vous tag à une version Nerdpack, vous pouvez rencontrer des problèmes. Que vous ne puissiez pas tag votre Nerdpack ou que vous ne puissiez pas le désétiqueter, envisagez certaines solutions courantes pour résoudre ces problèmes.

Publiez votre Nerdpack

Si vous essayez de tagger votre Nerdpack sans le publier au préalable, vous obtiendrez une erreur :

bash

$nr1 nerdpack:tag --tag=DEV
›   Error: A downstream error occurred.

Ce message d'erreur ne dit pas grand chose, mais vous pouvez utiliser l'option --verbose pour voir plus d'informations :

bash

$nr1 nerdpack:tag --tag=DEV --verbose
init version: @oclif/command@1.8.0 argv: [ '--tag=DEV', '--verbose', [length]: 2 ]
dist/metadata.json does not exist. package.json will be used instead.
Using profile account-1234567
Request: POST https://api.newrelic.com/graphql
Data: mutation 
                nerdpackTagVersion(
                    nerdpackId: "ab123c45-678d-9012-efg3-45hi6jkl7890",
                    versionTag: 
                        tag: "DEV",
                        version: "1.0.0"
                    }
                ) 
                    nerdpackId
                    tags
                    version
                }
            }
Headers: 
  'API-Key': '<YOU USER KEY>',
  'Content-Type': 'application/graphql'
}

Ce message d'erreur plus détaillé montre le GraphQL qui s'exécute en coulisses pour nr1 nerdpack:tag. La partie importante du message ici est :

bash

dist/metadata.json does not exist. package.json will be used instead.

Le répertoire dist est créé lorsque vous publiez votre application. Donc, comme il n'a pas encore été publié, ce répertoire n'existe pas et nr1 revient à package.json pour rechercher des détails sur votre Nerdpack. Mais, comme l'UUID dans votre package.json n'est pas dans le registre New Relic, la commande a échoué.

Donc, avant d’ tag vos versions, publiez-les dans le registre :

bash

$nr1 nerdpack:publish
$nr1 nerdpack:tag --tag=DEV

Conseil

N'oubliez pas que vous pouvez également tag une version en même temps que vous la déployez !

bash

$nr1 nerdpack:publish --tag=DEV

Se désabonner du Nerdpack

Vous ne pouvez supprimer que les tags qui n'ont pas d'abonnés. Si vous essayez de supprimer une tag à laquelle l'utilisateur est abonné, vous obtiendrez une erreur :

bash

$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 2.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 3
Version  Date         Tags
-------  -----------  ----
2.0.0    an hour ago  DEV
1.0.1    an hour ago
1.0.0    6 hours ago
$nr1 nerdpack:untag -t DEV
›   Error: A downstream error occurred.

Dans ce cas, vérifiez si vous êtes abonné au Nerdpack :

bash

$nr1 subscription:list
Listing subscribed deployed nerdpacks on your account:
Version  UUID                                  Name               Date         User
-------  ------------------------------------  -----------------  -----------  ----------
2.0.0    ab123c45-678d-9012-efg3-45hi6jkl7890  MyAwesomeNerdpack  an hour ago  1000383529

Cela montre que vous êtes abonné à MyAwesomeNerdpack. Désabonnez-vous, puis essayez à nouveau de supprimer la tag DEV :

bash

$nr1 nerdpack:unsubscribe
Unsubscribed account 1234567 from the nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 on the DEV channel.
$nr1 nerdpack:untag --tag=DEV
✔  Removed nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 tag DEV.
$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 2.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 3
Version  Date         Tags
-------  -----------  ----
2.0.0    an hour ago
1.0.1    an hour ago
1.0.0    6 hours ago

Cette traduction automatique est fournie pour votre commodité.

étiquetez la version sortie de votre Nerdpack

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

Vérifiez vos autorisations

Publiez votre Nerdpack

marquer une version

Important

Supprimer l'étiquette d'une version

Résoudre les problèmes avec la version tag a Nerdpack

Publiez votre Nerdpack

Conseil

Se désabonner du Nerdpack

Mettez à jour votre CLI