Etiqueta la versión de lanzamiento de tu Nerdpack

Etiqueta tus versiones de Nerdpack para rastrearlas y suscribirte a ellas. Desetiqueta las versiones para evitar la subscripción u ocultar Nerdpacks del catálogo.

Actualice su CLI

Antes de ejecutar cualquier comando, cerciorar de tener la última versión de la CLI:

bash

$nr1 update

Comprueba tus licencias

Para etiquetar una versión Nerdpack, necesitas:

Acceso a la cuenta que lo publicó
Los licencias necesarias para gestionar Nerdpacks.

Publica tu Nerdpack

Debes publicar los Nerdpacks que crees antes de poder etiquetarlos.

Etiquetar una versión

Una vez que publicaste una versión de Nerdpack en el catálogo de la aplicación New Relic , puedes etiquetarla con la CLI nr1.

En la carpeta raíz de tu Nerdpack, ejecuta nr1 nerdpack:tag:

bash

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

Aquí, etiqueta la versión 1.0.0 como DEV.

Ahora, usted y otros usuarios de su cuenta pueden usar esta etiqueta:

Ves la etiqueta como una opción para suscribirte cuando agregas el Nerdpack a tu cuenta.
Si se suscribe a la etiqueta DEV y se actualiza más tarde (por ejemplo, DEV se aplica a la versión 1.0.1 ), se actualizará automáticamente a la nueva versión sin tener que suscribir nuevamente.

Importante

Una de las características de las versiones de lanzamiento de etiquetas es que los usuarios que están suscritos a una etiqueta obtienen actualizaciones automáticamente cuando esa etiqueta se usa para otra versión. Esto significa que si un usuario está probando una versión, digamos 1.0.0, y usted aplica esa misma etiqueta a otra versión, digamos 1.0.1, ese usuario verá la versión 1.0.1 en su cuenta y ya no podrá acceder a la Nerdpack que estaban probando antes. Muchas veces, este es el comportamiento esperado, pero cerciorar de considerar este efecto secundario cuando use la etiqueta.

Vea la información de registro de su 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

Este resultado confirma su etiqueta DEV en la versión 1.0.0.

Desetiquetar una versión

A medida que creas más versiones de tu Nerdpack, puedes actualizar tu etiqueta a versiones más nuevas. Sin embargo, también puedes eliminar una etiqueta de tu Nerdpack con nr1.

Desde el directorio raíz de su Nerdpack, vea su información de registro:

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

Aquí verá que la versión 1.0.0 no tiene etiqueta, la versión 1.0.1 tiene dos etiquetas, BETA y STABLE, y la versión 2.0.0 tiene una etiqueta, DEV.

Elimina la etiqueta BETA de tus versiones Nerdpack:

bash

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

Verifica que la etiqueta fue eliminada de tu 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

Resolver problemas con la etiqueta a versión Nerdpack

A veces, cuando etiqueta una versión Nerdpack, puede encontrar problemas. Ya sea que no puedas etiquetar tu Nerdpack o no puedas desetiquetarlo, considera algunas soluciones comunes para resolver estos problemas.

Publica tu Nerdpack

Si intentas etiquetar tu Nerdpack sin publicarlo primero, obtendrás un error:

bash

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

Este mensaje de error no dice mucho, pero puedes usar la opción --verbose para ver más información:

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'
}

Este mensaje de error más detallado muestra GraphQL que se ejecuta detrás de escena para nr1 nerdpack:tag. La parte importante del mensaje aquí es:

bash

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

El directorio dist se crea cuando publicas tu aplicación. Entonces, como aún no se publicó, este directorio no existe y nr1 recurre a package.json para buscar detalles sobre tu Nerdpack. Pero, debido a que el UUID en su package.json no está en el registro de New Relic, el comando falló.

Entonces, antes de etiquetar sus versiones, publíquelas en el registro:

bash

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

Sugerencia

¡Recuerda que también puedes etiquetar una versión al mismo tiempo que la implementas!

bash

$nr1 nerdpack:publish --tag=DEV

Dar de baja del Nerdpack

Sólo puedes eliminar etiquetas que no tengan suscriptores. Si intentas eliminar una etiqueta a la que el usuario está suscrito, obtendrás un error:

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.

En este caso, verifica si estás suscrito al 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

Esto muestra que estás suscrito a MyAwesomeNerdpack. Cancelar la subscripción y luego intentar eliminar la etiqueta DEV nuevamente:

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

Te ofrecemos esta traducción automática para facilitar la lectura.

Etiqueta la versión de lanzamiento de tu Nerdpack

Actualice su CLI.css-21sua1{background:none;border:none;width:0;padding:0;}

Comprueba tus licencias

Publica tu Nerdpack

Etiquetar una versión

Importante

Desetiquetar una versión

Resolver problemas con la etiqueta a versión Nerdpack

Publica tu Nerdpack

Sugerencia

Dar de baja del Nerdpack

Actualice su CLI