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, Lancez vos services de démonstration, avant de commencer celle-ci.
L’un des principaux éléments du SDK New Relic est l’interface de ligne de commande (CLI). Pour créer un Nerdpack, vous devrez installer le SDK, configurer la CLI pour qu'elle fonctionne avec votre compte New Relic, puis utiliser sa commande create
.
Installer et configurer la CLI
Accédez au démarrage rapide de Build on New Relic .
Obtenez votre clé API de licence.
Une fois la CLI installée, vous utiliserez cette clé pour créer un profil utilisateur associé à votre compte. La CLI utilise ce profil pour gérer les entités au sein de votre compte.
Lorsque vous installez la CLI, lisez et acceptez les conditions générales des développeurs de New Relic.
Même si vous installez la CLI, vous ne pourrez pas l'utiliser sans avoir au préalable accepté ces termes et conditions.
Choisissez votre système d'exploitation et cliquez sur Télécharger le programme d'installation.
Une fois le SDK installé, vous aurez accès à la CLI nr1
. Vérifiez cela en vérifiant votre version SDK :
$nr1 --version
Si vous possédiez déjà la CLI, mettez-la à jour :
$nr1 update
Conseil
Il est important de faire la distinction entre la CLI newrelic
et la CLI nr1
. newrelic
sert à gérer l'entité dans votre compte New Relic. nr1
sert à gérer les applications New Relic.
Copiez la commande pour enregistrer vos informations d'identification.
Cette commande comporte un nom de profil, votre région et votre clé API intégrés.
Exécutez la commande dans votre terminal :
$nr1 profiles:add --name <profile name> --api-key <User key> --region <region>
Les profils vous permettent de sélectionner le compte New Relic sur lequel vous souhaitez exécuter des commandes. Si vous avez plusieurs comptes, vous pouvez les consulter avec profiles:list
:
$nr1 profiles:list
Notez qu’un profil est votre profil par défaut. Il s'agit du compte sur lequel vos commandes seront exécutées, sauf si vous en spécifiez un autre. Pour spécifier un profil pour une commande particulière, utilisez l'option --profile
:
$nr1 create --profile <your profile>
Si c'est la première fois que vous utilisez la CLI, le profil que vous venez d'ajouter est votre profil par défaut. Si vous avez d'autres profils, vous devez définir votre profil par défaut sur celui que vous souhaitez utiliser pour ce cours :
$nr1 profiles:default
Conseil
Si vous oubliez ces commandes, vous pouvez les rechercher dans le menu d'aide des profils :
$nr1 profiles --help
Vous pouvez maintenant quitter le démarrage rapide Build on New Relic. Vous êtes prêt à créer une application avec la CLI New Relic !
Conseil
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 : Créer un Nerdpack.