Tag Sentinel - Constellation

Constellation à la DevCon #4 le 26 octobre à l’école 42

Sebastien Warin — Fri, 20 Oct 2017 09:02:14 +0000

Jeudi 26 octobre 2017 se tiendra la 4ème édition de la DevCon, la conférence technique du magazine Programmez!

Le thème de cet après-midi sera 100 % Raspberry Pi & Co en production : serveur, IoT, développement, Docker.

Et à cette occasion, vous retrouverez une nouvelle fois une session dédiée à Constellation spécial Raspberry.

Au menu de cette session :

Comment déployer une Constellation sur Raspbian en une seule ligne de commande grâce au Web Platform Installer
Comment joindre des RPi v1, v2, v3 dans Constellation pour y déployer et superviser des packages (programmes) depuis une interface Web centrale
Comment développer des packages avec Visual Studio ou en ligne de commande avec le « Constellation Package Tools CLI » et les déployer automatiquement sur vos RPi
Comment vos packages Python sur RPi peuvent interagir avec vos autres systèmes et autres packages Python, C#, objets Arduino ou des ESP8266, des pages Javascript, ou autre
Comment contrôler un RPi depuis une pages Web ou une application mobile multi-plateforme avec quelques lignes !

Nous verrons également plusieurs applications concrètes déployées pour ma « smarthome » comme : S-Energy, ma solution de supervision des ressources énergique basée sur un Raspberry, S-Opener pour piloter la porte de garage depuis un Raspberry, capteurs luminosité, gestion des volets, etc…

Quand ? 26 octobre à partir de 13h30

Où : à l’école 42 (Paris)

Informations & inscriptions : https://www.programmez.com/content/devcon-4-100-raspberry-pi-co

The post Constellation à la DevCon #4 le 26 octobre à l’école 42 appeared first on Constellation.

Constellation 1.8.3 est disponible

Sebastien Warin — Wed, 12 Jul 2017 12:50:01 +0000

La nouvelle version 1.8.3 de la plateforme Constellation disponible depuis lundi 10 juillet 2017 sur l’environnement “beta” vient tout juste d’être validée sur l’environnement “Stable” aujourd’hui-même !

Vous pouvez mettre à jour votre installation en lançant le « Web Platform Installer » sur Windows :

Constellation Web Platform Installer » Article
Constellation-Web-Platform-Installer-1.9.735.exe
Version: 1.9.735

1.2 MiB
2136 Downloads
Détails

Ou, sur Linux, en lançant la commande :

wget -O install.sh https://developer.myconstellation.io/download/installers/install-linux.sh && chmod +x install.sh && ./install.sh

Constellation Server 1.8.3

Tout d’abord les dépendances du serveur Constellation ont été mises à jour : Json.NET 9.0.1, NLog 4.4.11, SignalR 2.2.2 et enfin la stack OWIN en version 3.1. Chacune d’entre elles apportant des correctifs et améliorations de performance.

La modification la plus importante de cette version 1.8.3 est la refonte complète de la gestion des packages au niveau du serveur. En effet, jusqu’à présent seuls les packages réels (et non virtuels) étaient gérés par le hub de contrôle. Pour les packages virtuels, il fallait exploiter l’API de Management (ou lire la configuration XML) car ils n’existaient pas sur le hub de contrôle (d’où le terme “virtuel”).

Désormais, chaque package déclaré dans la configuration d’une Constellation, qu’il soit réel ou virtuel, est chargé sur le hub de contrôle. Il n’y a donc plus de Statut en “N/A” sur la Console Constellation : tous les packages ont par défaut un état à “Unknown”. Une simple connexion sur le hub de contrôle permet donc de récupérer l’intégralité des packages d’une Constellation sans devoir combiner des informations venant de la configuration XML pour y ajouter la partie « virtuelle ».

De plus les packages virtuels initialisant des abonnements aux messages ou StateObjects sont maintenant marqués comme “connecté” sur le hub de contrôle permettant de suivre leurs états. Par exemple, un Arduino/ESP est maintenant vu comme connecté sur le hub de contrôle :

Aussi chaque package envoie désormais, en plus de son n° de version et de la libraire Constellation utilisée, le type de la libraire utilisée : il s’agit de la propriété “ConstellationClientType”.

Aussi, il est possible définir le répertoire de base de la Constellation dans lequel trouver le fichier de configuration en spécifiant la clé « Constellation.BaseDirectory ». Cela permet de séparer les binaires Constellation de sa configuration, très utile dans un environnement Docker. Un article sur le sujet sera prochainement publié.

Outre différentes optimisations du code et correction de défauts mineurs on peut aussi noter :

Server / ControlHub : le ReloadServerConfiguration envoi la liste des packages aux sentinelles seulement connectées et « Update settings » sur les packages connectés seulement et non à tous les groupes
Server / ControlHub : prise en charge des mises à jour de configuration des packages à volée
Server / Management API : ajout d’un objet de synchronisation pour les I/O vers le fichier de configuration pour éviter les écritures concurrentes
Server / Licensing : LeaseLicensing dans le domaine serveur si multi-tenant sinon dans le domaine de la constellation si mono-instance (permettant ainsi de récupérer les erreurs de licence dans la Console Log)
Server / API REST : le timeout des sessions HTTP est maintenant de 150 secondes par défaut configurable dans le fichier de configuration

Enfin notez que le serveur 1.8.3 est rétrocompatible avec les différents composants Constellation 1.8.x, que ce soit pour la Console, les packages ou les sentinelles. Autrement dit vous pouvez mettre à jour votre serveur en 1.8.3 tout en gardant vos packages et sentinelles 1.8.x fonctionnelles.

Constellation Sentinel 1.8.3

L’autre grande nouveauté de cette nouvelle version 1.8.3 est la refonte complète du gestionnaire de processus sur les sentinelles.

Jusqu’à présent lorsqu’une sentinelle recevait sa liste des packages, elle se chargeait de télécharger et démarrer chaque package de sa liste. Si le package était déjà en fonctionnement elle levait un Warning ce qui avait tendance à “polluer” les logs notamment lorsqu’on déployé la configuration au niveau d’une Constellation. Enfin lorsqu’un package en fonctionnement était supprimé de la liste, elle fermait le processus associé.

Le problème dans ce mécanisme est que si vous arrêtez un package et que vous redéployer la configuration, par exemple en ajoutant, supprimant ou modifiant les settings d’un autre package, la liste était renvoyée à votre sentinelle qui relançait “bêtement” le package vous avez arrêté !

C’est pour cela que le fonctionnement interne de la sentinelle a été profondément revu et a conduit à la réécriture complète du mécanisme de gestion des processus. Ainsi la description de chaque package, démarré ou non, est maintenue en mémoire. Lorsqu’une sentinelle reçoit sa nouvelle liste, elle est toujours capable de charger/démarrer les nouveaux packages et supprimer/arrêter les packages retirés mais les packages existants ne sont pas redémarrés automatiquement, ils conservent leurs états.

Cette refonte a amélioré beaucoup de chose en apportant plus de fiabilité et stabilité dans le suivi du processus et elle apporte une meilleure cohérence des états de chaque package.

Aussi, comme le serveur, les dépendances ont été mises à jour : Json.NET 9.0.1, SignalR 2.2.2, NLog 4.4.11 et NLog.Windows.Form 4.2.3 pour la Sentinelle UI.

Notez enfin qu’une sentinelle 1.8.3 peut fonctionner sans aucun problème dans une Constellation 1.8.x de version antérieure tout comme une sentinelle antérieure à la version 1.8.3 pour fonctionner sur une Constellation 1.8.3.

Constellation Console 1.8.3

La Console Constellation a aussi reçu sont lot de nouveautés à l’occasion de cette nouvelle release 1.8.3.

Etant donné la refonte dans la gestion des packages sur le hub de contrôle, la Console Constellation a été impacté à ce niveau. Elle se base exclusivement sur le hub de contrôle sans devoir interroger la Management API en parallèle pour intégrer les packages virtuels ou non connectés.

Suite à la publication des nouvelles librairies Javascript et AngularJS 1.8.2 du mois dernier, les codes snippets du MessageCallbacks Explorer ont été mis à jour pour intégrer les nouveautés de ces librairies.

On notera aussi l’ajout d’un bouton pour vider la Console Log, l’ajout ConstellationClientType sur les packages ou encore du credential utilisé par une sentinelle sur la fenêtre de détail. Aussi la Console supporte pleinement les utilisateurs connectés sans droits de Management.

Mais aussi :

Console / Package : Gestion des packages virtuels avec un statut Unknown, menu contextuel synchronisé et mise à jour de l’activité pour les packages virtuels
Console / Packages : « Update Settings » affiché dans le menu contextuel si le package est connecté et démarré (package virtuel compris)
Console / Packages : bugfix sur le déploiement de package avec un setting de type DateTime (module $filter non injecté dans le contrôleur principal)
Console / Packages : bugfix sur le déploiement de la configuration une fois que le SetRecoveryOption est terminé et non en parallèle
Console : déconnexion des deux hubs (consumer et controller) si l’un des deux est déconnecté (cas très rare où l’un des deux hubs parvient à se reconnecter et pas l’autre)
Console : Mise à jour de l’API Constellation Javascript & AngularJS en version 1.8.2 et de la librairie SignalR 2.2.2

Autres nouveautés

La librairie .NET pour les packages a été mise à jour en version 1.8.3.17190, et est disponible sur le repository Nuget. Cette nouvelle version envoie le “ConstellationClientType” ( net40 » ou « net45 ») lors de la connexion de votre package à Constellation. De plus les dépendances ont été mises à jour vers JSON.NET 9.0.1 et SignalR 2.2.2.

Notez enfin qu’un package exploitant l’API 1.8.3 peut fonctionner sans aucun problème sur une Constellation 1.8.x de version antérieure tout comme un package antérieure à la version 1.8.3 peut fonctionner sur une Constellation 1.8.3.

Une nouvelle version SDK est également disponible. Il intègre une mise à jour des templates de projet Constellation pour prendre en compte les dernières versions des API 1.8.3.

Pour finir le Web Platform Installer pour Linux a lui aussi été mis à jour. Il garde en mémoire le jeton d’authentification entre les différents installeurs Server, Sentinel et Console de façon à éviter de devoir se ré authentifier à chaque composant mais surtout le pilotage des services Server et Sentinel dans Supervisor est désormais basé sur “supervisorctl” pour une gestion plus fine des services.

Pour consulter le changelog complet de cette nouvelle version cliquez ici. N’hésitez pas non plus à remonter vos feedbacks sur le forum.

The post Constellation 1.8.3 est disponible appeared first on Constellation.

Constellation 1.8.1 est disponible

Sebastien Warin — Fri, 16 Sep 2016 13:11:42 +0000

Après deux mois en “Release Candidate”, la version 1.8.1 de la plateforme Constellation est disponible pour tous sur l’environnement de production “stable”.

Vous pouvez donc mettre à jour votre installation en lançant le « Web Platform Installer » :

Constellation Web Platform Installer » Article
Constellation-Web-Platform-Installer-1.9.735.exe
Version: 1.9.735

1.2 MiB
2136 Downloads
Détails

Ou sur Linux en lançant la commande suivante :

wget -O install.sh https://developer.myconstellation.io/download/installers/install-linux.sh && chmod +x install.sh && ./install.sh

A ce sujet, le « Web Platform Installer » pour Linux a été revu pour corriger les différents bugs remontés par la communauté.

Constellation Server 1.8.1 : ajout des compteurs de performance et nouvelle API de Management

Outre la refonte du manageur de StateObject et diverses optimisations et corrections de bugs mineurs, la nouvelle version du serveur Constellation supporte les compteurs de performance sous Windows pour pouvoir suivre l’activité du serveur.

Vous trouverez dans l’analyseur de performance Windows une nouvelle catégorie Constellation avec l’ensemble des compteurs du serveur :

L’autre grande nouveauté concerne l’API de Management. Elle met à disposition une API HTTP/REST d’édition de la configuration de votre Constellation :

Gestion des sentinelles
Gestion des packages
Gestion des groupes
Gestion des settings
Gestion des RecoveryOptions
Gestion des credentials et autorisations
Gestion du Package Repository et upload de package
Gestion de la licence
Lire / Ecriture du fichier de configuration
Récupération du numéro de version du serveur
Rechargement et déploiement de la configuration

Vous trouverez sur cette page la documentation complète relative à cette API.

Constellation Sentinel 1.8.1

Les sentinelles remontent désormais au serveur des informations quant au moteur .NET utilisé et prennent en compte les changements de configuration des RecoveryOptions même si le package est déjà démarré. Aussi diverses optimisations et correctifs de bugs mineurs sont embarqués dans cette mise à jour.

Constellation Console 1.8.1 : une console vraiment complète !

C’est certainement la principale nouveauté de cette release 1.8.1 : l’évolution majeure de la Console !

Couplée à l’API de Management du serveur Constellation 1.8.1, il est désormais possible de configurer / piloter la quasi-totalité de Constellation depuis l’interface graphique de la Console sans devoir éditer le fichier de configuration XML manuellement.

De plus, cette version ajoute le catalogue en ligne de package Constellation directement dans la Console.

Gestion des sentinelles et packages

Il est maintenant possible d’ajouter, éditer ou supprimer les sentinelles depuis l’interface graphique.

De la même façon, il est possible de déployer des packages sans devoir éditer le fichier de configuration XML grâce à un assistant de déploiement :

De plus il est maintenant possible d’éditer la configuration ou les paramètres (settings) d’un package, de gérer les groupes de messages ou encore de supprimer les packages depuis l’interface de la Console :

Gestion des settings

La Console 1.8.1 rend possible l’édition des settings des packages sur base du manifeste. La Console tient compte des différentes informations contenues dans le manifeste comme les valeurs par défaut, le type du setting, son caractère obligatoire ou non, etc..

De plus l’éditeur s’adaptera en fonction du type du setting (types simples, section XML ou JSON) :

Le catalogue de package en ligne

Le catalogue de package officiel est directement intégré dans la console ce qui vous permettra de déployer des nouveaux packages ou les mises à jour sans quitter votre Console Constellation.

Gestion des crédentials et des autorisations

Il est désormais possible de gérer les crédentials depuis l’interface de la Console sans devoir éditer la configuration XML :

De plus, les autorisations sont également éditables depuis la Console :

Editeur de configuration

L’éditeur de configuration a évolué afin d’ajouter l’IntelliSense sur du base du schéma de configuration de Constellation pour simplifier l’édition bien qu’avec cette nouvelle version 1.8.1 il n’est plus tellement nécessaire de devoir éditeur ce fichier manuellement, l’interface de la Console permet la quasi-totalité des opérations.

Pour consulter le changelog complet de la version 1.8.1 :

N’hésitez pas à remonter vos feedbacks sur le forum.

The post Constellation 1.8.1 est disponible appeared first on Constellation.

Installer la plateforme Constellation 1.8

Sebastien Warin — Sun, 13 Mar 2016 18:22:53 +0000

Après avoir introduit Constellation, découvrons comment installer la plateforme sur vos ordinateurs ou serveurs.

Prérequis

La plateforme Constellation se compose :

d’un serveur qui héberge et expose la Constellation en HTTP/s (un serveur = une Constellation)
de sentinelles (UI ou Service) à installer sur vos différentes machines (tout système Windows ou Linux)
d’une Console d’administration : application Web de pilotage de votre Constellation

Vous pouvez installer le serveur Constellation sur une machine Windows ou Linux, que ce soit un laptop, un desktop, un NUC, un SoC, un serveur local ou dans le Cloud.

Dans la rubrique Constellation Server vous retrouverez plusieurs articles sur les différentes installations possibles (système Linux, Raspberry, cloud Azure ou Amazon, etc…).

Pour démarrer, nous allons déployer dans ce guide une Constellation complète (serveur, sentinelle, console et le SDK) sur une machine Windows.

Vous avez donc besoin pour suivre ce guide :

d’un ordinateur ou serveur sous Windows (Windows 7/8/10 ou Windows Server)
Pour installer le SDK : Visual Studio 2015, 2017 ou 2019

Si vous ne disposez pas de licence de Visual Studio, vous pouvez installer la version “Community”, une version gratuite de Visual Studio compatible avec le SDK Constellation : https://www.visualstudio.com/fr-fr/products/visual-studio-community-vs.aspx

Télécharger la plateforme Constellation

Sur la page de téléchargement vous trouverez plusieurs programmes d’installation pour chaque composant Constellation :

Le serveur
Les sentinelles (UI ou Service)
La console
Le SDK Visual Studio

Mais pour gagner en productivité, vous avez à votre disposition le “Web Platform Installer” (WPI), un programme d’installation tout-en-un qui télécharge automatiquement et configure les composants que vous souhaitez installer.

Commencez donc par télécharger le programme “Constellation Web Platform Installer” pour Windows :

Constellation Web Platform Installer
Constellation-Web-Platform-Installer-1.9.735.exe
Version: 1.9.735

1.2 MiB
2136 Downloads
Détails

Installer la plateforme

Etape 1 : lancement de l’installation

Lancez le programme “Constellation Web Platform Installer.exe”

Etape 2 : identification

Vous devez dans cette étape renseigner votre compte myConstellation.io afin de pouvoir télécharger les composants Constellation et accéder à vos licences :

Etape 3 : acceptez la licence d’utilisation

Vous retrouverez le détail des licences Constellation sur cette page. Pour résumer, Constellation est gratuit pour un usage personnel ou éducatif sans aucun but lucratif et soumis à l’acquisition d’une licence pour un usage professionnel ou entreprise.

Etape 4 : choix du canal de distribution

Vous devez sélectionner le canal de distribution à utiliser : Stable ou Pre-release (versions Beta) :

Etape 5 : répertoire d’installation

Vous devez choisir le répertoire d’installation racine de la plateforme Constellation :

Etape 6 : sélectionnez les composants Constellation à installer

Vous pouvez sélectionner ici les composants à installer ou utiliser les profils prédéfinis :

Full server installation : installation typique pour un serveur (le serveur, la sentinelle en version service et la console Constellation)
Full developer installation : installation typique pour un poste de développement (le serveur, la sentinelle UI, la console et le SDK Visual Studio)
Custom installation : sélectionnez à la carte les composants que vous souhaitez installer

Notez que le WPI vous indiquera la dernière version de chaque composant à installer et est capable de déployer les mises à jour pour chacun de ces composants si une nouvelle version plus récente est disponible.

Notez également que si Visual Studio n’est pas installé, le composant SDK sera grisé avec la mention “Not applicable”.

Dans ce guide, sélectionnons le profil “Développeur” :

Etape 7 : configuration du serveur Constellation

Entrons désormais dans les étapes de configuration de chacun des composants à installer en commençant par le serveur Constellation.

Etape 7.1 : sélection de la licence

Premièrement, vous devez sélectionner une licence pour l’utilisation du serveur. Vous pouvez utiliser une licence que vous aurez préalablement téléchargée depuis le portail Constellation ou vous connecter directement sur le service de licence de Constellation depuis le WPI :

Vous obtiendrez l’ensemble des licences associées à votre compte avec la possibilité de créer des licences gratuites pour un usage personnel (plus d’information ici).

Dans notre cas créons une licence personnelle :

Etape 7.2 : choix du répertoire des packages

Dans cette étape vous devez définir le répertoire pour votre catalogue de packages de votre Constellation.

Par défaut, il s’agit du sous-dossier “Packages” de votre répertoire d’installation :

Etape 7.3 : choix du port d’écoute du serveur

Le serveur Constellation utilise le protocole HTTP pour exposer ses différents hubs et API. Pour cela vous avez besoin de choisir le port d’écoute et de l’ouvrir au niveau de votre firewall.

L’assistant peut déclarer le port que vous avez choisi dans le pare-feu de Windows. Si vous souhaitez ouvrir Constellation à l’extérieur de votre réseau local, à vous d’ouvrir le port sur votre routeur.

A noter que vous pouvez déclarer dans la configuration du serveur Constellation sur plusieurs ports HTTP et/ou HTTPS ou même définir un chemin HTTP personnalisé. Il est d’ailleurs conseillé d’activer le protocole HTTPS si vous souhaitez exposer votre serveur Constellation sur Internet. Vous retrouverez plusieurs articles sur la configuration avancée du serveur dans la rubrique Constellation Server.

Etape 7.4 : choix des clés d’accès

Pour se connecter à Constellation vous avez besoin de créer des clés d’accès (les “Access Keys”). Dans le cas d’une nouvelle installation, l’assistant vous proposera de créer deux clés :

Une clé “Standard” (accès de base) que vous utiliserez pour connecter vos sentinelles et packages
Une clé “Administrator” qui dispose des droits d’accès au hub de contrôle (pour le pilotage de la Constellation) et à l’API de Management (pour la configuration du serveur) :

Une clé d’accès est une chaîne de caractère. Il est conseillé de choisir des clés d’accès assez longues (> 16 caractères) et compliquées.

Pour simplifier leurs mémorisations et générations, Constellation propose d’utiliser un couple login/password pour créer des clés d’accès. Pour cela, on utilise le hash SHA1.

Exemple : pour le login “Admin” et le mot de passe “Password”, la clé d’accès sera “d882b8721a224d38ebb54559e6b54e5df3a1bc6d » (soit SHA1(“AdminPassword”)). Notez bien que la casse est importante !

Dans l’assistant d’installation, cliquez sur le bouton “Use Password” pour renseigner un couple login/password afin de générer les Access Keys :

Pour finir, vous pouvez ajouter le droit de débogage sur la clé “Administrator” en cochant la case correspondante. Cela nous permettra de tester des packages connectés à votre Constellation depuis Visual Studio.

Etape 8 : configuration de la Console Constellation

Comme la Console Constellation est déployée sur la même machine que le serveur Constellation, l’assistant vous propose héberger la console par le serveur Constellation lui-même.

Si vous désirez utiliser votre propre serveur Web pour exposer la Console (Apache, IIS ou autre) sélectionnez la deuxième option mais dans notre guide laissons le serveur Constellation héberger la console :

Vous pouvez ensuite fixer une clé d’accès en dur ou utiliser une page de login. De plus vous pouvez également restreindre l’accès à la console en local seulement.

Laissons les options par défaut (c’est à dire Console ouverte à tous avec une page de login) :

Etape 9 : configuration de la Sentinelle Constellation

Dans la sélection des composants nous avons indiqué vouloir installer la sentinelle UI. Vous arrivez donc à cette étape de configuration.

Comme la sentinelle est installée sur la même machine sur le serveur, vous pouvez l’inclure automatiquement dans votre Constellation ou bien l’inclure dans une autre Constellation en sélectionnant la deuxième option.

Dans notre cas, laissons la première option sélectionnée pour ajouter notre sentinelle UI à notre Constellation en cours d”installation :

Etape 10 : Installation

La configuration des composants est désormais terminée. Vous retrouverez tout le détail sur l’écran de confirmation :

En cliquant sur le bouton “Install”, le Web Platform Installer va télécharger les dernières versions de composants Constellation à installer :

Puis il déroulera l’installation et la configuration de chacun de ces composants :

A la fin de l’installation, l’assistant vous proposera de lancer la Console et la Sentinelle UI (car ces deux composants ont été installés) :

Etape 11 : Validation de l’installation

En fermant le programme d’installation, la sentinelle UI va être lancée :

En double-cliquant sur l’icone vous pourrez visualiser les logs de cette sentinelle qui doit être correctement connectée au serveur :

Vous aurez également la Console Constellation qui se lancera dans votre navigateur Internet par défaut :

Utilisez le Login/Password de la clé d’accès “Administrator” pour vous connecter. Sur la page “Sentinels” vous devriez voir votre sentinelle UI locale connectée :

Bravo vous avez déployé votre première Constellation avec succès !

Optionnellement : ajouter ou mettre à jour un composant

Vous pouvez à tout moment relancer le “Web Platform Installer” (WPI) pour ajouter ou mettre à jour des composants Constellation.

Ainsi quand des mises à jour Constellation sont disponibles, vous avez juste à relancer le WPI et vous laissez guider par l’assistant.

Dans notre exemple, relançons le WPI. Comme nous le montre l’écran ci-dessous, tous les composants sont bien à jour mais vous pouvez encore ajouter la “Sentinel Service” sur cette machine :

Vous entrez alors dans la configuration de la sentinelle avec la possibilité d’ajouter cette nouvelle sentinelle à votre Constellation locale (car précédemment installée) ou de l’ajouter à une autre Constellation.

Next steps

Ajoutez des sentinelles dans votre Constellation
Téléchargez et déployez des packages sur vos sentinelles
Exposer votre serveur Constellation derrière avec reverse proxy IIS ou Nginx et ajouter le support du HTTPS/SSL

Vous souhaitez installer le serveur et sa console sur un système Linux ?

Installer Constellation sur Linux

Prêt pour développer avec Constellation ?

The post Installer la plateforme Constellation 1.8 appeared first on Constellation.

Ajouter des sentinelles dans votre Constellation

Sebastien Warin — Wed, 30 Mar 2016 15:26:53 +0000

Les sentinelles sont des agents exécutés sur des systèmes Windows ou Linux qui, connectés à votre Constellation, permettent de déployer des packages Constellation.

En suivant le guide d’installation vous avez pu installer une sentinelle Service ou UI sur la même machine que le serveur Constellation.

Voyons maintenant comment installer des sentinelles sur vos autres machines (laptops, desktop, serveurs, Raspberry, etc..).

Prérequis

Il existe deux types de sentinelle :

La “Sentinel Service” : il s’agit d’un service compatible Windows et Linux qui tourne en arrière plan et permet de déployer des packages Constellation sans interface graphique.
La “Sentinel UI” : il s’agit d’une application Windows s’exécutant au sein d’une session Windows et permettant de déployer des packages Constellation avec interface graphique (dit Package UI) ou encore des packages ayant besoin d’interagir avec la session de l’utilisateur.

Les prérequis pour installer une sentinelle sont :

Un système Windows avec le .NET Framework 4.0 installé (soit au minimum un Windows XP SP3 ou un Windows 2003 SP2)
Un système Linux avec Mono 3.10 au minimum

Note : la sentinelle UI n’est disponible que pour Windows.

Installation d’une sentinelle sur un système Windows

Les installeurs pour la sentinelle Service et UI sont similaires, la procédure d’installation est donc identique.

Note : vous pouvez installer sur la même machine une sentinelle UI et une sentinelle Service.

Pour cela, vous pouvez soit télécharger le programme d’installation spécifique à la Sentinelle UI et/ou Service ou, pour faire plus simple, utiliser le “Web Platform Installer” pour installer et mettre à jour les dernières versions des composants Constellation.

Etape 1 : lancez le “Web Platform Installer

Constellation Web Platform Installer » Article
Constellation-Web-Platform-Installer-1.9.735.exe
Version: 1.9.735

1.2 MiB
2136 Downloads
Détails

Etape 2 : sélection des composants

Commencez par vous identifier avec votre compte Constellation et acceptez la licence d’utilisation avant de pouvoir sélectionner les composants à installer :

Dans le cas ci-dessus, nous avons déjà installé la dernière version du SDK Constellation comme vous pouvez le constater !

Dans ce guide nous allons installer les deux sentinelles (UI et Service) que nous connecterons à notre Constellation précédemment installée sur une autre machine.

Etape 3 : type d’installation des sentinelles

Vous avez ensuite le choix entre :

Installer la sentinelle et l’enregistrer dans votre Constellation en utilisant l’API de Management (il vous faudra connaitre une AccessKey qui a les droits de management pour procéder à l’enregistrement).
Installer la sentinelle seulement

Bien entendu pour automatiser le processus, choisissons la première option :

Notez que si vous souhaitez ajouter une sentinelle sur un système sur lequel un serveur Constellation est installé, l’assistant vous proposera d’installer et d’enregistrer automatiquement votre sentinelle sur le serveur local.

Etape 4 : sélection du serveur Constellation à joindre

Vous devez indiquer l’URI de votre serveur Constellation ainsi que la clé d’accès avec les droits d’administration pour enregistrer vos sentinelles.

Dans cet exemple le serveur Constellation est accessible sur l’URL “http://pc-seb.ajsinfo.loc:8088/” avec le couple “admin/password” (cliquez sur le bouton “Use Password” pour générer l’AccessKey à partir de ce couple) :

Etape 5 : choix de la clé d’accès pour la sentinelle

Vous aurez ensuite à choisir parmi les clé d’accès configurées sur votre serveur, laquelle doit être utilisée pour la connexion de vos sentinelles :

Etape 6 : installation

Il ne vous reste plus qu’à confirmer l’installation :

L’installeur téléchargera et installera les composants puis réalisera l’enregistrement vos deux nouvelles sentinelles sur votre serveur Constellation avant de lancer le service (pour la Sentinel Service) ou l’application (pour la Sentinel UI).

Depuis la Console Constellation, nous pouvons observer nos deux nouvelles sentinelles (PO-SWARIN et PO-SWARIN_UI) fraichement connectées :

Installation d’une sentinelle sur un système Linux

Sur un système Linux utilisez le “Web Platform Installer” pour automatiser le processus d’installation et de configuration.

Le WPI se chargera d’installer tous les prérequis (Mono, Python, PIP, etc..) et les dernières versions des composants Constellation.

Etape 1 : lancez le “Web Platform Installer

Pour lancer le WPI entrez la commande suivante :

wget -O install.sh https://developer.myconstellation.io/download/installers/install-linux.sh && chmod +x install.sh && ./install.sh

Le programme d’installation doit être lancé en “root” pour cela, le script se relancera automatiquement en “sudo” si la commande est présente. Autrement il tentera de se relancer automatiquement en “su root”. Si cette commande n’existe pas non plus, il affichera un message d’erreur. Vous aurez alors besoin de relancer manuellement le script “install.sh” en root.

Avec “sudo” ou “su root”, vous aurez dans certain cas besoin de fournir votre mot de passe “root” pour pouvoir autoriser le script d’installation à se lancer :

Le script va vérifier les prérequis à savoir :

Python (2.7 ou 3.x)
Python-dev
Mono 3.10 sur un ARMv6 ou autrement Mono 3.12 minimum
Supervisor

Sur un système Debian ou dérivé, le programme d’installation vous proposera d’installer automatiquement les prérequis si besoin.

Etape 2 : sélection des composants

Une fois les prérequis validés, vous pourrez choisir les composants Constellation à installer :

Dans ce guide, sélectionnons le composant “Sentinel”. Vous commencerez par accepter la licence d’utilisation :

Puis vous devrez renseigner vos identifiants de votre compte myConstellation.io :

Définissez ensuite le répertoire d’installation de la sentinelle sur votre système :

Etape 3 : sélection du serveur Constellation à rejoindre

Renseignez maintenant l’URI de votre serveur Constellation sur laquelle votre sentinelle doit se connecter :

Etape 4 : type d’installation de la sentinelle

Comme pour l’installation d’une sentinelle sous Windows, indiquez si vous souhaitez également procéder à son enregistrement :

Au quel cas il faudra spécifier un compte avec les droits de management pour pouvoir joindre la sentinelle dans votre Constellation :

Etape 5 : choix de la clé d’accès pour la sentinelle

Vous pourrez ensuite choisir parmi les clé d’accès configurées sur votre serveur, laquelle doit être utilisée par votre sentinelle :

Etape 6 : prérequis pour les packages Python

Enfin si vous comptez déployer des packages Constellation Python vous devez installer le runtime Python ainsi que différentes librairies (plus d’informations).

Le WPI vous proposera d’installer ces prérequis pour vous de manière automatique :

Etape 7 : installation et démarrage

Le WPI procèdera à l’installation et à la configuration de la sentinelle et des prérequis.

A la fin de ce processus, la sentinelle sera automatiquement démarrée :

En retournant sur la Console de notre Constellation, on pourra constater qu’une nouvelle sentinelle ici nommée “rpi2” s’est bien connectée dans notre Constellation :

Votre sentinelle Linux est prête, vous pouvez maintenant y déployer des packages ou développer vos propres packages en C# ou en Python.

The post Ajouter des sentinelles dans votre Constellation appeared first on Constellation.

Le fichier de configuration

Sebastien Warin — Tue, 09 Aug 2016 12:52:30 +0000

Une Constellation est décrite en un seul fichier : le fichier de configuration Constellation.

Ce fichier se nomme “Constellation.Server.exe.config” et se trouve dans le répertoire d’installation du serveur (par défaut dans “Program Files\Constellation Plateform\Server« ).

Vous pouvez le modifier de différente manière :

En éditant ce fichier directement sur le serveur (avec un éditeur de texte type Notepad)
Via la Console Constellation (sur la page Configuration Editor)
Via Visual Studio
Via l’API de Management Constellation

Le fichier contient une balise globale “configuration” dans laquelle vous trouverez 4 sections :

configSections : réservé au moteur .NET
constellation : la section de configuration Constellation (anciennement nommée ‘constellationSection’)
startup : réservé au moteur .NET
runtime : réservé au moteur .NET

Vous ne devez en aucun cas modifier les sections réservées au moteur .NET sans savoir exactement ce que vous faites.

La section de “constellation” se décompose de la façon suivante :

listenUris : définit la configuration des URI d’écoute du serveur Constellation
fileServer : définit la configuration du serveur Web statique utilisé pour l’hébergement de la Console Constellation
recoveryOptions : définit les options de récupération des packages
sentinels : définit la configuration des sentinelles (et des packages) de votre Constellation
settingsGroups : définit la configuration des groupes de “settings”
credentials : définit la configuration des credentials pour l’accès à votre Constellation

A chaque modification vous devez recharger la configuration soit via le hub de contrôle ou la Console Constellation (bouton “Reload Configuration”) ou soit en redémarrant le service Constellation Server.

Section “listenUris”

Cette section permet de définir les URI sur lesquels le serveur Constellation doit écouter.

Ici le serveur répondra sur le port HTTP 8088 quelque soit le host (nom DNS ou adresse IP) car nous utilisons le wildcard “+” (pour plus d’information, lisez ceci).

Vous pouvez configurer autant de “listenUri” que vous souhaitez. Par exemple :

Ici, le serveur Constellation répondra :

Aux requêtes sur le port HTTP 8088
Aux requêtes sur le port HTTP 8888 où le host est “constellation.mydomain.net” (en clair une requête http://:8888 ne fonctionnera pas)
Aux requêtes sur le port HTTP 8080 quelque soit le host mais dont le path doit forcement démarrer par “/constellation/”
Aux requêtes sur le port HTTPS 8089 en utilisant un cryptage SSL (plus d’information)

Pour prendre en compte les modifications de cette section vous devez redémarrer le service Constellation.

Section “fileServer”

Cette section permet d’activer et configurer le “fileServer” de Constellation pour héberger des fichiers statiques (pages HTML, fichiers CSS, JS, images, etc..).

Cela sert principalement pour “auto-héberger” la Console Constellation par le serveur Constellation lui-même.

En effet, la Console Constellation n’est ni plus ni moins qu’une application Web client-side, c’est à dire une série de pages HTML avec scripts JS et fichiers CSS/Image. Libre à vous de l’héberger sur vos serveurs Web mais afin de limiter les prérequis, le serveur Constellation peut lui-même héberger la console grâce au “fileServer” intégré.

La section “fileServer” ne contient que quatre attributs :

“enable” : indique si le serveur de fichier statique sur le serveur Constellation doit être activé (true ou false).
“path” : le répertoire d’écoute (préfixé par la listenUri).
“localhostOnly” : indique si le fileServer répond seulement aux requêtes “locales” ou à toutes les requêtes (true ou false).
“physicalPath” : le répertoire physique

Dans l’exemple ci-dessus, le serveur de fichier est activé mais ne répondra qu’aux requêtes locales. Le serveur délivra les fichiers dans “D:\App\Constellation\Console” sur l’URL “/WebConsole” par exemple http://localhost:8088/WebConsole ou http://127.0.0.1:8088/WebConsole en partant du principe qu’il existe une listenUri “http://+:8088”.

Comme pour la section précédente (listenUris), il faut obligatoirement redémarrer le service Constellation Server pour prendre en compte ces modifications.

Section “recoveryOptions”

Les options de récupération (recoveryOptions) permettent de définir le comportement de la sentinelle en cas d’arrêt brutale de l’exécution d’un package (crash du package).

Chaque package peut avoir ses propres options de récupération mais cette section permet de définir les options “globales”, c’est à dire appliqué par défaut pour chaque package de la Constellation.

Les options de récupérations se résume en quatre propriétés :

“restartAfterFailure” (true par défaut) : définit si la sentinelle doit redémarrer un package en cas de crash de ce dernier
“numberOfRetry” (3 par défaut) : définit le nombre maximal de tentative de redémarrage d’un package
“restCounterAfterMinutes” (15 par défaut) : définit la période (en minute) au delà de laquelle le compteur d’erreur est réinitialisé
“restartPackageAfterSeconds” (30 par défaut) : définit le délai d’attente avant de redémarrer un package suite à un crash

Dans la configuration par défaut, si un package “crash” il est automatiquement redémarré 30 secondes après son crash dans la limite de 3 tentatives sachant qu’au bout de 15 minutes, le compteur de tentative est réinitialisé à 0.

Section “sentinels”

Dans cette section vous allez déclarer vos sentinelles (virtuelles ou non) dans lesquelles vous déclarerez les packages (virtuels ou non) qui eux même déclarons leurs settings et leurs groupes.

En clair, c’est cette section qui décrit votre “Constellation”.

Prenez l’exemple de la Constellation suivante :

Voici ce qu’elle décrit :

Nous avons deux sentinelles “SENTINEL-NAME-DEMO” et “ANOTHER-SENTINEL »
Les deux sentinelles utilisent le même credential “Standard” (déclaré dans la section credentials).
Sur la première sentinelle est déployée deux packages :
- “HWMonitor” : le package utilise le même credential que sa sentinelle (car non défini explicitement donc hérite du credential de sa sentinelle)
- “DemoPackage” : ce package utilise le credential nommé “ControlHubAccess” et déclare les settings suivants :
  - IntSetting et StringSetting associés à des valeurs (numérique et string)
  - SettingXml et SettingJson associés à des contenus (XML et JSON)
  - Importe le groupes de settings nommé “GroupSettingsDemo” défini dans la section “settingsGroups”

Les sentinelles

Pour entrer dans le détail, vous allez déclarer dans la section “sentinels”, les sentinelles de votre Constellation que ce soit des sentinelles réelles ou virtuelles.

Pour cela, vous utiliser la balise “” qui comporte les attributs suivants :

“name” : le nom de la sentinelle (obligatoire et unique)
“credential” : le nom du credential (déclaré dans la section credentials) à utiliser pour l’authentification (obligatoire)

La section “” contient une collection de “” rangée dans la balise “”. Chaque package peut-être réel ou virtuel.

Les packages

L’élément “” contient les attributs suivants :

“name”: le nom de l’instance du package (obligatoire et unique)
“filename” (facultatif) : le nom du fichier du package à utiliser dans le repository (plus d’info)
“enable” (facultatif, par defaut true) : indique si le package est activé ou désactivé
“credential” (facultatif, utilise par défaut du credential de sa sentinelle) : spécifie le credential que le package va utiliser pour s’authentifier sur le serveur Constellation
“autostart” (facultatif, par defaut true) : indique si le package doit automatiquement démarrer sur sa sentinelle ou juste être déployé (et donc démarré manuellement)

Un package peut contenir ensuite trois sous sections :

“recoveryOptions” : définit les options de récupération du package (par défaut, la sentinelle utilise les options globales)
“settings” : définit les paramètres/variables de configuration d’un package
“groups” : définit les groupes dans lesquels le package sera abonné

Les options de récupérations

La balise est la même que la section globale.

Par exemple si on ne souhaite pas que le package redémarre en cas de crash, on peut écrire :

Les paramètres de configuration

Chaque package peut définir des paramètres de configuration au niveau du serveur Constellation. Cela vous permet de changer ces paramètres directement depuis la Constellation qui se chargera de redescendre ces paramètres sur vos packages.

Il y a deux types de settings :

Les “Setting Value” : il s’agit d’un couple clé/value
Les “Setting Content” : il s’agit d’un setting dont la valeur peut être un XML ou JSON

Dans l’exemple plus haut, le package “DemoPackage” contient à la fois des settings de type “value” et de type “content”.

Vous pouvez également regrouper des settings dans les groupes afin de les partager entre plusieurs package grâce aux settingsGroups. Toujours dans l’exemple précédent, le package “DemoPackage” inclut le groupe “GroupSettingsDemo”, un groupe de settings décrit dans la section ”settingsGroups”.

Pour plus d’information sur les settings, consultez l’article sur l’exploitation des settings avec l’API .NET.

Les groupes

Comme vous le savez, un message peut être envoyé à un groupe dans lequel des packages réels ou virtuels peuvent s’abonner.

Il y a deux manières d’abonner un package à un groupe :

Soit par le package lui même en invoquant la méthode “SubscribeToMessage” via les différentes API Constellation misent à disposition
Soit dans la configuration du package au niveau du serveur Constellation

Cela vous permet d’avoir la main sur l’appartenance des packages aux groupes que vous pouvez administrer sans devoir modifier vos packages (virtuels ou non).

La section “groups” sur un package permet de définir ces liens. Par exemple :

Ici le package “MonPackage” est abonné aux groupes “MonGroupeA” et “MonGroupeB”. En cas de modification des affectations aux groupes, il faudra redémarrer le package soit via vos applications en utilisant les API du hub de contrôle soit depuis la Console Constellation.

Section “settingsGroups”

Vous pouvez grouper des settings (Content ou Value) dans des groupes au niveau du serveur et importer ces groupes dans les settings de vos packages ou dans d’autres groupes.

Par exemple, créons un groupe pour “HWMonitorSettings” qui contient le setting “Interval” :

Ainsi pour chaque instance du package “HWMonitor”, vous pouvez importer le groupe “HWMonitorSettings” afin de centraliser la configuration de ce package :

Vous pouvez importer des groupes dans des groupes sans limite.

C’est toujours la valeur du setting la plus proche du package qui gagne (surcharge).

Bien entendu, vous pouvez créer autant de groupe que vous voulez et chaque groupe peut contenir des SettingValue ou des SettingContent :


  
    
      
      
    
  
  
    
      
        
      
      
      
    
  
  
    
      
      
      
        
          
            Tove
            Jani
            Reminder
            Don't forget me this weekend!

Pour bien comprendre, imaginez le package suivant :

Ici cette instance du package “DemoPackage” définie au niveau du serveur (= sans prendre en compte les settings déclarés dans le fichier local et le manifeste) 7 settings :

numberTest = 42 (définit dans les settings du package)
Demo1 = “It’s me” (définit dans les settings du package, cette valeur écrase celle des groupes importés)
Demo2 = 2015 (définit par le groupe “test2”. Cette valeur écrase la valeur du groupe “test”, car le groupe “test2” est importé APRES le groupe “test”)
MyStringSetting, MyBoolSetting, MyXmlDocument et MyJsonObject définies par le groupe “common” (groupe importé dans le groupe “test2” lui même importé sur le package “DemoPackage”).

Section “credentials”

Comme évoqué dans l’article lié à la sécurité, tous les appels (http) au serveur Constellation doivent être authentifiés en utilisant une clé d’accès que l’on nomme “AccessKey”.

Ces clé d’accès sont liés à des credentials.

Dans la section “credentials” nous allons donc définir les différents credentials ainsi que les différentes autorisations et droits sur ces credentials.

Chaque credential comporte obligatoirement deux propriétés :

Le nom (unique) du credential
L’AccessKey

Ainsi que les propriétés suivantes :

“enable” (true par défaut) : indique si le credential est activé ou désactivé
“enableControlHub” (false par défaut) : indique si le credential peut se connecter sur le hub de contrôle (pour l’administration de la Constellation)
“enableManagementAPI” (false par défaut) : indique si le credential peut se connecter à l’API de Management (pour l’édition de la configuration)
“enableDeveloperAccess” (false par défaut) : indique si le credential peut utiliser la sentinelle virtuelle “Developer” pour debugger des packages (utilisé par le SDK Visual Studio)

Par exemple :

Vous pouvez ensuite définir des autorisations particulières sur un credential pour l’envoi de message, l’abonnement aux groupes de message ou encore l’interrogation de StateObject.

Pour cela il existe trois sous-sections :

“stateObjects” : autorisations spécifiques pour l’interrogation (Request ou Subscribe) des StateObjects
“messages” : autorisations spécifiques pour l’envoi de messages
“groups” : autorisations spécifiques pour l’abonnement aux groupes

Les autorisations sur l’interrogation des StateObjects

Par défaut un credential actif (enable=true) peut interroger (Request ou Subscribe) tous les StateObjects de votre Constellation sans restriction.

Pour modifier ce comportement vous pouvez utiliser les autorisation sur les StateObjects.

Par exemple :

Ici le credential “Standard” ne pourra pas interroger les StateObjects de la Constellation (defaultAuthorization = Deny) sauf pour les exceptions suivantes :

Les StateObjects produits par le(s) instance(s) du package “Paradox”
Les StateObjects produits par les packages (quel qu’il soit) de la sentinelle “PC-SEB”
Les StateObjects nommés “/intelcpu/load/0” et produits par le package “HWMonitor” peu importe la sentinelle
Le StateObject nommé “/ram/load” produit par le package “HWMonitor” sur la sentinelle “SERVER”

Vous devez donc définir l’autorisation par défaut (defaultAuthorization) et optionnellement ajouter une ou plusieurs exceptions avec l’élément dont les attributs sont les suivants :

“id” (obligatoire) : identifiant unique de l’autorisation
“authorization” (facultatif – Allow par défaut) : type de l’exception (Allow ou Deny)
“sentinelName” (facultatif – * par défaut) : sentinelle producteur du StateObject
“packageName” (facultatif – * par défaut) : package producteur du StateObject
“name” (facultatif – * par défaut) : nom du StateObject

Les autorisations sur l’envoi de messages

Par défaut un credential actif (enable=true) peut envoyer un message à n’importe quel scope dans votre Constellation sans restriction.

Par exemple :

Ici le credential “Standard” ne pourra pas envoyer de message dans la Constellation (defaultAuthorization = Deny) sauf pour les exceptions suivantes :

Messages envoyés au groupe “A”
Messages envoyés au package “DemoPackage”
Message “SetTargetTemperature” envoyé au package “Nest”

Vous devez donc définir l’autorisation par défaut (defaultAuthorization) et optionnellement ajouter une ou plusieurs exceptions avec l’élément dont les attributs sont les suivants :

“id” (obligatoire) : identifiant unique de l’autorisation
“scope” (obligatoire) : type de scope pour le message (All, Group, Package ou Sentinel)
“authorization” (facultatif – Allow par défaut) : type de l’exception (Allow ou Deny)
“args” (facultatif) : les arguments du scope
“messageKey” (facultatif) : la clé du message

Les autorisation sur l’abonnement aux groupes

Par défaut un credential actif (enable=true) peut s’abonner à n’importe quel groupe sans restriction.

Par exemple :

Ici le credential “Standard” ne pourra pas s’abonner à des groupes (defaultAuthorization = Deny) à l’exception du groupe “A”. Les attributs sont les suivants :

“groupName” (obligatoire) : le nom du groupe
“authorization” (facultatif – Allow par défaut) : type de l’exception (Allow ou Deny)

The post Le fichier de configuration appeared first on Constellation.

Télécharger et déployer des packages sur vos sentinelles

Sebastien Warin — Tue, 15 Mar 2016 10:58:25 +0000

Télécharger et déployer des packages depuis la Console Constellation

Sur la Console Constellation, rendez-vous sur la page “Package Repository”, le catalogue des packages de votre Constellation. C’est là que vous pourrez gérer votre catalogue de package.

Pour ajouter des packages dans votre catalogue, vous pouvez soit les uploader manuellement ou soit les télécharger directement depuis la catalogue de package gratuit Constellation en cliquant sur le bouton “Online Package Repository” :

Vous pourrez alors choisir sur le catalogue en ligne les packages à télécharger dans votre catalogue local.

Par exemple, ajoutons le package “NetworkTools” en cliquant sur le bouton “Deploy” :

Le téléchargement débutera alors :

Une fois le package télécharger un assistant de déploiement s’affichera vous invitant à sélectionner la sentinelle sur laquelle déployer votre package :

Dans mon cas je choisis de déployer ce package sur la sentinelle “PO-SWARIN”.

Vous pouvez ensuite sélectionner les options de déploiement, pour démarrer laissez les paramètres par défaut :

Ensuite chaque package peut déclarer des settings. Ici le package “NetworkTools” ne déclare qu’un setting pour le monitoring. Vous pouvez éditer le JSON pour définir les ressources à monitorer :

En cliquant sur le bouton “Deploy”, Constellation va automatiquement déployer ce package sur la sentinelle de votre choix. Sur la page “Packages” vous retrouverez vos packages démarrés. Vous pourrez suivre l’état et l’uptime de chaque package, sa consommation CPU et RAM, etc… Vous pouvez également arrêter, redémarrer ou mettre à jour vos packages sur n’importe quelle sentinelles grâce à cette page :

Sur la page “Console log” vous pourrez suivre en temps réel les logs produit par l’ensemble des packages de votre Constellation :

Sur le StateObject Explorer vous pourrez consulter les StateObjects publiés par chaque package. Ici le package “NetworkTools” publie un StateObject pour chaque ressource qu’il monitore (décrit dans ses settings) :

Vous pouvez cliquer sur le bouton “View” pour afficher le détail de chaque StateObject et le suivre en temps réel :

Sur le MessageCallback Explorer, vous pouvez consulter toutes les méthodes que vos packages exposent. Un formulaire permet même de tester les MC depuis la Console :

Notez qu’à tout moment vous pouvez vous rendre dans votre Package Repository et cliquez sur le bouton “Deploy package” dans le menu “Action” du package que vous souhaitez à nouveau déployer :

Quelques packages pour démarrer

BatteryChecker : permet de publier un StateObject sur l’état de votre batterie (pour les PC portables ou onduleurs)
DayInfo : information sur l’heure du levé et couché du soleil et la fete du jour
HWMonitor : permet de publier des StateObjects sur les compteurs “Hardware” de votre machines (CPU, RAM, réseau, disques durs, etc…)
WindowsControl : exposer des MessageCallbacks pour contrôler l’état d’une machine Windows (Reboot, Shutdown, Sleep, Lock, …)
ForecastIO : service de météo
FreeboxTV : pour les possesseurs de Freebox
Hue : pilotage des lampes Hue
Nest : pilotage des thermostats et détecteur de fumée Nest
NetAtmo : intégration des capteurs NetAtmo dans Constellation
PushBullet : envoi de notification sur smartphone, tablette et PC
Rfxcom : intégration des capteur RF
Vera : intégration de la box domotique Vera
Wemo : intégration des prises connectée Wemo
Xbmc : intégration des media-centers Kodi

Rendez-vous dans la rubrique packages.

Autres moyens

Uploader des packages manuellement

Vous pouvez par exemple télécharger des packages manuellement depuis le catalogue officiel ou tout autre source.

Depuis la Console, rendez-vous sur la page “Package Repository” et cliquez sur le bouton “Upload” :

Vous pouvez alors glisser-déplacer les package Constellation (fichiers ZIP) dans le rectangle ou cliquer dessus pour ouvrir la fenêtre de sélection du fichier :

Déposons les différents packages téléchargés dans le rectangle afin de les uploader dans votre catalogue :

Et voilà les packages sont disponibles dans le Package Repository de votre Constellation :

Uploader des packages depuis Visual Studio

Vous pouvez publier un package Constellation directement depuis Visual Studio :

Le package publié est celui marqué comme “Projet de démarrage” dans le cas où vous avez plusieurs projet dans votre solution. Autrement cliquez-droit sur le projet que vous souhaitez publier et cliquer sur “Publish Constellation package” dans le menu “Constellation” :

Vous pourrez ensuite publier votre package en local ou directement sur un serveur Constellation.

Pour plus d’information, consultez cet article.

Déployer manuellement des packages sur vos sentinelles

La définition des déploiements, c’est à dire “quel package sur quelle sentinelle” es t décrite dans le fichier de configuration de la Constellation.

Vous pouvez éditer ce fichier manuellement sur votre serveur Constellation avec notre éditeur de texte préféré, depuis Visual Studio ou directement depuis la Console Constellation :

Par exemple déployons les 5 packages ci-dessous sur la sentinelle nommée “PO-SEB” :

En cliquant sur le bouton “Save & Deploy”, vous allez enregistrer la configuration sur le serveur et déployer cette configuration dans votre Constellation.

Pour plus d’information sur le schéma XML de la configuration Constellation consultez cet article.

The post Télécharger et déployer des packages sur vos sentinelles appeared first on Constellation.

Connecter un Arduino ou un ESP8266 à Constellation

Sebastien Warin — Fri, 19 Aug 2016 09:22:50 +0000

Vous pouvez connecter tout type d’objet ou système dans Constellation à partir du moment où vous disposez d’une connectivité IP pour réaliser des appels HTTP.

Introduction

Par exemple si vous disposez d’un Arduino il vous faudra un shield Ethernet ou Wifi bien que ces derniers ont été retirés du support Arduino.

Arduino propose en alternative des modèles déjà équipés d’une connectivité Ethernet et/ou Wifi comme le MKR1000, le Yun Shield ou le Wifi Shield 101.

En alternative vous avez les ESP8266 que j’ai pu vous présenter sur mon blog personnel.

Ce microcontrôleur est cadencé à 80Mhz par un processeur 32bits RISC avec 96K de RAM et une mémoire flash de 512Ko à 4Mo selon les modèles.

Il dispose d’une connectivité Wifi 802.11 b/g/n supportant le WEP, WPA/2/WPS et réseau ouvert et 16 GPIO dont le support du SPI, I²C, UART et un port ADC (pour les I/O analogiques).

Vous trouverez différents modèles sur internet, comme ceux produit par AI-Thinker mais il faudra réaliser vous même la carte de programmation comme je l’explique sur mon blog ou bien des modules “tout en un” comme ceux d’Adafruit ou Sparkfun disposant d’un port USB intégré pour une programmation facile :

Si vous débutez je vous recommande la Wemos D1 Mini qui intègre un ESP8266 avec 4M de mémoire Flash, 11 I/O digitales et 1 analogique (ADC) ainsi qu’une interface USB le tout pour moins de 5€ :

Pour bien comprendre les ESP8266, je vous recommande une nouvelle fois mon article Découverte des ESP8266 : le microcontrôleur connecté par Wifi pour 2€ au potentiel phénoménal avec Constellation

Le plus important étant que les ESP8266 peuvent être programmés comme les Arduino avec l’IDE Arduino.

Arduino/ESP8266 = package virtuel

Ce concept a déjà été abordé ici. En clair le micro-programme d’un Arduino ou d’un ESP est stocké dans la puce elle même et il n’y a pas de concept de “processus” sur ce genre de device. Il n’est donc pas possible d’avoir une véritable sentinelle qui tourne ce genre d’objet pour déployer et superviser des packages Constellation à la volée comme sur un système Windows ou Linux.

C’est pour cela qu’on parle de sentinelle et de package “virtuel” : on déclare bien dans la configuration de notre Constellation une sentinelle (par exemple nommée “Arduino” et associée à un credential) et contenant un package (par exemple nommé “TemperatureSensor”). Ce package peut être joint à des groupes et avoir des settings qui lui sont propres.

Dans le microprogramme téléversé sur votre Arduino/ESP vous allez vous connecter en spécifiant le nom de la sentinelle et du package virtuel (ici Arduino/TemperatureSensor) et la clé d’accès associée. Votre device sera alors connecté à Constellation comme étant le package “TemperatureSensor” sur la sentinelle “Arduino”. Comme n’importe quel package il pourra produire des logs, publier des StateObjects, récupérer ses settings, envoyer ou recevoir des messages ou encore consommer les StateObjects d’autres packages.

Techniquement parlant l’Arduino/ESP utilise l’API REST “Constellation”.

Installer la librairie Constellation dans l’IDE Arduino

Ouvrez le « Gestionnaire de bibliothèque » dans le menu « Croquis > Inclure une bibliothèque > Gérer les bibliothèques » :

Avec le moteur de recherche, recherchez le terme « ArduinoJson » :

Vous trouverez lors la bibliothèque « ArduinoJson » de Benoit Blanchon (dépendance de la librairie Constellation) ainsi que la librairie Constellation.

Pour ces deux bibliothèques, cliquez sur le bouton « Installer » (ou « Mise à jour » si la librairie est déjà installée).

Hello World, Hello Constellation

Commencez par créer un nouveau sketch et ajoutez la librairie Constellation :

#include

Vous pouvez maintenant déclarer le client “Constellation” en l’initialisant avec l’adresse (IP ou DNS) de votre serveur Constellation, le port et les informations de connexion de Constellation, c’est à dire le nom de votre sentinelle et package ainsi que la clé d’accès que vous aurez déclarés sur votre serveur :

Constellation constellation("IP or DNS du serveur constellation", 8088, "MyVirtualSentinel", "MyVirtualPackage", "123456789");

Pour ajouter une sentinelle virtuelle cliquez sur le bouton “Add sentinel” sur la page “Sentinels” de la Console Constellation :

Puis ajoutons un package virtuel en cliquant sur le bouton contextuel de notre sentinelle “Deploy package” ou directement depuis la package “Packages” :

Déclarez ensuite le nom de votre package, ici “MyVirtualPackage” utilisant la même clé que celle définie au niveau de la sentinelle :

Vous remarquerez que dans la déclaration du client Constellation nous avons spécifié dans le template de la classe Constellation le type de notre client réseau, qui dans le cas d’un ESP8266 ou d’un Arduino MKR1000 est “WifiClient”.

N’oubliez pas d’ajouter les librairies de votre client réseau, quelques exemples :

/* Arduino Wifi (ex: Wifi Shield) */
#include 
#include 

/* Arduino Wifi101 (for WiFi Shield 101 and MKR1000 board) */
#include 
#include 

/* Arduino Ethernet */
#include 
#include 

/* ESP8266 Wifi */
#include

Au démarrage du programme, nous allons d’abord connecter votre client réseau sur le réseau. Dans le cas d’un ESP8266, on se connecte au réseau Wifi de cette façon :

void setup(void) {
  Serial.begin(115200);

  // Connect to Wifi  
  WiFi.begin("MY-SSID", "MY-WIFI_KEY");  
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  // For WiFi101, wait 10 seconds for connection!
  // delay(10000);

  Serial.println("WiFi connected. IP: ");
  Serial.println(WiFi.localIP());
}

Une fois connecté au réseau, on peut utiliser les méthodes de la librairie Constellation.

Par exemple, produisons un log avec la méthode “WriteInfo” :

constellation.writeInfo("Hello Constellation");

Cette méthode gère nativement le formatage “à la printf”, par exemple :

constellation.writeInfo("Hello Constellation, I'm '%s !", constellation.getSentinelName());

Notez que vous pouvez produire de la même façon des messages de type “Info”, “Warning” ou “Error” :

constellation.writeInfo("This is an information"); 
constellation.writeWarn("This is a warning"); 
constellation.writeError("This is an error");

Bien entendu, comme n’importe quel package, les logs sont remontés en temps réel dans la Constellation ce qui permet à n’importe quel “contrôleur” de voir les logs de votre Arduino/ESP en temps réel.

Par exemple, en ouvrant la Console Constellation on pourra suivre votre Arduino/ESP en temps réel :

Accès aux settings

Tous les settings des packages de votre Constellation sont déclarés depuis le fichier de configuration de votre Constellation. Vous pouvez aussi utiliser la Console Constellation pour les administrer.

Dans votre code Arduino, vous devez utiliser la méthode “getSettings” pour récupérer un objet JSON contenant les settings (clé/valeur).

JsonObject& settings = constellation.getSettings();

Par exemple pour récupérer la valeur du setting “MonChiffre” déclarée sur le serveur à 42 :

JsonObject& settings = constellation.getSettings();
static int monChiffre= settings["MonChiffre"].as()

La variable “monChiffre” sera donc affectée à la valeur “42”. Dans l’exemple ci-dessus, la variable est statique pour pouvoir être utilisée n’importe où dans votre code.

Pour les chaines de caractères vous pouvez utiliser la classe “String” :

JsonObject& settings = constellation.getSettings();
static String strMaChaine = String(settings["MaChaine"].as());

Encore une fois la variable est statique pour pouvoir l’utiliser n’importe où dans votre code.

Si vous devez convertir votre chaîne de caractères en const char *, vous pouvez utiliser la fonction c_str() :

const char* maChaine = strMaChaine.c_str();

Vous pouvez également tester la présence d’un setting avec la méthode « containsKey » :

if(settings.containsKey("MySetting")) {  
  // Do something with settings["MySetting"]  
}

Par exemple vous pouvez gérer les valeurs par défaut. Imaginez un code où la valeur d’un timeout est de 5 secondes par défaut mais vous vous laissez la possibilité de surcharger cette variable depuis les settings Constellation :

// Default value
int timeout = 5; // sec

setup() {
  // .....
  JsonObject& settings = constellation.getSettings();
  if(settings.containsKey("Timeout")) {  
    timeout = settings["Timeout"].as();
  }
}

void loop() {
   // DO something with 'timeout'
}

Si le setting « Timeout » est défini dans les settings de votre package sur Constellation, la variable « timeout » sera affectée à votre valeur, autrement, si le setting n’existe pas, la valeur de cette variable sera de 5.

Publier des StateObjects

Pour produire et publier un StateObject dans votre Constellation vous devez invoquer la méthode “pushStateObject” :

constellation.pushStateObject(name, value);

Vous pouvez aussi passer le “type” de votre StateObject :

constellation.pushStateObject(name, value, type);

Notez que pour les types simples (int,bool, long, float et double) le type est spécifié implicitement.

Par exemple, pour publier un StateObject dont la valeur est un chiffre :

constellation.pushStateObject("Temperature", 21);

Vous pouvez aussi publier des StateObject avec un objet complexe en utilisant la fonction “stringFormat” pour formater votre valeur en JSON.

Par exemple pour publier un StateObject nommé “Lux” étant un objet contenant 3 propriétés :

constellation.pushStateObject("Lux", stringFormat("{ 'Lux':%d, 'Broadband':%d, 'IR':%d }", lux, full, ir));

Vous pouvez également faire la même chose en construisant un “JsonObject” :

StaticJsonBuffer<200> jsonBuffer;
JsonObject& root = jsonBuffer.createObject();

root["Lux"] = lux;
root["Broadband"] = full;
root["IR"] = ir;
constellation.pushStateObject("Lux", &root);

Une fois vos StateObjects publiés, ils sont accessibles en temps réel aux autres packages et consommateurs de votre Constellation. Vous pouvez également utiliser le “StateObject Explorer” de la Console Constellation pour explorer tous les StateObjects de votre Constellation :

Next steps

The post Connecter un Arduino ou un ESP8266 à Constellation appeared first on Constellation.

Gérer les sentinelles avec la Console Constellation

Sebastien Warin — Fri, 19 Aug 2016 15:05:41 +0000

Gérer les sentinelles

Dans le menu principal de gauche, cliquez sur “Sentinels” :

Vous retrouverez sur cette page l’ensemble des sentinelles de votre Constellation.

Le statut peut être :

Unknow : une sentinelle qui ne sait jamais connectée ou une sentinelle virtuelle
Disconnected : une sentinelle qui est déconnectée après avoir été connecté
Connected : la sentinelle est connectée

Dans le cadre d’une sentinelle réelle (connectée ou déconnectée) vous obtiendrez également la version de la sentinelle, du système d’exploitation et autres informations sur le moteur d’execution .NET.

Le bouton “Détails” permet d’afficher l’ensemble des informations d’une sentinelle :

Il s’agit d’un menu contextuel qui vous permettra également d’éditer les informations de connexion de la sentinelle, de la supprimer ou encore de voir ou ajouter des packages sur cette sentinelle :

Ajouter une sentinelle

Pour déclarer une sentinelle réelle ou virtuelle, cliquez sur le bouton “Add sentinel” :

Dans la fenêtre d’ajout saisissez le nom de votre sentinelle ainsi que le credential à utiliser pour la connexion :

Pour ajouter et gérer vos credentials, rendez-vous sur la page “Server Management > Credentials”.

Note : dans le cas d’une sentinelle Service, le nom par défaut est le nom de la machine (hostname Linux ou Windows) et dans le cas d’une sentinelle UI (pour Windows seulement), il s’agit du nom de la machine suivi du suffixe “_UI”. Notez toutefois que vous pouvez modifier le nom de la sentinelle dans la configuration de celle-ci. De plus les installeurs Windows et Linux des sentinelles utilisent l’API de Management pour enregistrer automatiquement la sentinelle au serveur, vous n’avez donc pas à l’ajouter manuellement. Cet écran servira surtout pour l’ajout de sentinelle virtuelle.

The post Gérer les sentinelles avec la Console Constellation appeared first on Constellation.

L’architecture Constellation et les différents acteurs : sentinelle, package, contrôleur et consommateur

Sebastien Warin — Tue, 09 Aug 2016 12:28:55 +0000

Une Constellation est constituée des éléments suivants :

Un serveur Constellation
Des sentinelles Constellation
Des packages déployés sur ces sentinelles
Des contrôleurs et consommateurs qui peuvent se connecter au serveur

Les Sentinelles

Une sentinelle est un agent de déploiement pour Constellation. Concrètement il s’agit d’une application (ou service) installée sur un système Windows ou Linux et qui tourne en tache de fond.

Le rôle d’une sentinelle est d’exécuter les ordres provenant du serveur Constellation pour :

Déployer des packages, c’est à dire télécharger des packages (= des programmes) depuis le serveur et les démarrer localement
Contrôler les packages déployés sur la sentinelle (démarrer, arrêter ou redémarrer un package)
Remonter les informations au serveur Constellation sur chaque package (état, consommation des ressources CPU et RAM, etc..)

Une fois une sentinelle installée et enregistrée dans une Constellation, il est possible depuis l’API ou la Console de suivre son état.

Les packages

Les packages sont des applications graphiques ou non graphiques (services) stockées dans le “Package Repository” du serveur Constellation et qui seront déployés sur des sentinelles de la Constellation.

Vous pouvez déployer autant de package que vous souhaitez sur chaque sentinelle. Une fois le package démarré, vous retrouverez son état et sa consommation de ressource dans la Console ou via l’API. Vous pourrez également l’arrêter, le redémarrer ou forcer la mise à jour du package.

Le package lui-même remonte ses logs dans Constellation et récupère ses paramètres de configuration (les Settings) depuis Constellation.

Ainsi si vous souhaitez changer une variable de configuration de l’un de vos packages, vous pouvez le faire directement depuis l’API ou la Console et propager cette mise à jour au package en question.

Chaque package peut produire des données publiées dans ce que l’on nomme des « StateObjects » qui seront accessibles par les autres packages et les consommateurs (comme une page Web) de sa Constellation. De même un package peut consommer les StateObjects produits par les autres packages de la Constellation.

Enfin chaque package peut échanger des messages avec les autres packages ou consommateurs connectés sur les hubs Constellation ce qui permet par exemple d’invoquer des méthodes sur d’autre système (ce que l’on nomme les MessageCallbacks).

A noter qu’il existe aussi une notion de « package virtuel » expliquée à la page suivante.

Les consommateurs

Le serveur Constellation expose une interface REST ainsi qu’un hub nommé « Consumer » à destination des « consommateurs ».

Une page Web par exemple est un consommateur, c’est à dire qu’elle se connecte à Constellation pour interroger des StateObjects ou envoyer/recevoir des messages mais elle n’est pas considérée comme un package dans le sens où une page Web n’est pas un programme déployé et démarré par une sentinelle (son cycle de vie est lié au navigateur du client). Un “consommateur” ne peut ni produire des logs ni avoir de settings ou encore publier des StateObjects. Il ne fait que consommer ni plus ni moins !

Les contrôleurs

Le serveur Constellation expose un hub nommé “Controller” permettant contrôler des éléments de la Constellation comme arrêter/démarrer des packages, s’abonner et récupérer en temps réel les logs des packages de la Constellation, propager les changements de configuration dans la Constellation, suivre l’ état et la consommation des ressources de chaque packages, etc…

Ce hub est notamment utilisé par la Console Constellation pour vous fournir une interface de pilotage de votre Constellation.

Pour se connecter sur ce hub, le credential utilisé pour l’authentification doit avoir la clé « EnableControlHub » activée.

The post L’architecture Constellation et les différents acteurs : sentinelle, package, contrôleur et consommateur appeared first on Constellation.

Auteur:	MyConstellation.io
Plateformes:	Windows
Catégorie:	Web Platform Installers
Licence:	Constellation License Agreement
Date:	juin 15, 2020

Auteur:	MyConstellation.io
Plateformes:	Windows
Catégorie:	Web Platform Installers
Licence:	Constellation License Agreement
Date:	juin 15, 2020

Auteur:	MyConstellation.io
Plateformes:	Windows
Catégorie:	Web Platform Installers
Licence:	Constellation License Agreement
Date:	juin 15, 2020

Auteur:	MyConstellation.io
Plateformes:	Windows
Catégorie:	Web Platform Installers
Licence:	Constellation License Agreement
Date:	juin 15, 2020