Déploiement du PKG Shade sur Jamf Pro

Ce guide explique comment télécharger le package d’installation Shade (PKG) et le téléverser dans Jamf Pro afin qu’il puisse être déployé sur des Mac.

Pour la documentation la plus récente, veuillez consulter la documentation PKG de Jamf Pro

Prérequis

• Accès à Jamf Pro avec les autorisations pour téléverser des paquets (généralement Administrateur du serveur Jamf Pro ou un rôle pouvant gérer les paquets).
• Un Mac avec un navigateur capable de télécharger l’installateur.

  • Si vous téléchargez l’application macOS, Shade recommande d’utiliser un navigateur autre que Safari.

1) Téléchargez le PKG de Shade

1. Ouvrir : https://shade.inc/download
2. Sous Télécharger Shade, choisissez la bonne version pour votre Mac :

   • macOS (Apple Silicon) pour les Mac de la série M (M1, M2, M3, M4)
   • macOS (Intel) pour les Mac Intel
3. Téléchargez le fichier d’installation.
4. Confirmez que le téléchargement est terminé et que vous avez un seul fichier d’installation à téléverser (par exemple, dans Téléchargements).

2) (Recommandé) Validez le paquet avant le téléversement

1. Vérifiez que vous avez téléchargé la bonne architecture (Apple Silicon ou Intel).
2. Assurez-vous que le fichier :

   • s’ouvre ou s’installe correctement sur une machine de test.
   • a une taille de fichier raisonnable (pas anormalement petite).
3. Renommez le fichier avec un nom clair et versionné (recommandé), par exemple :

   • Shade-Desktop-<version>.pkg

3) Téléversez le PKG dans Jamf Pro

1. Connectez-vous à Jamf Pro.
2. Accédez à Réglages.
3. Naviguez jusqu’à la section Paquets (parfois répertoriée sous Gestion des ordinateurs selon votre version de Jamf Pro).
4. Cliquez sur Nouveau ou Téléverser (l’intitulé varie selon la version de Jamf Pro).
5. Dans le formulaire de téléversement, sélectionnez le PKG Shade que vous avez téléchargé.
6. Configurez les réglages du paquet (options courantes) :

   • Nom d’affichage : utilisez un nom clair (par exemple, Shade).
   • Catégorie : facultatif, mais utile pour l’organisation (par exemple, Applications).
   • Priorité : conservez la valeur par défaut sauf si vous avez plusieurs paquets dépendants.
   • Exigences du système d’exploitation : définissez la version minimale de macOS si votre environnement l’exige.
   • Architecture : si Jamf permet de la préciser, faites correspondre le paquet téléchargé (Apple Silicon ou Intel).
7. Enregistrez.
8. Attendez la fin du téléversement, puis confirmez que le paquet apparaît dans la Paquets liste.

4) Confirmez que le paquet est disponible pour le déploiement

1. Ouvrez le paquet téléversé dans Jamf Pro.
2. Confirmez :

   • Le nom et les détails du paquet semblent corrects.
   • Le paquet est indiqué comme téléversé avec succès (aucune erreur).

5) Étapes suivantes (facultatif) : déployer sur les appareils

Une fois le PKG téléversé, vous pouvez le déployer à l’aide de l’une de ces approches :

• Politique : installez Shade à la demande (Self Service) ou automatiquement (vérification récurrente, inscription).
• Inscription PreStage : installez pendant les workflows d’inscription.

Déployer via Self Service (à la demande)

Utilisez cette méthode si vous souhaitez que Shade soit disponible dans l’application Jamf Self Service, permettant aux utilisateurs de choisir quand l’installer.

1. Créer une nouvelle politique : dans Jamf Pro, allez à Ordinateurs > Policies et cliquez sur Nouveau.
2. Charge utile générale:

   • Nom d’affichage: Installer Shade
   • Déclencheur : aucun (les politiques Self Service ne nécessitent pas de déclencheur système).
   • Fréquence d’exécution: Continue (cela permet aux utilisateurs de réinstaller l’application s’ils passent à une nouvelle machine ou la suppriment accidentellement).
3. Charge utile des paquets:

   • Cliquez sur Configurez et trouvez votre PKG Shade téléversé.
   • Assurez-vous que l’action est définie sur Installer.
4. Charge utile Self Service:

   • Cliquez sur l’onglet Self Service en haut.
   • Cochez la case Rendre la politique disponible dans Self Service.
   • Nom d’affichage Self Service: Shade
   • Nom du bouton: Installer
   • Description : fournissez une brève description (par ex., "Shade est votre gestionnaire de ressources créatives...").
   • Icône : téléversez l’icône de l’application Shade pour un rendu professionnel.
5. Portée:

   • Cliquez sur l’onglet Portée onglet.
   • Ajoutez les ordinateurs spécifiques ou les groupes intelligents (par ex. « All Managed Clients ») qui doivent voir Shade dans leur catalogue Self Service.
6. Enregistrer.

---

Déployer via une installation silencieuse (automatique)

Utilisez cette méthode si vous souhaitez que Shade soit installé automatiquement en arrière-plan sur les Mac, sans aucune interaction utilisateur.

1. Créer une nouvelle politique : dans Jamf Pro, allez à Ordinateurs > Policies et cliquez sur Nouveau.
2. Charge utile générale:

   • Nom d’affichage: Déployer Shade - Automatique
   • Déclencheur : sélectionnez Vérification récurrente (il s’agit du déclencheur standard pour les déploiements silencieux en arrière-plan).
   • Fréquence d’exécution : sélectionnez Une fois par ordinateur.
3. Charge utile des paquets:

   • Cliquez sur Configurez et trouvez votre PKG Shade téléversé.
   • Assurez-vous que l’action est définie sur Installer.
4. Charge utile de maintenance:

   • Cliquez sur Configurez et cochez la case Mettre à jour l’inventaire Cette option garantit que Jamf sait que l’application est installée immédiatement après l’exécution de la politique.
5. Portée:

   • Cliquez sur l’onglet Portée onglet.
   • Ajoutez les ordinateurs ou les groupes intelligents qui nécessitent Shade.
   • Conseil : utilisez un groupe intelligent qui cible les ordinateurs sur lesquels « Shade.app » n’est actuellement pas installé.
6. Enregistrer.

---

Vérifier le déploiement

Après avoir enregistré votre politique, vous pouvez suivre sa progression :

• Journaux : ouvrez la politique dans Jamf Pro et cliquez sur le Journaux bouton en bas à droite. Cela vous montrera quels ordinateurs ont correctement installé le paquet et lesquels sont encore en attente.
• Inventaire : vérifiez le dossier d’inventaire d’un ordinateur individuel sous Applications pour confirmer que Shade.app apparaît dans la liste.

Conseils de dépannage

• Incompatibilité d’architecture : si une installation silencieuse échoue, vérifiez que vous n’avez pas déployé un PKG Intel sur un Mac Apple Silicon (M1/M2/M3).
• FileVault : si vous déployez pendant l’inscription (PreStage), assurez-vous que les options "Fill User Template" ou "At Restart" ne sont PAS sélectionnées, car Shade doit être installé dans le /Applications dossier normalement.