INTRODUCTION

Chocolatey permet d'installer des packages provenant de sources tierces.

L'intégration de Chocolatey avec RG SYSTEM permet aux utilisateurs d'exploiter les fonctionnalités de Chocolatey associées à l'App Manager pour automatiser l'installation et la gestion d'applications sur des machines gérées via le dashboard de RG SYSTEM.

 

App Manager Legacy

Pour les utilisateurs de la précédente version de App Manager, il sera toujours possible de visualiser les politiques présentes par l’intermédiaire du bouton "Accéder à l'ancien App Manager" présent sur la page de "Gestion des applications".

bouton ancien app manager.JPG

Pour gérer ces politiques via la nouvelle version de App Manager, il faudra réinstaller les applications à partir de la page d'ajout des applications en cliquant sur le bouton "Ajouter une application".

 

SOMMAIRE

 

Prérequis

Pour déployer vos applications, App Manager s'appuie sur la version 2.0.0 de Chocolatey qui sera déployée automatiquement lors de votre premier ajout d'application.

Les machines ciblées doivent respecter les prérequis techniques minimums suivants :

  • Windows 10 / Windows Server 2012 R2
  • PowerShell 3.0
  • .NET Framework 4.8

Attention /!\

Toutes les applications installées à l'aide d'App Manager doivent être désinstallées via App Manager. Les applications désinstallées depuis le panneau de configuration à partir d'un poste utilisateur continueront à apparaître dans l'App Manager.

 

Informations avancées

A des fins d'analyse et de débogage, nous vous informons que le déploiement des applications via Chocolatey est fait via la commande suivante :

cmd /c rmdir "%programData%\\chocolatey" /Q /S & powershell $env:chocolateyVersion = '2.0.0'; Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
  • Si Chocolatey n'est pas présent sur la machine, cette commande aura pour but d'installer la version 2.0.0 de Chocolatey. 
  • Si une version différente (inférieure à la version 2.0.0) de Chocolatey est déjà présente sur la machine, une commande d'upgrade chocolatey vers la version 2.0.0 est réalisée.
    A l'inverse, si la version constatée est supérieure à la version 2.0.0, une commande
    de downgrade est réalisée pour repasser Chocolatey en version 2.0.0.
  • Si une tentative d'installation en échec est repérée sur la machine, la commande aura pour effet de supprimer tous les folders associés et a installer la version 2.0.0 de Chocolatey. 

 

Accès

Pour y accéder, cliquez sur “Actions” puis “App Manager”

menu action.JPG

 

Notion d'héritage

L'héritage est activé sur les nœuds et sur les agents. Ce paramètre par défaut facilite le déploiement d'applications en masse sur les agents d'un nœud.

Une application déployée à partir d'un nœud est étiquetée avec le label "Hérité". Cela signifie que la modification de cette application n'est autorisée qu'à partir du nœud d’où elle a été déployée.

hérité.JPG

Il est toutefois possible de surcharger une application à partir d'un héritier (agent directement). Pour ce faire,

  • Cliquez sur l'agent concerné dans votre arborescence, puis sur le menu Appmanager.
  • Ajoutez à nouveau l'application souhaitée. 

L'application est alors étiquetée avec le label "Surchargé".

surchargé.JPG

Cela signifie qu'il est maintenant possible de modifier cette application (version par exemple) depuis l'agent directement.

 

Ajouter des applications

Pour ajouter des applications, cliquez sur le bouton "Ajouter une application"

ajouter une application.JPG

Ensuite depuis la page d'ajout des applications :

  • Utilisez la barre de recherche ou défiler vers le bas pour trouver l'application que vous souhaitez
  • Cliquez ensuite sur l'application pour la sélectionner

catalaoque.JPG

Une fois la ou les applications sélectionnées; il est possible :

  • D'intégrer des paramètres d'installation (optionnel) depuis le champs "paramètre(s) d'installation(s)"
    A noter : Les paramètres d'installations sont décris dans Chocolatey.
  • De choisir la version de l'application (pour le moment 10 versions sont disponible dont la Maj auto)

version parametre.JPG


Validez votre choix en cliquant sur le bouton "Ajouter" en bas à droite de la page d'ajout des applications.

Les applications seront déployées sur votre ou vos agents (selon votre contexte) au regard de votre  programmation de déploiement. 

 

Planification

La planification permet d'organiser le déploiement d'application sur des agents en ligne.

Il est possible de planifier le déploiement sur des créneaux horaires ou des jours de semaine spécifiques.

La notion d'héritage est toujours présente (activé par défaut), ce dernier étant dissocié de l'héritage des packages.

De ce fait, quand l'héritage est activé, la planification est disponible uniquement en lecture seule.

planifi lecture seule.JPG

Il est toutefois possible de désactiver l'héritage (voir ci dessous).

planification deshérité.JPG

Dans ce cas, il est possible de configurer manuellement la planification. Le choix d'horaires ou de jours est automatiquement sauvegardé.

 

Gestion des applications

La gestion des applications permet : 

  • De visualiser les applications présentes sur le nœud ou l'agent sous forme de "Cards".
  • De gérer la version des applications déployées sur le nœud ou l'agent (voir plus haut la notion d'héritage) en cliquant sur le menu déroulant.

gestion des applications.JPG

Depuis la "Card" d'une application, il est possible :

  • D'afficher la description de l'application (directement récupérer sur le site de Chocolatey)
  • De supprimer l'application sans la désinstaller sur les postes où elle a déjà été déployée (celle-ci passe alors en statut "Hors politique" et n'est plus managée).
  • De supprimer en désinstallant l'application, qui sera supprimée à la fois de App Manager et des postes où elle a déjà été déployée. Inactif sur applications héritée
  • De visualiser les options de commande définies.

A noter : Les options de suppression (avec ou sans désinstallation) sont possibles seulement sur les applications qui sont installées en dehors de l'héritage (qu'elles soient surchargées ou non).

chocolatey.JPG

 

État des applications

Information importante

L'onglet état des applications ne liste que les applications déployées via Chocolatey.

etat des app.JPG

Voici les différents statuts qui seront affiché dans l'état des applications :

- Installée : L'application s'est installée avec succès.

- Installée (requis) : Statut dédiée à l'application Chocolatey. 

- Installation programmée : Le déploiement est programmé et l'application sera installée au regard de votre paramétrage.

- Mauvaise version détectée : La version de l'application installée ne correspond pas à celle définie pour ce package, une tentative de mise en conformité sera effectuée.

- Installation abandonnée : Si l'application n'est pas installée après 30 jours de tentatives, l'installation est annulée.

- Installation en erreur : L'installation de l'application a échoué. Pour plus d'informations vous pouvez consulter les logs en cliquant sur le statut. Une nouvelle tentative sera effectuée une fois par jour pendant 30 jours.

- Hors politique : L'application est déjà présente sur la machine sélectionnée OU a été supprimée via l'option "supprimer sans désinstaller".

 

Il est possible d'associer à votre politique de gestion toutes les applications déjà existantes sur la machine (remontées en "Hors Politique"). Pour ce faire, déclarez à nouveau l'application via AppManager :

- "Ajouter une application"

Une fois ajoutée, l'application changera de statut est passera de "Hors politique" à "Installer". Celle-ci sera automatiquement gérée par l'App Manager.

 

A noter : Il est aussi possible de visualiser directement la liste des applications installées sur un poste en utilisant l'invité de commande windows (ou RG).

  • Utilisez la commande suivante :
    choco list

Exemple :

choco list.jpg

 

En savoir plus

Responsabilité

L’utilisation de Chocolatey via l'App Manager est facultative et procède du seul choix du client.
Ce système est extérieur à RG System.

A ce titre, le client assume seul la pleine et entière responsabilité et RG System ne saurait, en aucun cas, voir sa responsabilité engagée en cas de dommage, direct ou indirect et de quelque nature que ce soit, résultant, en tout ou partie, de l’utilisation de Chocolatey.

 

Applications tierces

Il est possible d'installer des applications hors App Manager (non présentes sur Chocolatey)

Pour cela vous pouvez suivre le lien ci dessous :

https://docs.chocolatey.org/en-us/create