Publica tu Nerdpack

Publica tu Nerdpack, ya sea que esté todavía en desarrollo, listo para probar o estable, para compartirlo con otros.

Actualice su CLI

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

bash

$nr1 update

Comprueba tus licencias

Cuando publicas tu Nerdpack, queda registrado en el catálogo de Observabilidad Instantánea. A partir de ahí, algún usuario podrá suscribir a tu Nerdpack. El usuario suscriptor debe tener:

Acceso a la cuenta que publicó el Nerdpack
Los licencias necesarias para gestionar Nerdpacks

Actualice la versión de su paquete

Solo puedes publicar una versión de paquete en el catálogo de observabilidad Instantánea una vez. Por ejemplo, no puedes publicar dos instancias de la versión 1.0.0. Entonces, cada vez que quieras desplegar una nueva versión de tu código, debes incrementar su versión en el archivo package.json de 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

Sugerencia

Las versiones Nerdpack siguen el control de versiones semántico. Lea la documentación para obtener más información.

Genera un UUID para tu Nerdpack

Si creaste tu Nerdpack desde cero con nr1 create --type nerdpack, entonces tu Nerdpack tiene un identificador único. Busque este identificador en el archivo nr1.json del directorio raíz:

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

nr1.json

Esta ID debe ser única para tu Nerdpack cuando lo publiques en el catálogo. La plataforma rechazará tu Nerdpack si reconoce el ID. Entonces, si clonaste un Nerdpack existente o estás usando código abierto, genera un nuevo UUID:

bash

$nr1 nerdpack:uuid --generate --force

Sugerencia

Lea la documentación nr1 nerdpack:uuid para obtener más información. O vea la página de ayuda nr1 :

bash

$nr1 nerdpack:uuid --help

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

bash

$nr1 nerdpack:publish

Si publicó con éxito su Nerdpack, debería ver algunos resultados exitosos, que incluyen:

bash

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

Este resultado describe el Nerdpack publicado. Primero, indica la identificación del Nerdpack (ab123c45-678d-9012-efg3-45hi6jkl7890). Luego, su versión (1.0.0). Finalmente, su etiqueta de versión (STABLE).

Ya gestionaste el ID y la versión de tu Nerdpack, pero la etiqueta de versión es nueva. Para gestionar las versiones de tu Nerdpack, puedes etiquetarlas con una etiqueta arbitraria. Por ejemplo, si una versión aún está en desarrollo, puede etiquetarla con una etiqueta DEV . Si la versión pasa a una fase de control de calidad, puede etiquetarla con QA. Si está listo para producción, puede etiquetarlo con STABLE.

Sugerencia

Lea nuestra guía de etiquetas para obtener más información.

Emplee la opción -t o --tag para publicar su Nerdpack con una etiqueta:

bash

$nr1 nerdpack:publish --tag DEV

Como vio en el resultado nr1 nerdpack:publish , si no pasa una etiqueta, nr1 aplica la etiqueta STABLE automáticamente. Sin embargo, puedes indicarle que no aplique ninguna etiqueta a una versión con la opción -T o --skip-tag :

bash

$nr1 nerdpack:publish --skip-tag

También puedes realizar un ensayo para cerciorarte de publicar tu Nerdpack de la manera que deseas:

bash

$nr1 nerdpack:publish --dry-run

Una vez que publicaste exitosamente tu Nerdpack, ve a New Relic. Debido a que vas a ver un Nerdpack publicado, en lugar de uno servido localmente, no necesitas pasar la cadena de consulta ?nerdpacks=local .

Ir a + Integrations & Agents. Ya sea que publicó una aplicación New Relic o una visualización personalizada, encontrará su proyecto aquí.

Encuentra tu Nerdpack publicado usando el filtro de aplicaciones o la barra de búsqueda.

Sugerencia

Sólo los Nerdpacks con versiones de etiqueta se muestran en Observabilidad instantánea. Entonces, si publicaste sin una etiqueta o eliminaste una etiqueta de tu Nerdpack publicado, no lo verás en el catálogo.

Resuelve problemas al acceder a tu Nerdpack publicado

A veces, cuando publicas tu Nerdpack, puedes encontrarte con problemas. Ya sea que no puedas publicar tu Nerdpack debido a algún problema con tu código o no puedas encontrar tu Nerdpack en Observabilidad instantánea, considera algunas soluciones comunes para resolver estos problemas.

Depura tu comando

Cuando intentes publicar tu Nerdpack, lee atentamente el resultado de tu comando nr1 . Es posible que reciba resultados exitosos, que incluyen:

bash

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

Sin embargo, el resultado puede mostrar algunos errores en su Nerdpack. Por ejemplo:

bash

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

También puede ayudarlo a ver resultados más detallados. Emplee el comando --verbose para mostrar más contenido:

bash

$nr1 nerdpack:publish --verbose

Revela tu información Nerdpack publicada

Si no encuentra su Nerdpack en New Relic, es posible que no esté etiqueta. Recuerde, al menos una versión de su Nerdpack publicado debe tener una etiqueta para que se muestre en la página de Apps . Consulta más información sobre tu Nerdpack publicado con 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

En este ejemplo, hay una versión publicada, pero no es etiqueta. Puedes etiquetar una versión publicada con:

bash

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

Ahora, si actualiza la página de su browser , debería ver su Nerdpack en Apps.

Sugerencia

Lea nuestra documentación nr1 nerdpack:tag para obtener más información.

Consulta tu perfil local

Con nr1, puedes establecer un perfil predeterminado de New Relic. Este perfil se emplea para todos los comandos a menos que se especifique lo contrario con la opción --profile del comando. Cuando publicas tu Nerdpack, solo el usuario que pueda acceder a tu cuenta podrá ver tu Nerdpack publicado.

Entonces, si no encuentras tu Nerdpack en New Relic pero sabes que está publicado, compara tu perfil local con el perfil que estás usando en el browser para cerciorarte de que sean iguales.

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

Publica tu Nerdpack

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

Comprueba tus licencias

Actualice la versión de su paquete

Sugerencia

Genera un UUID para tu Nerdpack

Sugerencia