Méthodes d'installation et guides de la communauté Wiki

Nous avons récemment annoncé que nous voulions déprécier le programme d'installation générique de Home Assistant. Nous avons découvert que la méthode d'installation était plus populaire que prévu et nous avons suspendu ce plan.

Les retours sur notre annonce incluaient également que les méthodes d'installation préférées ne sont pas bien documentées et que c'est déroutant car il y a aussi beaucoup d'autres guides d'installation sur home-assistant.io, certains excellents, certains obsolètes et plus corrects ou même manquants.

Aujourd'hui, je veux prendre du recul et avoir une vue globale des méthodes d'installation. Quelles méthodes d'installation prenons-nous en charge en tant que projet et que signifie-t-il?

Etat de la documentation

Si vous regardez notre documentation, elle est partout. Installez-le dans Docker, dans une VM, sur un NAS ou sur l'une des nombreuses distributions Linux.

La raison pour laquelle nous avons autant de guides est que depuis le début du site Web de Home Assistant, nous avons toujours accepté avec plaisir chaque contribution pour faire fonctionner Home Assistant sur n'importe quelle plate-forme. Plus on est de fous, plus on rit!

Cependant, dans le logiciel, rien ne reste jamais le même. Tous les logiciels reçoivent des mises à jour pour corriger des bogues, corriger des vulnérabilités de sécurité, améliorer les performances ou ajouter de nouvelles fonctionnalités. En tant qu'application logicielle, vous devez évoluer, sinon vous êtes coincé avec un système non sécurisé.

Ainsi, à mesure que Home Assistant grandit et évolue, certains de ces guides d'installation sont devenus obsolètes et ont cessé de fonctionner. Nous ne saurions même pas qu'il était cassé jusqu'à ce qu'un utilisateur soulève un problème. Mais quand ils le font, nous ne saurons pas comment y remédier à moins que nous puissions mettre la main sur le contributeur d'origine.

Cela peut être frustrant. Tout guide sur notre site officiel devrait conduire à un système fonctionnel. Un système qui fonctionne non seulement aujourd'hui, mais aussi demain. Et nous n'avons pas fait du bon travail dans ce domaine, et je tiens à m'en excuser.

Définition d'une «méthode d'installation officiellement prise en charge»

Aujourd'hui, nous introduisons une classification entre ce qui est «officiellement soutenu» et «soutenu par la communauté». Une méthode d'installation officiellement prise en charge dans le contexte de Home Assistant signifie:

«Une manière d'installer et d'exécuter Home Assistant qui est officiellement prise en charge par le projet Home Assistant. Cela signifie que la méthode d'installation est testée et documentée dans la documentation officielle. L'exécution de Home Assistant en utilisant une telle méthode prise en charge conduit à une expérience utilisateur optimale, maintenant et pour l'avenir. "

L'équipe Home Assistant ne vous empêchera pas d'exécuter Home Assistant à l'aide d'une méthode non officielle. Cependant, nous ne pouvons pas vous aider avec les problèmes que vous rencontrez. Nous sommes ouverts aux contributions qui améliorent la compatibilité avec une méthode prise en charge par la communauté tant qu'elles n'affectent pas les méthodes officiellement prises en charge, ajoutent une quantité importante d'exceptions de code ou une charge de maintenance future à l'équipe de développement de Home Assistant.

Méthodes d'installation prises en charge

Voici les quatre méthodes d'installation officiellement prises en charge:

  • Assistant à domicile
    Installation complète de notre système domotique tout compris. La meilleure domotique de sa catégorie est complétée par une interface utilisateur pour configurer votre système, effectuer des sauvegardes et des mises à jour sécurisées avec restauration automatique.

    Cette méthode était auparavant connue sous le nom de «Hass.io» et inclut notre système d'exploitation (HassOS), le superviseur et des modules complémentaires. Il peut être exécuté sur différents ordinateurs monocarte ou dans une machine virtuelle.

  • Conteneur Home Assistant
    Exécutez uniquement l'application Home Assistant Core sur un système de conteneurisation compatible OCI natif (comme Docker). Il ne fournit pas l'expérience complète du superviseur et ne fournit donc pas le panneau du superviseur et les modules complémentaires.

    Cette méthode porte un nouveau nom et était auparavant connue sous le nom de «Home Assistant Core on Docker».

  • Assistant à domicile supervisé
    L'expérience complète de Home Assistant sur un système d'exploitation Linux classique. Cette méthode était auparavant connue sous le nom de «Hass.io sur Linux générique», installée par-dessus, par exemple, Debian.

  • Assistant à domicile Core
    Exécutez l'application Home Assistant Core directement sur Python. Il ne fournit pas l'expérience complète du superviseur et ne fournit donc pas le panneau du superviseur et les modules complémentaires.

Comme vous pouvez le voir, la méthode supervisée Home Assistant est là pour rester.

Ce qui manque pour chacun des éléments énumérés ci-dessus sont les détails spécifiques, par exemple, les systèmes d'exploitation pris en charge pour une installation supervisée ou le matériel pris en charge pour une installation complète de Home Assistant. Nous espérons que ces détails seront bientôt disponibles.

Wiki des guides communautaires

Home Assistant est un projet open source et il peut être utilisé comme vous le souhaitez, même s'il n'est pas officiellement pris en charge par l'équipe Home Assistant. Nous saluons ces initiatives alternatives et avons créé un espace pour notre communauté pour fournir, partager et maintenir collectivement des documents supplémentaires.

Nous avons ajouté une nouvelle section à nos forums intitulée "Guides communautaires». Chaque message sera automatiquement transformé en un article wiki que d'autres membres peuvent aider à maintenir et peut être discuté juste en dessous de l'article. Cette section ne concerne pas seulement les méthodes d'installation, mais TOUT guide, procédure ou didacticiel.

Nous avons porté plusieurs guides de la documentation officielle aux guides de la communauté. Ces guides étaient déjà marqués comme des guides «fournis par la communauté» auparavant, ou sont destinés à des configurations extrêmement spécifiques.

Mot de la fin

Le billet de blog d'aujourd'hui vise à clarifier notre position avec l'installation supervisée, mais en même temps à apporter plus de contexte aux problèmes et aux solutions sur lesquels nous travaillons actuellement. Le nettoyage et la structuration de notre documentation officielle est une première étape importante dans ce processus.

Réalisant que nous n'avons pas terminé les détails spécifiques de chaque méthode d'installation, vous vous demandez peut-être si votre configuration sera prise en charge à l'avenir. Ces détails sont attendus prochainement. Nous n'avons aucune intention d'empêcher Home Assistant de fonctionner selon des méthodes prises en charge par la communauté.

Grâce à la communauté passionnée, vous avez parlé et fait des commentaires à ce sujet. Nous aurons des détails plus spécifiques à partager dans un proche avenir, alors restez à l'écoute.

Paul