Comment installer manuellement Jetpack

Jetpack est généralement téléchargé et installé automatiquement sur les machines virtuelles gérées par CycleCloud lorsqu’elles démarrent sans aucune interaction de l’utilisateur. Il s’agit de la méthode recommandée pour obtenir Jetpack sur une machine virtuelle gérée par CycleCloud. Toutefois, dans certains cas, vous pouvez installer manuellement Jetpack sur une machine virtuelle.

Avertissement

L’installation de Jetpack directement sur une image personnalisée n’est plus recommandée dans CycleCloud 8. Le processus d’installation de Jetpack dans CycleCloud 8 ne prend que quelques secondes en moyenne et nécessite uniquement un accès réseau à votre compte de stockage. Il n’y a donc généralement aucune raison de préinstaller Jetpack sur des images personnalisées.

Pourquoi installer Jetpack

Les images personnalisées vous permettent de contrôler entièrement la version du logiciel installée sur votre système d’exploitation. Si vous avez des exigences qui sont remplies uniquement avec une version spécifique de Jetpack et que la version de Jetpack n’est pas installée par défaut, vous devez installer manuellement cette version de Jetpack sur une machine virtuelle et créer une image personnalisée.

La création d’une image personnalisée avec une version préinstallée de Jetpack permet également d’améliorer légèrement les performances lors du démarrage des machines virtuelles, car Jetpack n’a plus besoin d’être téléchargé et installé chaque fois qu’une machine virtuelle démarre. Cette amélioration des performances est négligeable (quelques secondes) et ne doit pas être la raison principale pour laquelle l’image personnalisée est créée.

Notes

À certaines phases de gestion de l’installation et de la configuration, Jetpack peut consommer 500 Mo de mémoire. Tenez compte de cela lors du choix d’une taille de machine virtuelle. Burstable Standard_B1ls peut être instable.

Installation via YUM ou APT

Le moyen le plus simple d’installer Jetpack consiste à utiliser le référentiel apt/yum. Tout d’abord, ajoutez le référentiel à votre machine virtuelle, puis installez Jetpack :

via YUM :

sudo cat > /etc/yum.repos.d/cyclecloud.repo <<EOF
[cyclecloud]
name=cyclecloud
baseurl=https://packages.microsoft.com/yumrepos/cyclecloud
gpgcheck=1
gpgkey=https://packages.microsoft.com/keys/microsoft.asc
EOF
sudo yum install -y jetpack8

via APT :

sudo wget -O /etc/apt/trusted.gpg.d/microsoft.asc https://packages.microsoft.com/keys/microsoft.asc
sudo echo 'deb [signed-by=/etc/apt/trusted.gpg.d/microsoft.asc] https://packages.microsoft.com/repos/cyclecloud bionic main' > /etc/apt/sources.list.d/cyclecloud.list
sudo apt update
sudo apt-get install -y jetpack8

Une installation manuelle à l’aide des bundles CycleCloud d’archive Jetpack est également disponible comme suit dans les cas où APT/YUM ne sont pas une bonne solution.

Installer Jetpack manuellement

Recherchez le programme d’installation de Jetpack pour l’installation manuelle

Le programme d’installation de Jetpack se trouve dans votre installation CycleCloud à l’adresse /opt/cycle_server/work/staging/jetpack. Ce répertoire contient toutes les versions disponibles pour votre installation pour les machines virtuelles Linux et Windows.

/opt/cycle_server/work/staging/jetpack/
├── 7.9.0
│   ├── jetpack-7.9.0-linux.tar.gz
│   └── jetpack-7.9.0-windows.zip
├── 7.9.1
│   ├── jetpack-7.9.1-linux.tar.gz
│   └── jetpack-7.9.1-windows.zip

Notes

Les numéros de version que vous voyez peuvent différer de ceux répertoriés ici en fonction de la version de CycleCloud que vous utilisez actuellement.

Charger l’archive Jetpack sur une machine virtuelle

Une fois que vous avez localisé le programme d’installation de Jetpack que vous souhaitez installer, vous devez le charger sur votre machine virtuelle. Pour cet exemple, nous allons déplacer le fichier vers Linux à l’aide de SCP dans le azureuserrépertoire de base de :

scp /opt/cycle/jetpack/work/staging/jetpack/7.9.0/jetpack-7.9.0-linux.tar.gz azureuser@myserver.eastus.cloudapp.com:/home/azureuser

Notes

N’utilisez pas de machine virtuelle à partir d’un VMSS pour installer Jetpack et personnaliser une image. Il n’est pas possible de capturer une image de machine virtuelle à partir de VMSS.

Installer Jetpack

Connectez-vous à la machine virtuelle sur laquelle vous avez chargé le programme d’installation jetpack, décompressez et exécutez la commande d’installation. Des instructions d’installation sont fournies pour Linux et Windows.

Linux

Vous devez être connecté en tant que azureuser.

mkdir -p /opt/cycle
tar -xf jetpack-8.0.0-linux.tar.gz -C /opt/cycle
./opt/cycle/jetpack/system/install/install.sh

Windows

New-Item -Force -ItemType 'directory' -Path 'C:\cycle'
[System.Reflection.Assembly]::LoadWithPartialName('System.IO.Compression.FileSystem')
[System.IO.Compression.ZipFile]::ExtractToDirectory((Get-Item 'jetpack-8.0.0-windows.zip'), (Get-Item 'C:\cycle'))
C:\cycle\jetpack\system\install\install.cmd

Ces commandes installent jetpack sur /opt/cycle/jetpack sur Linux ou C:\cycle\jetpack sur Windows ($JETPACK_HOME). Un journal d’installation est disponible sur $JETPACK_HOME/logs/installation.log

Capture de l’image personnalisée

Après avoir installé Jetpack et effectué toute autre configuration d’image personnalisée, la machine virtuelle est prête pour la capture d’image. Notez que les instructions diffèrent entre les machines virtuelles Windows et Linux .

Utilisation de l’image personnalisée avec CycleCloud

Pour utiliser l’image avec un cluster CycleCloud, vous pouvez spécifier le ImageName dans votre modèle de cluster ou en le spécifiant à l’aide de l’option d’image personnalisée dans l’interface utilisateur. Si nous avions nommé notre image MyCustomImage personnalisée, nous l’utiliserions comme suit dans un modèle de cluster :

[[node custom]]
  ImageName = /subscriptions/xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/images/MyCustomImage
  DownloadJetpack = false

Notes

La spécification DownloadJetpack=false n’est pas nécessaire, mais vous pouvez gagner un peu de temps en ne téléchargeant pas Jetpack au démarrage. Si DownloadJetpack n’est pas spécifié, CycleCloud tente de télécharger et d’installer Jetpack au moment de l’exécution et de voir que Jetpack a déjà été installé sur votre image.

En savoir plus

• Pour plus d’informations sur la création et l’utilisation d’images personnalisées, consultez Images personnalisées dans un cluster CycleCloud
• Pour en savoir plus sur Jetpack, vous pouvez consulter les concepts jetpack