h1. Déploiement d'une instance en recette

h2. Initier le déploiement

Sur hobo.test.entrouvert.org, créer la recette de déploiement :

<pre>
{
  "variables": {
    "commune": "XXX"
  },
  "steps": [
    {"create-hobo": {
      "url": "https://hobo-${commune}.test.entrouvert.org/"
    }},
    {"create-authentic": {
      "url": "https://connexion-${commune}.test.entrouvert.org/",
      "title": "Connexion"
    }}, 
    {"set-idp": {
    }},
    {"create-combo": {
      "url": "https://portail-${commune}.test.entrouvert.org/",
      "title": "Portail",
      "template_name": "portal-user"
    }},
    {"create-combo": {
      "url": "https://agents-${commune}.test.entrouvert.org/",
      "slug": "portal-agent",
      "title": "Portail Agent",
      "template_name": "portal-agent"
    }},
    {"create-chrono": {
      "url": "https://agendas-${commune}.test.entrouvert.org/",
      "title": "Agendas"
    }},
    {"create-wcs": {
      "url": "https://demarches-${commune}.test.entrouvert.org/",
      "slug": "eservices",
      "title": "Démarches",
      "template_name": "publik.zip"
    }},
    {"create-passerelle": {
      "url": "https://passerelle-${commune}.test.entrouvert.org/",
      "title": "Passerelle"
    }},
    {"create-bijoe": {
      "url": "https://statistiques-${commune}.test.entrouvert.org/",
      "title": "Statistiques"
    }},
    {"create-fargo": {
      "url": "https://portedoc-${commune}.test.entrouvert.org/",
      "title": "Porte-documents" 
    }},
    {"set-theme": {
      "theme": "clapotis-les-canards"
    }},
    {"set-variable": {
      "name": "environment_label",
      "value": "[RECETTE]",
      "label": "Bannière"
    }},
    {"set-variable": {
      "name": "robots_txt",
      "value": "User-agent: *\nDisallow: /",
      "label": "Contenu de robots.txt"
    }},
    {"set-variable": {
      "name": "meta_robots",
      "value": "noindex, nofollow, noarchive, nosnippet, notranslate, noimageindex",
      "label": "Contenu de meta name=robots"
    }}
  ]
}
</pre>

(Un ensemble de paramètres, spécifiés dans des fichiers de configuration peut-être défini lors de la création d'une instance w.c.s.
Une archive zip contenant ses fichiers de configuration doit être placée dans le répértoire /var/lib/wcs/skeletons. Par exemple /var/lib/wcs/skeletons/publik.zip)

Ensuire exécuter :

<pre>
sudo -u hobo /usr/bin/hobo-manage cook recipe.json --timeout=240
</pre>

h2. Personnalisation de l'instance

Se connecter au portail, https://XXX.test.entrouvert.org/manage/,
* ajouter une page d'index,
* une page "Profil" avec l'adresse de l'authentic (/accounts/),
* une page "Téléservices" avec l'adresse du wcs,
* vérifier le thème souhaité.
* Configurer la position initiale par défaut de la géolocalisation (demarches-ville.test.entrouvert.org/backoffice/settings/geolocation)

* Dans authentic, ajouter un rôle "Debug & Support Entr'ouvert".
* Et dans wcs, (https://demarches-XXX.test.entrouvert.org/backoffice/settings/admin-permissions), réserver les sections "Utilisateurs" et "Rôles" à celui-ci.