Installer CINC Workstation

CINC Workstation est votre poste de travail pour Chef : un seul paquet qui embarque tout le nécessaire pour écrire, exécuter et tester des cookbooks. Ce guide l'installe sur une machine Ubuntu à partir d'un paquet vérifié par empreinte (jamais un curl | sudo bash), puis fait le tour des outils fournis. Public visé : débutant qui découvre Chef via CINC, la distribution libre. Testé avec CINC Workstation 26.1.0 sur Ubuntu.

Ce que vous allez apprendre

• Comprendre ce que contient CINC Workstation.
• Installer le paquet sur Ubuntu, avec vérification d'empreinte.
• Vérifier les outils embarqués (cinc, cinc-client, cinc-auditor).
• Préparer votre poste pour écrire votre premier cookbook.

Qu'est-ce que CINC Workstation ?

CINC Workstation est l'équivalent libre de Chef Workstation : le poste de travail du développeur de cookbooks. Ce n'est pas un seul programme, mais une trousse à outils complète installée d'un coup, qui contient notamment :

• cinc : le pilote du poste de travail (générer un cookbook, installer une policy...).
• cinc-client : l'agent qui converge une machine vers l'état voulu, utilisable en local mode sans serveur.
• cinc-auditor : l'outil de conformité (l'ex-InSpec) pour écrire et exécuter des contrôles.
• cookstyle : le linter qui repère erreurs et anti-patterns dans vos cookbooks.
• kitchen : le banc de test d'intégration (Test Kitchen).
• knife et berks : pour dialoguer avec un serveur et gérer des dépendances.

Autrement dit, avec ce seul paquet vous pouvez tout faire en local, du premier cookbook jusqu'aux tests, sans installer de serveur.

Prérequis

• Une machine Ubuntu (une VM jetable est idéale pour apprendre).
• Un accès sudo et la commande curl.

Installer le paquet, en le vérifiant

CINC propose un script d'installation en une ligne, mais exécuter un script téléchargé directement dans un shell root est une mauvaise habitude : on ne voit pas ce qu'on lance. On préfère récupérer le paquet, vérifier son empreinte, puis l'installer.

1. Récupérer les métadonnées du dernier paquet stable (URL et empreinte) via le service omnitruck de CINC :

   curl -fsSL "https://omnitruck.cinc.sh/stable/cinc-workstation/metadata?p=ubuntu&pv=22.04&m=x86_64"

   La réponse donne la version, l'URL du paquet et sa somme de contrôle sha256 :

   sha256  df9f6eb78bb0ee5b829c12bfcf4350929e0b4d2a216ef30f1f177df13f9d5082
   url  https://packages.cinc.sh/files/stable/cinc-workstation/26.1.0/ubuntu/22.04/cinc-workstation_26.1.0-1_amd64.deb
   version  26.1.0

2. Télécharger le paquet et vérifier son empreinte. La sortie doit afficher OK :

   curl -fsSL "https://packages.cinc.sh/files/stable/cinc-workstation/26.1.0/ubuntu/22.04/cinc-workstation_26.1.0-1_amd64.deb" -o cinc-workstation.deb
   echo "df9f6eb78bb0ee5b829c12bfcf4350929e0b4d2a216ef30f1f177df13f9d5082  cinc-workstation.deb" | sha256sum --check

3. Installer le paquet. Comme l'omnibus est autonome (il embarque toutes ses dépendances), dpkg suffit :

   sudo dpkg -i ./cinc-workstation.deb

Pourquoi dpkg et pas apt install ?

sudo apt-get install ./fichier.deb fonctionne aussi, mais affiche un avertissement gênant (Download is performed unsandboxed as root… Permission denied) quand le .deb est dans votre dossier personnel : l'utilisateur _apt n'y a pas accès. Le paquet CINC n'ayant aucune dépendance externe à résoudre, dpkg -i l'installe proprement, sans ce bruit.

Un paquet omnibus, autonome

Le paquet est publié pour Ubuntu 22.04, mais c'est un paquet omnibus : il embarque son propre Ruby et toutes ses dépendances. Il s'installe donc sans problème sur les Ubuntu plus récentes (24.04). Adaptez la version (26.1.0) et l'empreinte à celles renvoyées par la première commande.

Vérifier l'installation

Une seule commande liste tout ce qui a été installé et confirme les versions :

cinc --version

Cinc Workstation version: 26.1.0
Test Kitchen version: 4.0.0
Cookstyle version: 8.6.10
Cinc Client version: 19.3.14
Cinc Auditor version: 7.0.107
Cinc CLI version: 6.1.30
Biome version: 2.0.107

Chaque ligne est un outil prêt à l'emploi. Vous n'avez rien d'autre à installer pour la suite du parcours. Biome est un formateur récemment ajouté à la trousse ; vous ne l'utiliserez pas dans ce parcours, mais il fait partie du paquet.

CINC ne réclame aucune licence

Si vous avez déjà croisé Chef, vous connaissez peut-être le drapeau --chef-license. Avec CINC, rien à accepter : sous licence Apache-2.0, ce drapeau hérité du code amont n'est pas appliqué, les commandes s'exécutent directement.

À retenir

• CINC Workstation est le poste de travail libre pour Chef : un paquet qui embarque tous les outils.
• Il contient cinc (le pilote), cinc-client (l'agent), cinc-auditor (conformité), cookstyle (lint) et kitchen (tests).
• On l'installe en vérifiant l'empreinte du paquet, jamais avec un curl | sudo bash.
• cinc --version confirme d'un coup toutes les versions installées.
• Avec ce seul poste, on travaille en local mode, sans aucun serveur.

Prochaines étapes

Votre premier cookbook Générer, écrire et converger un cookbook en local mode.

La formation Chef avec CINC Revenir au sommaire du parcours et aux prochains modules.

CINC Auditor : la conformité Écrire des contrôles de conformité avec l'ex-InSpec.

×

📖 Voir la documentation →