ヒント
このレッスンは、New Relic アプリケーションをゼロから構築する方法を学習するコースの一部です。 まだご覧になっていない方は、概要をご覧ください。
コースの各レッスンは前回のレッスンに基づいて構築されるため、このレッスンを開始する前に、前回のレッスン「カタログ用のアプリの説明」を完了していることを確認してください。
前回のレッスンでは、このコースを通じて構築してきた A/B テスト アプリのカタログ情報を作成しました。 次に、アプリを Instant App カタログに公開し、カタログの詳細を送信します。
バージョンとタグ
アプリケーションを公開するには、次の 2 つの重要な情報が必要です。
- version
- タグ
アプリケーションのバージョンは、アプリケーションに含まれるコードを識別し、Nerdpack のルート レベルのpackage.jsonファイルに保存されます。 Nerdpack 内のコードを修正してリリースする準備ができたら、そのたびにpackage.jsonのバージョンを更新します。 たとえば、アプリケーション コードの最初のメジャー バージョンでいくつかのバグを修正した場合、その変更をバージョン1.0.1で公開する場合があります。
アプリ バージョンのタグはその状態を表します。 たとえば、開発中のアプリケーションのバージョン0.0.1は、開発中であることを示すDEVタグ付きで公開される場合があります。
ヒント
タグの使用方法を規定するいくつかのルールがあり、それらについてはタグのドキュメントで読むことができます。
最初のアプリケーションを公開する
コースワークリポジトリのpublish/ab-testディレクトリに変更します:
$cd nru-programmability-course/publish/ab-testこのディレクトリには、コースのこの時点でアプリケーションに含まれることが予想されるコードが含まれています。 各レッスンの開始時に正しいディレクトリに移動することで、カスタム コードが残され、間違ったコードがレッスン間で持ち越されることがなくなります。
nru-programmability-course/publish/ab-testにある Nerdpack のルートに移動します。
独自のアプリ UUID を生成します:
$nr1 nerdpack:uuid -gfUUID は、New Relic アプリ レジストリでアプリを識別するために使用されます。 このコース用に開発したコードを使用しているため、既存の UUID を持つアプリケーションがレジストリに既に存在しています。 独自に生成することで、このアプリケーションを公開できるようになりました。
技術的詳細
UUID はアプリをアカウントに結び付けるため、アプリはそれをインストールしたアカウントに代わって Nerdgraph リクエストを行うことができます。
package.jsonで、 versionを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 はセマンティック バージョン管理を使用しており、この規則では、 1.0.0最初のメジャー リリースを示します。 これで、公開する準備ができました。
プロジェクト内のすべての<YOUR NEW RELIC ACCOUNT ID>および<YOUR NEW RELIC ENTITY GUID>のインスタンスを、それぞれ実際の New Relicアカウント IDおよびエンティティ GUID に置き換えます。
New Relic アプリケーションを公開します。
$nr1 nerdpack:publish -t DEVそれでおしまい！ アプリケーションを New Relic のレジストリに公開しました。 -tは公開バージョンのタグを指定します。 その他のログの中で、コンソールに次の確認が表示されます。
Publishing Nerdpack AbTest (9da77738-9cf6-43c7-9ba0-e3a8c6ac7380) ✔ Nerdpack published successfully! ✔ Tagged 9da77738-9cf6-43c7-9ba0-e3a8c6ac7380 version 1.0.0 as DEV.現時点では、1.0.0 リリースはまだ進行中であるため、 DEVとしてタグ付けされています。
アプリのレジストリ情報を表示します。
$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 DEVこのコマンドの結果には、アプリケーションの UUID、バージョン、アカウント ID など、New Relic のレジストリに保存されているアプリケーションの詳細情報が表示されます。
Instant of servabilityでアプリケーションを表示する
アプリケーションが公開され、タグが付けられたので、Instant of Servability カタログで表示できます。
New Relicにアクセスしてください。 ?nerdpacks=localクエリ文字列を使用していないことに注意してください。 アプリをローカルで提供していないため、もう必要ありません。
ホームページから、上部のナビゲーション バーのIntegrations & Agents [インテグレーション & エージェント]に移動します。
Apps & Visualizations [アプリと視覚化]を選択します。
ここから、リソースの中からアプリケーションを確認できます。
これは、アプリをローカルで提供したときとは異なることに注意してください。 代わりに、サブスクライブしているローカル アプリと公開済みアプリが アプリ オーバーレイのYour apps [自分のアプリ]の下に表示されます。
詳細を表示するにはアプリをクリックしてください。
リリース日とアプリのバージョンに注意してください。 このページには、前回のレッスンで作成した情報が表示されます。 まだ実行されていません。カタログにその情報を送信しておらず、アプリを公開してもそれが実行されないためです。
カタログ情報を送信する
アプリケーションを公開したとしても、カタログが認識していないものがいくつかあります。 これらは、前回のレッスンで作成した説明、スクリーンショット、メタデータです。 nr1 catalog 、この情報を送信および表示するために使用されます。
カタログ情報を送信してください:
$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.0すべてが正常に完了すると、スクリーンショットとメタデータが更新されたことを通知する成功メッセージが表示されます。
ただし、この情報をカタログに送信するとエラーが発生する可能性があります。
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: UNKNOWNその場合は、1～2 分後にもう一度お試しください。 カタログがアプリケーションの新しいバージョンで更新されるまでに数秒かかる場合があります。
それでもうまくいかない場合は、アプリをnr1 nerdpack:publishで公開したことを確認してください。
カタログ情報を表示します:
$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: NONEcatalogからのすべての情報がここに表示されます。
アプリを表示します。
詳細を表示するにはアプリをクリックしてください。
ランチャーまたは Nerdlet に追加されたスクリーンショットは、 What's inside [中には何が入っているのか]の下に表示されます。
ここでは、アプリの詳細、ドキュメント タブ、リリース ノート、スクリーンショットが表示されます。
バージョンタグを更新する
あなたのアプリは、メタデータ、画像、ドキュメントが完備された Instant のアクセシビリティ カタログで素晴らしい印象を与えます。 以前は、すべての情報が一般公開できる状態ではなかったため、アプリにDEVタグを付けました。 今はそうです。 バージョン タグを更新するときが来ました。
1.0.0アプリのバージョンをDEVからSTABLEに更新します:
$nr1 nerdpack:tag -t STABLE ✔ Tagged 9da77738-9cf6-43c7-9ba0-e3a8c6ac7380 version 1.0.0 as STABLE.バージョンを指定しない場合、 nr1 package.jsonで指定されたバージョンを使用します。 -Vコマンドでバージョンを指定できます。 nr1 nerdpack:tag --helpコマンドを使用してnerdpack:tagの詳細を確認します。
アプリ情報を表示します:
$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 STABLEアプリにSTABLEのタグが付けられ、一般公開の準備が整ったことを示します。
技術的詳細
アプリは一般公開できる状態ですが、表示されるのはあなたのアカウントのユーザーのみです。 他のアカウントは、他のプライベート アカウントによって作成されたアプリを公開の Instant App カタログに追加しない限り、そのアプリを表示できません。
アプリが公開され、そのメタデータが送信されたので、Instant of Servability からアカウントをアプリにサブスクライブできます。 次のレッスンでは、新しいアプリケーションをサブスクライブおよびサブスクライブ解除する方法を学習します。
コース
このレッスンは、New Relic アプリケーションをゼロから構築する方法を学習するコースの一部です。 次のレッスンに進み、「New Relic アプリケーションをサブスクライブする」に進みます。