Tag a versão de lançamento do seu Nerdpack

Tag suas versões do Nerdpack para rastreá-las e assiná-las. Desmarque versões para evitar assinatura ou ocultar Nerdpacks do catálogo.

Atualize sua CLI

Antes de executar qualquer comando, certifique-se de ter a versão mais recente da CLI:

bash

$nr1 update

Verifique suas permissões

Para tag uma versão do Nerdpack, você precisa:

Acesso à conta que o publicou
As permissões necessárias para gerenciar Nerdpacks.

Publique seu Nerdpack

Você precisa publicar os Nerdpacks criados antes de tag -los.

Tag uma versão

Depois de publicar uma versão do Nerdpack no catálogo de aplicativos New Relic , você poderá tag -la com a CLI nr1.

Na pasta raiz do seu Nerdpack, execute nr1 nerdpack:tag:

bash

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

Aqui, você marca a versão 1.0.0 como DEV.

Agora, você e outros usuários da sua conta podem usar esta tag:

Você vê a tag como uma opção de assinatura quando adiciona o Nerdpack à sua conta
Se você assinar a tag DEV e ela for atualizada posteriormente (por exemplo, DEV for aplicado à versão 1.0.1 ), você será atualizado automaticamente para a nova versão sem precisar se inscrever novamente.

Importante

Um dos recursos das versões de lançamento de tags é que o usuário que está inscrito em uma tag recebe atualizações automaticamente quando essa tag é usada para outra versão. Isso significa que se um usuário estiver testando uma versão, digamos 1.0.0, e você aplicar a mesma tag a outra versão, digamos 1.0.1, esse usuário verá a versão 1.0.1 em sua conta e não poderá mais acessar a versão Nerdpack eles estavam testando antes. Muitas vezes, esse é o comportamento esperado, mas lembre-se de considerar esse efeito colateral ao usar a tag.

Veja as informações de registro do seu 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

Esta saída confirma sua tag DEV na versão 1.0.0.

Desmarcar uma versão

À medida que você cria mais versões do seu Nerdpack, você pode atualizar sua tag para versões mais recentes. No entanto, você também pode remover uma tag do seu Nerdpack com nr1.

No diretório raiz do seu Nerdpack, visualize as informações do seu registro:

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

Aqui você vê que a versão 1.0.0 não tem tag, a versão 1.0.1 tem duas tags, BETA e STABLE, e a versão 2.0.0 tem uma tag, DEV.

Remova a tag BETA das suas versões do Nerdpack:

bash

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

Verifique se a tag foi removida do seu 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

Resolver problemas ao marcar uma versão do Nerdpack

Às vezes, ao tag uma versão do Nerdpack, você pode encontrar problemas. Quer você não consiga tag seu Nerdpack ou desmarcá-lo, considere algumas soluções comuns para resolver esses problemas.

Publique seu Nerdpack

Se você tentar tag seu Nerdpack sem publicá-lo primeiro, receberá um erro:

bash

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

Esta mensagem de erro não diz muito, mas você pode usar a opção --verbose para ver mais informações:

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'
}

Esta mensagem de erro mais detalhada mostra o GraphQL executado nos bastidores para nr1 nerdpack:tag. A parte importante da mensagem aqui é:

bash

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

O diretório dist é criado quando você publica seu aplicativo. Então, por ainda não ter sido publicado, esse diretório não existe e nr1 recorre a package.json para procurar detalhes sobre seu Nerdpack. Mas, como o UUID em seu package.json não está no registro do New Relic, o comando falhou.

Portanto, antes de tag suas versões, publique-as no registro:

bash

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

Dica

Lembre-se que você também pode tag uma versão ao mesmo tempo em que a implanta!

bash

$nr1 nerdpack:publish --tag=DEV

Cancelar assinatura do Nerdpack

Você só pode remover tags que não tenham assinantes. Se você tentar remover uma tag na qual o usuário está inscrito, você receberá um erro:

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.

Neste caso, verifique se você é assinante do 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

Isso mostra que você está inscrito em MyAwesomeNerdpack. Cancele a inscrição e tente remover a tag DEV novamente:

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

Esta tradução de máquina é fornecida para sua comodidade.

Tag a versão de lançamento do seu Nerdpack

Atualize sua CLI.css-21sua1{background:none;border:none;width:0;padding:0;}

Verifique suas permissões

Publique seu Nerdpack

Tag uma versão

Importante

Desmarcar uma versão

Resolver problemas ao marcar uma versão do Nerdpack

Publique seu Nerdpack

Dica

Cancelar assinatura do Nerdpack

Atualize sua CLI