Sugerencia
Esta lección es parte de un curso que le muestra cómo crear una aplicación New Relic desde cero. Si aún no lo hiciste, consulta la descripción general.
Cada lección del curso se basa en la anterior, así que cerciorar de completar la última lección, Describe tu aplicación para el catálogo, antes de comenzar esta.
En la última lección, creó información de catálogo para la aplicación Prueba A/B que estuvo creando a lo largo de este curso. Ahora es el momento de publicar su aplicación en el catálogo de observabilidad instantánea y enviar esos detalles del catálogo.
Versiones y etiqueta
La publicación de una aplicación requiere dos datos clave:
- versión
- etiqueta
La versión de una aplicación identifica el código que contiene y se almacena en el archivo package.json de nivel raíz de Nerdpack. Cada vez que modifiques el código en tu Nerdpack y estés listo para publicarlo, actualizarás la versión en package.json. Por ejemplo, si corrige algunos errores en la primera versión principal del código de su aplicación, puede publicar los cambios en la versión 1.0.1.
La etiqueta de la versión de una aplicación describe su estado. Por ejemplo, la versión 0.0.1 de una aplicación en desarrollo podría publicar con una etiqueta DEV para indicar que está en desarrollo.
Sugerencia
Existen algunas reglas que rigen cómo se puede usar la etiqueta y puedes leer sobre ellas en nuestra documentación sobre etiquetas.
Publica tu primera aplicación
Cambie al directorio publish/ab-test del repositorio de trabajos del curso:
$cd nru-programmability-course/publish/ab-testEste directorio contiene el código que esperamos que tenga su aplicación en este punto del curso. Al navegar al directorio correcto al comienzo de cada lección, deja atrás su código personalizado, proteger así de llevar código incorrecto de una lección a la siguiente.
Navega hasta la raíz de tu Nerdpack en nru-programmability-course/publish/ab-test.
Genera tu propio UUID de aplicación:
$nr1 nerdpack:uuid -gfEl UUID se emplea para identificar su aplicación en el registro de aplicaciones New Relic. Debido a que está empleando el código que desarrollamos para este curso, ya existe en el registro una aplicación con el UUID existente. Al generar la suya propia, ahora podrá publicar esta aplicación.
Detalle técnico
El UUID también vincula su aplicación a su cuenta y, por lo tanto, permite que la aplicación realice solicitudes de Nerdgraph en nombre de la cuenta que la instaló.
En package.json, establezca version en 1.0.0:
{ "private": true, "name": "ab-test", "version": "1.0.0", "scripts": { "start": "nr1 nerdpack:serve", "test": "exit 0" }, "nr1": { "uuid": "2d923ba6-d231-4dd3-830f-b1923577a422" }, "dependencies": { "prop-types": "^15.6.2", "react": "^16.6.3", "react-dom": "^16.6.3" }, "browserslist": ["last 2 versions", "not ie < 11", "not dead"]}New Relic emplea versiones semánticas y, según esta convención, 1.0.0 señala el primer lanzamiento importante. ¡Ahora estás listo para publicar!
Reemplace todas las instancias de <YOUR NEW RELIC ACCOUNT ID> y <YOUR NEW RELIC ENTITY GUID> en su proyecto con su New Relic ID de cuenta y GUID de entidad reales, respectivamente.
Publique su aplicación New Relic:
$nr1 nerdpack:publish -t DEV¡Eso es todo! Publicaste tu aplicación en el registro de New Relic. El parámetro -t especifica una etiqueta para su versión publicada. Entre otros logs, debería ver la siguiente confirmación en su consola:
Publishing Nerdpack AbTest (9da77738-9cf6-43c7-9ba0-e3a8c6ac7380) ✔ Nerdpack published successfully! ✔ Tagged 9da77738-9cf6-43c7-9ba0-e3a8c6ac7380 version 1.0.0 as DEV.Por ahora, etiquetó la versión 1.0.0 como DEV porque todavía es un trabajo en progreso.
Vea la información de registro de su aplicación:
$nr1 nerdpack:infoId: 9da77738-9cf6-43c7-9ba0-e3a8c6ac7380Region: usAccount ID: 123456Local version: 1.0.0Subscription Model: OWNER_AND_ALLOWEDVersion Count: 4Version Date Tags------- ------------- ------1.0.0 5 minutes ago DEVLos resultados de este comando detallan la información almacenada en el registro de New Relic para su aplicación, incluido su UUID, versión e ID de cuenta.
Visualiza tu aplicación en Observabilidad Instantánea
Ahora que tu aplicación está publicada y etiquetada, puedes visualizarla en el catálogo de Observabilidad Instantánea.
Ir a New Relic. Observe que no está empleando el parámetro de cadena de consulta ?nerdpacks=local. Ya no lo necesitas porque no estás entregando tu aplicación localmente.
Desde la página de inicio, navegue hasta Integrations & Agents en la barra de navegación superior.
Seleccione Apps & Visualizations.
Desde aquí podrás ver tu aplicación entre los recursos.
Tenga en cuenta que esto es diferente a cuando entregó su aplicación localmente. Las aplicaciones locales y las aplicaciones publicadas a las que estás suscrito se muestran en Your apps en la superposición de Aplicaciones.
Haga clic en su aplicación para ver más detalles.
Observe la fecha de lanzamiento y la versión de la aplicación. Esta página debe mostrar la información que creó en la última lección. Todavía no es así, porque no enviaste esa información al catálogo y publicar tu aplicación no lo hace por ti.
Enviar información del catálogo
Aunque publicaste tu aplicación, hay algunas cosas que el catálogo no conoce. Estas son las descripciones, captura de pantalla y metadatos que creaste en la última lección. nr1 catalog se emplea para enviar y ver esta información.
Envíe la información de su catálogo:
$nr1 catalog:submitUploading screenshots from nru-programmability-course/publish/ab-test... ✔ Screenshots uploaded from: nru-programmability-course/publish/ab-test ✔ Updated metadata for AbTest 1.0.0Si todo va bien, deberías ver un mensaje de éxito notificándote que la captura de pantalla y los metadatos se actualizaron.
Sin embargo, es posible que reciba un error al enviar esta información al catálogo:
Uploading screenshots... › Error: 1 error while updating AbTest 1.0.0 › › Invalid Version: Nerdpack version 1.0.0 not found. Have you run `nr1 nerdpack:publish` yet? › Code: UNKNOWNSi es así, inténtalo de nuevo en uno o dos minutos. El catálogo puede tardar unos segundos en actualizar con la nueva versión de su aplicación.
Si eso no funciona, cerciorar de publicar su aplicación con nr1 nerdpack:publish.
Vea la información de su catálogo:
$nr1 catalog:infoAbTest (Nerdpack): categoryTerms.0: browser agent description: Nerdpack ab-test details: Display test data for our newsletter subscription A/B test displayName: AbTest keywords.0: a/b test icon.url: https://nr3.nr-ext.net/artifact-index-production/a685fec2-29fb-40b0-9f65-4178... previews.0.url: https://application-catalog-production.s3.us-east-2.amazonaws.com/nerdpacks/a... releaseDate: 2021-03-12T15:46:09.600138Z repository: https://github.com/newrelic-experimental/nru-programmability-course tagline: Win @ newsletter subscriptions version: 1.0.0 whatsNew.changes: Initial release! Includes: - A variety of charts for understanding the test r... whatsNew.version: 1.0.0AbTestLauncher (Launcher): description: Describe me displayName: AbTestLauncher icon.url: https://nr3.nr-ext.net/artifact-index-production/a685fec2-29fb-40b0-9f65-4178...AbTestNerdlet (Nerdlet): displayName: AbTestNerdlet supportedEntityTypes.mode: NONEToda la información de catalog se muestra aquí.
Vea su aplicación.
Haga clic en la aplicación para ver más.
Verás la captura de pantalla agregada a tu launcher o Nerdlet en What's inside.
Aquí verá los detalles de la aplicación, una pestaña de documentación, notas de la versión y captura de pantalla.
Actualiza tu etiqueta de versión
Su aplicación se ve genial en el catálogo de observabilidad instantánea, completo con metadatos, imágenes y documentación. Antes, etiquetabas la aplicación como DEV porque toda la información no estaba lista para el consumo público. Ahora es. Es hora de actualizar la etiqueta de su versión.
Actualice la versión de su aplicación 1.0.0 de DEV a STABLE:
$nr1 nerdpack:tag -t STABLE ✔ Tagged 9da77738-9cf6-43c7-9ba0-e3a8c6ac7380 version 1.0.0 as STABLE.Sin especificar una versión, nr1 usa la versión especificada en package.json. Puede especificar una versión con el comando -V. Obtenga más información sobre nerdpack:tag con el comando nr1 nerdpack:tag --help.
Ver la información de su aplicación:
$nr1 nerdpack:infoId: 9da77738-9cf6-43c7-9ba0-e3a8c6ac7380Region: usAccount ID: 123456Local version: 1.0.0Subscription Model: OWNER_AND_ALLOWEDVersion Count: 1Version Date Tags------- ------------- ------1.0.0 30 minutes ago STABLELa aplicación ahora tiene la etiqueta STABLE, lo que indica que está lista para uso público.
Detalle técnico
Aunque la aplicación está lista para uso público, solo es visible para el usuario de su cuenta. Otras cuentas no pueden ver aplicaciones creadas por otras cuentas privadas a menos que esas aplicaciones se agreguen al catálogo público de observabilidad instantánea.
Ahora que tu aplicación está publicada y sus metadatos enviados, puedes suscribir tu cuenta a la aplicación desde Observabilidad instantánea. En la siguiente lección, aprenderá las formas de suscribir y cancelar la subscripción a su nueva aplicación.
Curso
Esta lección es parte de un curso que le muestra cómo crear una aplicación New Relic desde cero. Continúe con la siguiente lección: Suscribir a su aplicación New Relic.