Préparer votre environnement de développement sur Linux

  • Article

Pour déployer et exécuter des applications Azure Service Fabric sur votre ordinateur de développement Linux, installez le runtime et le Kit de développement logiciel (SDK) courant. Vous pouvez également installer des Kits de développement logiciel (SDK) facultatifs pour le développement de Java et .NET Core.

La procédure décrite dans cet article suppose que vous effectuez une installation en mode natif sur Linux ou que vous utilisez l’image conteneur OneBox Service Fabric, c.-à-d. mcr.microsoft.com/service-fabric/onebox:u18.

L’interface de ligne de commande (CLI) Azure Service Fabric vous permet de gérer les entités Service Fabric hébergées dans le cloud ou en local. Pour plus d’informations sur l’installation de l’interface de ligne de commande, consultez Installation de l’interface de ligne de commande Service Fabric.

Prérequis

  • Vérifiez que vous utilisez une version de Linux prise en charge.

  • Installez le package apt-transport-https :

    sudo apt-get install apt-transport-https

Méthodes d’installation

Mise à jour des sources APT

Pour installer le Kit de développement logiciel (SDK) et le package runtime associé via l’outil en ligne de commande apt-get, vous devez tout d’abord mettre à jour les sources Advanced Packaging Tool (APT).

Installation de script

Un script est fourni pour faciliter l’installation du runtime Service Fabric et du Kit de développement logiciel (SDK) Service Fabric courant avec l’interface de ligne de commande sfctl. L’exécution du script suppose que vous acceptez les licences de tous les logiciels en cours d’installation. Vous pouvez également effectuer les étapes d’installation manuelle de la section suivante, qui présente les licences associées, ainsi que les composants en cours d’installation.

Une fois que le script s’exécute, vous pouvez passer directement à la section Configurer un cluster local.

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh | sudo bash

Installation manuelle

Suivez les étapes restantes de ce guide pour réaliser une installation manuelle du runtime Service Fabric et du Kit de développement logiciel (SDK) courant.

  1. Ouvrez un terminal.

  2. Ajoutez le référentiel dotnet à votre liste de sources correspondant à votre distribution.

    wget -q https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

  3. Ajoutez la nouvelle clé de protection de la confidentialité MS Open Tech Gnu (GnuPG ou GPG) à votre porte-clés APT.

    sudo curl -fsSL https://packages.microsoft.com/keys/msopentech.asc | sudo apt-key add -

  4. Ajoutez les clés GPG Docker officielles à votre porte-clés APT.

    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

  5. Configurer le référentiel de Docker.

    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

  6. Ajoutez la clé JDK Azul à votre porte-clés APT et configurez son dépôt.

    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 0xB1998361219BD9C9
sudo apt-add-repository "deb http://repos.azul.com/azure-only/zulu/apt stable main"

  7. Actualisez vos listes de packages selon les référentiels nouvellement ajoutés.

    sudo apt-get update

Installation et configuration du SDK Service Fabric pour un cluster local

Après avoir mis à jour vos sources, vous pouvez installer le SDK. Installez le package SDK Service Fabric, confirmez l’installation, puis acceptez le contrat de licence.

Ubuntu

sudo apt-get install servicefabricsdkcommon

Conseil

Les commandes suivantes automatisent la validation de la licence pour les packages Service Fabric :

echo "servicefabric servicefabric/accepted-eula-ga select true" | sudo debconf-set-selections
echo "servicefabricsdkcommon servicefabricsdkcommon/accepted-eula-ga select true" | sudo debconf-set-selections

Configurer un cluster local

  1. Démarrez un cluster Service Fabric local pour le développement.

Démarrez un cluster Service Fabric Onebox basé sur un conteneur.

  1. Installez Moby pour pouvoir déployer des conteneurs Docker.

    sudo apt-get install moby-engine moby-cli -y

  2. Mettez à jour la configuration du démon Docker sur votre ordinateur hôte avec les paramètres suivants, puis redémarrez le démon Docker. Détails : Activer la prise en charge d’IPv6

    {
    "ipv6": true,
    "fixed-cidr-v6": "fd00::/64"
}

  3. Démarrez le cluster.
    Ubuntu 20.04 LTS :

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u20

    Ubuntu 18.04 LTS :

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18

    Conseil

    Par défaut, cela extraira l’image avec la dernière version de Service Fabric. Pour des révisions particulières, visitez la page Docker Hub.

  1. Ouvrez un navigateur web et accédez à Service Fabric Explorer (http://localhost:19080/Explorer). Au moment où le cluster démarre, vous accédez au tableau de bord Service Fabric Explorer. La configuration complète du cluster peut prendre plusieurs minutes. Si votre navigateur ne parvient pas à ouvrir l’URL, ou si Service Fabric Explorer n’indique pas que le système est prêt, patientez quelques minutes, puis réessayez.

    Service Fabric Explorer sur Linux

    À ce stade, vous pouvez déployer des packages d’application Service Fabric prédéfinis ou de nouveaux packages basés sur des conteneurs invités ou des exécutables invités. Pour générer de nouveaux services à l’aide des Kits de développement logiciel (SDK) .NET Core ou Java, suivez les étapes de configuration facultatives fournies dans les sections suivantes.

Notes

Les clusters autonomes ne sont pas pris en charge sous Linux.

Conseil

Si l’un de vos disques SSD est disponible, nous vous recommandons d’utiliser --clusterdataroot avec devclustersetup.sh pour transférer un chemin d’accès au dossier du disque SSD et ainsi accroître les performances.

Configurer l’interface de ligne de commande Service Fabric

L’interface de ligne de commande Service Fabric inclut des commandes permettant d’interagir avec des entités Service Fabric, y compris des clusters et des applications. Suivez les instructions de l’interface de ligne de commande Service Fabric pour installer l’interface de ligne de commande.

Configurer les générateurs Yeoman pour des conteneurs et des exécutables invités

Service Fabric fournit des outils de génération de modèles automatique qui vous aideront à créer des applications Service Fabric à partir d’un terminal, à l’aide des générateurs de modèle Yeoman. Suivez ces étapes pour configurer les générateurs de modèle Yeoman Service Fabric :

  1. Installez Node.js et npm sur votre machine.

    sudo add-apt-repository "deb https://deb.nodesource.com/node_8.x $(lsb_release -s -c) main"
sudo apt-get update
sudo apt-get install nodejs

  2. Installez le générateur de modèles Yeoman sur votre machine à partir de npm.

    sudo npm install -g yo

  3. Installez le générateur de conteneurs Service Fabric Yeo et le générateur d’exécutables invités à partir de npm.

    sudo npm install -g generator-azuresfcontainer  # for Service Fabric container application
sudo npm install -g generator-azuresfguest      # for Service Fabric guest executable application

Après avoir installé ces générateurs, vous devez être en mesure de créer un exécutable invité ou des services de conteneurs en exécutant respectivement yo azuresfguest ou yo azuresfcontainer.

Configurer le développement de .NET Core 3.1

Installez le Kit de développement logiciel (SDK) .NET Core 3.1 pour Ubuntu pour commencer à créer des applications Service Fabric C#. Les packages pour les applications .NET Core Service Fabric sont hébergés sur NuGet.org.

Configurer le développement Java

Afin de générer des services Service Fabric à l’aide de Java, installez Gradle pour exécuter des tâches de build. Exécutez la commande ci-dessous pour installer Gradle. Les bibliothèques Java Service Fabric sont extraites à partir de Maven.

  • Ubuntu

    curl -s https://get.sdkman.io | bash
sdk install gradle 5.1

  • Red Hat Enterprise Linux 7.4 (prise en charge de la préversion de Service Fabric)

    sudo yum install java-1.8.0-openjdk-devel
curl -s https://get.sdkman.io | bash
sdk install gradle

Vous devez également installer le générateur Service Fabric Yeo pour les exécutables Java. Assurez-vous que Yeoman est installé, puis exécutez la commande suivante :

npm install -g generator-azuresfjava

Installer le plug-in Eclipse (facultatif)

Vous pouvez installer le plug-in Eclipse pour Service Fabric à partir de l’environnement IDE Eclipse pour les développeurs Java ou Java EE. Vous pouvez utiliser Eclipse pour créer des applications exécutables invités Service Fabric et des applications de conteneur en plus des applications Service Fabric Java.

Important

Le plug-in Service Fabric nécessite Eclipse Neon ou une version ultérieure. Consultez les instructions qui suivent cette note pour savoir comment vérifier votre version d’Eclipse. Si vous avez installé une version antérieure d’Eclipse, vous pouvez télécharger des versions les plus récentes à partir du site Eclipse. Nous vous déconseillons de procéder à l’installation par-dessus une installation existante d’Eclipse (par écrasement). Vous pouvez soit la supprimer avant d’exécuter le programme d’installation, soit installer la version la plus récente dans un autre répertoire.

Sur Ubuntu, nous vous recommandons de procéder à l’installation directement depuis le site Eclipse au lieu d’utiliser le programme d’installation d’un package (apt ou apt-get). Ceci vous assure d’obtenir la version la plus récente d’Eclipse. Vous pouvez installer l’environnement IDE pour les développeurs Java ou Java EE.

  1. Dans Eclipse, assurez-vous d’avoir installé Eclipse Neon ou version ultérieure et Buildship version 2.2.1 ou version ultérieure. Vérifiez les versions des composants installés en sélectionnant Aide>About Eclipse(À propos d’Eclipse)>Détails de l’installation. Vous pouvez mettre à jour Buildship en utilisant les instructions Eclipse Buildship : plug-ins Eclipse pour Gradle.

  2. Pour installer le plug-in Service Fabric, sélectionnez Aide>Installer un nouveau logiciel.

  3. Dans le champ Work with (Utiliser), tapez https://dl.microsoft.com/eclipse.

  4. Sélectionnez Ajouter.

    Page des logiciels disponibles

  5. Sélectionnez le plug-in Service Fabric, puis cliquez sur Suivant.

  6. Suivez la procédure d’installation. Acceptez ensuite le contrat de licence de l’utilisateur final.

Si le plug-in Eclipse Service Fabric est déjà installé, assurez-vous de disposer de la dernière version. Pour le vérifier, sélectionnez Aide>About Eclipse (À propos d’Eclipse)>Détails de l’installation. Recherchez ensuite le plug-in Service Fabric dans la liste des plug-ins installés. Sélectionnez Mettre à jour si une version plus récente est disponible.

Pour plus d’informations, consultez la section Plug-in Service Fabric pour le développement d’applications Java sous Eclipse.

Mise à jour du kit de développement logiciel (SDK) et du runtime

Exécutez les commandes suivantes pour mettre à jour vers la dernière version du Kit de développement logiciel (SDK) et du runtime.

sudo apt-get update
sudo apt-get install servicefabric servicefabricsdkcommon

Pour mettre à jour les fichiers binaires du kit de développement logiciel (SDK) Java à partir de Maven, vous devez mettre à jour les détails de la version du fichier binaire correspondant dans le fichier build.gradle pour pointer vers la version la plus récente. Pour savoir exactement où mettre à jour la version, vous pouvez vous référer à n’importe quel fichier build.gradle dans les exemples de prise en main de Service Fabric.

Notes

La mise à jour des packages peut entraîner l’arrêt de votre cluster de développement local. Après une mise à niveau, suivez les instructions de cet article pour redémarrer le cluster local.

Supprimez le Kit de développement logiciel (SDK)

Pour supprimer les Kits de développement logiciel (SDK) Service Fabric, exécutez les commandes suivantes.

  • Ubuntu

    sudo apt-get remove servicefabric servicefabicsdkcommon
npm uninstall -g generator-azuresfcontainer
npm uninstall -g generator-azuresfguest
sudo apt-get install -f

  • Red Hat Enterprise Linux 7.4 (prise en charge de la préversion de Service Fabric)

    sudo yum remove servicefabric servicefabicsdkcommon
npm uninstall -g generator-azuresfcontainer
npm uninstall -g generator-azuresfguest

Étapes suivantes