Conseil
Cette leçon fait partie d’un cours qui vous apprend à créer une application New Relic à partir de zéro. Si vous ne l’avez pas déjà fait, consultez la présentation.
Chaque leçon du cours s'appuie sur la précédente, alors assurez-vous d'avoir terminé la dernière leçon, Décrivez votre application pour le catalogue, avant de commencer celle-ci.
Dans la dernière leçon, vous avez créé des informations de catalogue pour l'application de test A/B que vous avez créée tout au long de ce cours. Il est maintenant temps de publier votre application dans le catalogue Instant Observability et de soumettre les détails de ce catalogue.
Versions et tags
La publication d'une application nécessite deux informations clés :
- version
- tag
La version d'une application identifie le code qu'elle contient et est stockée dans le fichier package.json de niveau racine du Nerdpack. Chaque fois que vous modifiez le code dans votre Nerdpack et que vous êtes prêt à le sortir, vous mettrez à jour la version dans package.json. Par exemple, si vous corrigez certains bugs dans la première version majeure de votre code d'application, vous pouvez publier les modifications sous la version 1.0.1.
La balise d'une version d'application décrit son état. Par exemple, la version 0.0.1 d'une application en cours de développement peut être publiée avec une tag DEV pour indiquer qu'elle est en cours de développement.
Conseil
Il existe certaines règles régissant la manière dont vous pouvez utiliser les balises et vous pouvez les lire dans notre documentation sur les balises.
Publiez votre première candidature
Accédez au répertoire publish/ab-test du référentiel de cours:
$cd nru-programmability-course/publish/ab-testCe répertoire contient le code que nous attendons de votre application à ce stade du cours. En naviguant vers le bon répertoire au début de chaque leçon, vous laissez votre code personnalisé derrière vous, vous protégeant ainsi du transport de code incorrect d'une leçon à l'autre.
Accédez à la racine de votre Nerdpack à nru-programmability-course/publish/ab-test.
Générez votre propre UUID d'application :
$nr1 nerdpack:uuid -gfL'UUID est utilisé pour identifier votre application dans le registre des applications New Relic. Étant donné que vous utilisez le code que nous avons développé pour ce cours, une application avec l’UUID existant existe déjà dans le registre. En générant le vôtre, vous êtes désormais en mesure de publier cette application.
Détails techniques
L'UUID lie également votre application à votre compte et permet donc à l'application de faire requests Nerdgraph au nom du compte qui l'a installée.
Dans package.json, définissez version sur 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 utilise le versionnage sémantique et, selon cette convention, 1.0.0 signale la première sortie majeure. Vous êtes maintenant prêt à publier !
Remplacez toutes les instances de <YOUR NEW RELIC ACCOUNT ID> et <YOUR NEW RELIC ENTITY GUID> dans votre projet par votre ID de compte New Relic réel et GUID d'entité, respectivement.
Publiez votre application New Relic :
$nr1 nerdpack:publish -t DEVC'est ça! Vous avez publié votre application dans le registre de New Relic. Le paramètre -t spécifie une tag pour votre version publiée. Parmi les autres logs, vous devriez voir la confirmation suivante dans votre console :
Publishing Nerdpack AbTest (9da77738-9cf6-43c7-9ba0-e3a8c6ac7380) ✔ Nerdpack published successfully! ✔ Tagged 9da77738-9cf6-43c7-9ba0-e3a8c6ac7380 version 1.0.0 as DEV.Pour l'instant, vous avez marqué la sortie 1.0.0 comme DEV car c'est toujours un travail en cours.
Afficher les informations du registre de votre application :
$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 DEVLes résultats de cette commande détaillent les informations stockées dans le registre de New Relic pour votre application, y compris son UUID, sa version et son ID de compte.
Visualisez votre application dans Instant Observability
Maintenant que votre application est publiée et étiquetée, vous pouvez la visualiser dans le catalogue Instant Observability .
Allez à New Relic. Notez que vous n'utilisez pas le paramètre de chaîne de requête ?nerdpacks=local . Vous n’en avez plus besoin car vous ne diffusez pas votre application localement.
Depuis la page d’accueil, accédez à Integrations & Agents dans la barre de navigation supérieure.
Sélectionnez Apps & Visualizations.
À partir de là, vous pouvez voir votre candidature parmi les ressources.
Notez que cela est différent de lorsque vous avez diffusé votre application localement. Les applications locales et les applications publiées auxquelles vous êtes abonné s'affichent sous Your apps dans la superposition Applications.
Cliquez sur votre application pour voir plus de détails.
Notez la date de sortie et la version de l'application. Cette page doit afficher les informations que vous avez créées lors de la dernière leçon. Ce n'est pas encore le cas, car vous n'avez pas soumis ces informations au catalogue et la publication de votre application ne le fait pas pour vous.
Soumettre les informations du catalogue
Même si vous avez publié votre application, il y a certaines choses que le catalogue ne connaît pas. Ce sont les descriptions, captures d'écran et métadonnées que vous avez créées dans la dernière leçon. nr1 catalog est utilisé pour soumettre et afficher ces informations.
Soumettez les informations de votre catalogue :
$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 tout se passe bien, vous devriez voir un message de réussite vous informant que la capture d'écran et la métadonnées ont été mises à jour.
Il est possible cependant que vous obteniez une erreur lors de la soumission de ces informations au catalogue :
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 c’est le cas, réessayez dans une minute ou deux. La mise à jour du catalogue avec la nouvelle version de votre application peut prendre quelques secondes.
Si cela ne fonctionne pas, assurez-vous d'avoir publié votre application avec nr1 nerdpack:publish.
Consultez les informations de votre catalogue :
$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: NONEToutes les informations de catalog sont affichées ici.
Affichez votre application.
Cliquez sur l'application pour en voir plus.
Vous voyez la capture d'écran ajoutée à votre lanceur ou Nerdlet sous Qu'y a-t-il à l'intérieur.
Ici, vous voyez les détails de l'application, un onglet de documentation, des notes de sortie et une capture d'écran.
Mettez à jour votre tagde version
Votre application a fière allure dans le catalogue Instant Observability, avec des métadonnées, des images et de la documentation. Auparavant, vous étiquetiez l'application comme DEV car toutes les informations n'étaient pas prêtes à être consommées par le public. Maintenant, c'est le cas. Il est temps de mettre à jour votre tag de version.
Mettez à jour la version de votre application 1.0.0 de DEV à STABLE:
$nr1 nerdpack:tag -t STABLE ✔ Tagged 9da77738-9cf6-43c7-9ba0-e3a8c6ac7380 version 1.0.0 as STABLE.Sans spécifier de version, nr1 utilise la version spécifiée dans package.json. Vous pouvez spécifier une version avec la commande -V . Apprenez-en plus sur nerdpack:tag avec la commande nr1 nerdpack:tag --help .
Afficher les informations de votre application :
$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 STABLEL'application est désormais étiquetée STABLE, indiquant qu'elle est prête à être utilisée par le public.
Détails techniques
Même si l'application est prête à être utilisée par le public, elle n'est toujours visible que par l'utilisateur de votre compte. Les autres comptes ne peuvent pas voir les applications créées par d’autres comptes privés, sauf si ces applications sont ajoutées au catalogue public Instant Observability .
Maintenant que votre application est publiée et que ses métadonnées sont soumises, vous pouvez abonner votre compte à l'application depuis Instant Observability. Dans la prochaine leçon, vous apprendrez les moyens de vous abonner et de vous désabonner de votre nouvelle application.
Cours
Cette leçon fait partie d’un cours qui vous apprend à créer une application New Relic à partir de zéro. Passez à la leçon suivante : abonnez-vous à votre application New Relic.