Nerdpackのカタログ情報を更新する

New Relicホームページから、上部のナビゲーション バーの+ Integrations & Agentsに移動します。

アプリ フィルターまたは検索バーを使用して、公開済みの Nerdpack を見つけます。 Nerdpack の名前とnr1.jsonにある簡単な説明以外には、情報や詳細ページがないことに注意してください。 スクリーンショット、アイコン、詳細、新機能などはありません。 これらについては、Nerdpack にカタログ情報を提供する必要があります。

Nerdpack のルートから、Nerdpack のスクリーンショットとメタデータを格納するカタログディレクトリを作成します。

$
nr1 create --type catalog
✔  created: launchers/launcher/catalog
✔  created: nerdlets/home/catalog
✔  catalog created successfully!
   catalog is available at "./catalog"

ルートcatalogディレクトリ内には、Nerdpack に関する情報をユーザーに表示するための特定のファイルとディレクトリがあります。

$
ls catalog
README.md         additionalInfo.md config.json       documentation.md  screenshots

このコマンドは、Nerdpack 内の各ランチャー、Nerdlet、視覚化に対してcatalogディレクトリも生成します。 内部には、Nerdpack の各アイテムのスクリーンショットを追加できるディレクトリがあります。

$
ls launchers/launcher/catalog
screenshots
$
ls nerdlets/home/catalog
screenshots

Nerdpack のdocumentation.mdファイルを更新します:

Enter your first and last name into the fields provided. When you're done, press **Submit** to see a personalized "Hello!" message.

config.jsonファイルを更新します:

{
  "tagline": "Say hi!",
  "details": "DemoApp says Hello to a user.",
  "categoryTerms": [],
  "keywords": ["hello world"],
  "repository": "https://github.com/newrelic/developer-website",
  "whatsNew": "feat: Initial commit"
}

スクリーンショットをルートscreenshotsディレクトリまたは Nerdpack アイテムscreenshotsディレクトリに含めます。

情報を Instant of servability カタログに送信します。

$
nr1 catalog:submit
Uploading screenshots from demo-app...
 ✔  Screenshots uploaded from: demo-app
Uploading screenshots from demo-app/launchers/launcher...
 ✔  Screenshots uploaded from: demo-app/launchers/launcher
Uploading screenshots from demo-app/nerdlets/home...
 ✔  Screenshots uploaded from: demo-app/nerdlets/home
 ✔  Updated metadata for DemoApp 1.0.0

変更を確認するには、「インスタント アクセシビリティ」に移動します。 新しい詳細を表示するには、Nerdpack をクリックしてください。 次に、 What's insideをクリックすると、Nerdpack 内の個々のアイテムにアップロードしたスクリーンショットが表示されます。

Nerdpack のルートにあるicon.pngを更新します。 このアイコンはカタログと Nerdpack の詳細ページで使用されます。

1 つ以上のランチャーを含む Nerdpack をビルドする場合は、各ランチャーのサブフォルダー内のicon.pngを更新します。

package.jsonバージョンを更新します:

{
  "private": true,
  "name": "demo-app",
  "version": "1.0.1",
  "scripts": {
    "start": "nr1 nerdpack:serve",
    "test": "exit 0"
  },
  "nr1": {
    "uuid": "f2dbc999-e9a3-49b9-933d-5a704c6750bd"
  },
  "dependencies": {
    "prop-types": "^15.6.2",
    "react": "^16.6.3",
    "react-dom": "^16.6.3"
  },
  "browserslist": ["last 2 versions", "not ie < 11", "not dead"]
}

これにより、Nerdpack の新しいバージョンを公開できるようになります。

Nerdpackを公開する:

$
nr1 nerdpack:publish

catalog/config.jsonのwhatsNew文字列を更新します:

{
  "tagline": "Say hi!",
  "details": "DemoApp says Hello to a user.",
  "categoryTerms": [],
  "keywords": ["hello world"],
  "repository": "https://github.com/newrelic/developer-website",
  "whatsNew": "feat: Add new icons"
}

これにより、最新バージョンの Nerdpack に何を追加したかがユーザーに伝わります。

この新しいメタデータをカタログに送信します。

$
nr1 catalog:submit
Uploading screenshots from demo-app...
 ✔  Screenshots uploaded from: demo-app
Uploading screenshots from demo-app/launchers/launcher...
 ✔  Screenshots uploaded from: demo-app/launchers/launcher
Uploading screenshots from demo-app/nerdlets/home...
 ✔  Screenshots uploaded from: demo-app/nerdlets/home
 ✔  Updated metadata for DemoApp 1.0.1

新しいアイコンを表示するには、カタログにアクセスしてNerdpack をサブスクライブしてください。