Nerdpackのリリースバージョンにタグを付ける

Nerdpack バージョンにタグを付けて追跡し、購読します。バージョンのタグを解除して、サブスクリプションを防止したり、Nerdpacks をカタログから非表示にしたりします。

CLIを更新する

コマンドを実行する前に、CLI の最新バージョンがインストールされていることを確認してください。

bash

$nr1 update

権限を確認してください

Nerdpack バージョンにタグを付けるには、次のものが必要です。

公開したアカウントへのアクセス
Nerdpacks を管理するために必要な権限。

Nerdpackを公開する

作成した Nerdpack にタグを付けるには、まずそれを公開する必要があります。

バージョンにタグを付ける

Nerdpack バージョンを New Relic アプリカタログに公開したら、 nr1 CLI を使用してタグ付けできます。

Nerdpack のルートフォルダーで、 nr1 nerdpack:tagを実行します。

bash

$nr1 nerdpack:tag --tag=DEV
✔  Tagged ab123c45-678d-9012-efg3-45hi6jkl7890 version 1.0.0 as DEV.

ここでは、バージョン1.0.0をDEVとしてタグ付けしました。

これで、あなたとあなたのアカウントの他のユーザーは、このタグを使用できるようになります。

Nerdpackをアカウントに追加すると、購読オプションとしてタグが表示されます。
DEVタグをサブスクライブし、後で更新された場合 (たとえば、 DEVがバージョン1.0.1に適用された場合)、再度サブスクライブしなくても新しいバージョンに自動的にアップグレードされます。

重要

タグリリースバージョンの機能の 1 つは、タグをサブスクライブしているユーザーは、そのタグが別のバージョンで使用されたときに自動的に更新を受け取ることです。つまり、ユーザーが 1 つのバージョン (たとえば1.0.0をテストしていて、同じタグを別のバージョン (たとえば1.0.1に適用すると、そのユーザーのアカウントにはバージョン1.0.1が表示され、以前テストしていた Nerdpack にはアクセスできなくなります。多くの場合、これは予想される動作ですが、タグを使用するときはこの副作用を考慮してください。

Nerdpack のレジストリ情報を表示します。

bash

$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 1.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 1
Version  Date         Tags
-------  -----------  ----
1.0.0    5 hours ago  DEV

この出力は、バージョン1.0.0のDEVタグを確認します。

バージョンのタグを解除する

Nerdpack のバージョンを増やすと、タグを新しいバージョンに更新できるようになります。ただし、 nr1を使用して Nerdpack からタグを削除することもできます。

Nerdpack のルートディレクトリから、レジストリ情報を表示します。

bash

$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 1.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 1
Version  Date               Tags
-------  -----------------  ----
2.0.0    a few seconds ago  DEV
1.0.1    8 minutes ago      BETA, STABLE
1.0.0    6 hours ago

ここで、バージョン1.0.0にはタグがなく、バージョン1.0.1には 2 つのタグBETAとSTABLEがあり、バージョン2.0.0には 1 つのタグDEVがあることがわかります。

Nerdpack バージョンからBETAタグを削除します。

bash

$nr1 nerdpack:untag --tag=BETA
✔  Removed nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 tag BETA.

Nerdpack からタグが削除されたことを確認します。

bash

$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 1.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 1
Version  Date            Tags
-------  --------------  ----
2.0.0    5 minutes ago   DEV
1.0.1    13 minutes ago  STABLE
1.0.0    6 hours ago

Nerdpack バージョンのタグ付けに関する問題を解決する

場合によっては、Nerdpack バージョンにタグ付けすると問題が発生することがあります。 Nerdpack にタグを付けられない場合や、Nerdpack のタグを解除できない場合は、これらの問題を解決するための一般的な解決策を検討してください。

Nerdpackを公開する

Nerdpack を公開せずにタグ付けしようとすると、エラーが発生します。

bash

$nr1 nerdpack:tag --tag=DEV
›   Error: A downstream error occurred.

このエラーメッセージにはあまり情報がありませんが、 --verboseオプションを使用すると詳細情報が表示されます。

bash

$nr1 nerdpack:tag --tag=DEV --verbose
init version: @oclif/command@1.8.0 argv: [ '--tag=DEV', '--verbose', [length]: 2 ]
dist/metadata.json does not exist. package.json will be used instead.
Using profile account-1234567
Request: POST https://api.newrelic.com/graphql
Data: mutation 
                nerdpackTagVersion(
                    nerdpackId: "ab123c45-678d-9012-efg3-45hi6jkl7890",
                    versionTag: 
                        tag: "DEV",
                        version: "1.0.0"
                    }
                ) 
                    nerdpackId
                    tags
                    version
                }
            }
Headers: 
  'API-Key': '<YOU USER KEY>',
  'Content-Type': 'application/graphql'
}

このより詳細なエラーメッセージは、 nr1 nerdpack:tagのバックグラウンドで実行される GraphQL を示しています。ここでのメッセージの重要な部分は次のとおりです。

bash

dist/metadata.json does not exist. package.json will be used instead.

アプリを公開すると、 distディレクトリが作成されます。したがって、まだ公開されていないため、このディレクトリは存在せず、 nr1はpackage.jsonに戻って Nerdpack の詳細を検索します。しかし、 package.jsonの UUID が New Relic レジストリにないため、コマンドは失敗しました。

したがって、バージョンにタグを付ける前に、レジストリに公開します。

bash

$nr1 nerdpack:publish
$nr1 nerdpack:tag --tag=DEV

ヒント

デプロイすると同時にバージョンにタグを付けることもできることに注意してください。

bash

$nr1 nerdpack:publish --tag=DEV

Nerdpack の購読を解除する

削除できるのは、購読者がいないタグのみです。ユーザーが購読しているタグを削除しようとすると、エラーが発生します。

bash

$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 2.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 3
Version  Date         Tags
-------  -----------  ----
2.0.0    an hour ago  DEV
1.0.1    an hour ago
1.0.0    6 hours ago
$nr1 nerdpack:untag -t DEV
›   Error: A downstream error occurred.

この場合は、Nerdpack に登録されているかどうかを確認してください。

bash

$nr1 subscription:list
Listing subscribed deployed nerdpacks on your account:
Version  UUID                                  Name               Date         User
-------  ------------------------------------  -----------------  -----------  ----------
2.0.0    ab123c45-678d-9012-efg3-45hi6jkl7890  MyAwesomeNerdpack  an hour ago  1000383529

これは、 MyAwesomeNerdpackに登録していることを示します。登録を解除してから、 DEVタグを再度削除してみてください:

bash

$nr1 nerdpack:unsubscribe
Unsubscribed account 1234567 from the nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 on the DEV channel.
$nr1 nerdpack:untag --tag=DEV
✔  Removed nerdpack ab123c45-678d-9012-efg3-45hi6jkl7890 tag DEV.
$nr1 nerdpack:info
Id: ab123c45-678d-9012-efg3-45hi6jkl7890
Region: us
Account ID: 1234567
Local version: 2.0.0
Subscription Model: OWNER_AND_ALLOWED
Version Count: 3
Version  Date         Tags
-------  -----------  ----
2.0.0    an hour ago
1.0.1    an hour ago
1.0.0    6 hours ago

この機械翻訳は、参考として提供されています。

Nerdpackのリリースバージョンにタグを付ける

CLIを更新する.css-21sua1{background:none;border:none;width:0;padding:0;}

権限を確認してください

Nerdpackを公開する

バージョンにタグを付ける

重要

バージョンのタグを解除する

Nerdpack バージョンのタグ付けに関する問題を解決する

Nerdpackを公開する

ヒント

Nerdpack の購読を解除する

CLIを更新する