Comment installer Sandstorm sur Ubuntu 14.04

Écrit en collaboration avec Sandstorm

introduction

Sandstorm est une plate-forme open source pour serveurs personnels, ce qui signifie qu’elle peut être utilisée pour installer de nombreuses applications différentes sur un serveur avec une interface facile à utiliser. Quelques exemples d’applications pouvant être installées à l’aide de Sandstorm sont Wordmail, GitLab, MediaWiki, Apache Wave et RoundCube. Par exemple, de nombreuses personnes utilisent Sandstorm comme une alternative auto-hébergée à Google Docs.

Dans cet article, nous allons installer Sandstorm, puis trois exemples d’applications parmi les plus populaires.

Conditions préalables

Pour suivre ce tutoriel, vous aurez besoin de:

Étape 1 - Installation de Sandstorm

Dans cette section, nous allons installer Sandstorm.

Pour lancer l’assistant d’installation de Sandstorm, il suffit de télécharger et d’exécuter le script d’installation. Vous pouvez visiter + https: // install.sandstorm.io + dans votre navigateur préféré pour afficher le script avant d’exécuter la commande.

curl https://install.sandstorm.io | bash

Sandstorm va commencer à poser des questions sur votre configuration. Entrez votre mot de passe lorsque vous y êtes invité et appuyez sur + ENTER + pour accepter les réponses par défaut à toutes les questions, à l’exception de la question * Quel sous-domaine * .sandcats.io souhaitez-vous? *.

Cette question est posée car Sandstorm vous donnera un sous-domaine gratuit pour votre installation de Sandstorm si vous souhaitez l’utiliser. Votre sous-domaine + sandcats.io + viendra également avec votre propre certificat SSL, ce qui sécurisera votre installation Sandstorm en activant HTTPS.

Sinon, vous pouvez utiliser votre propre domaine, mais si vous utilisez un sous-domaine + sandcats.io +, vous pouvez toujours https://docs.sandstorm.io/en/latest/administering/sandcats/#disabling-the-sandcats -service [passez à votre propre domaine à l’avenir].

Suivez les instructions dans la section appropriée ci-dessous, puis passez à l’étape 2.

Utiliser un sous-domaine libre + sandcats.io +

Pour utiliser un sous-domaine + sandcats.io +, entrez simplement le nom du sous-domaine souhaité pour la question * Quel *. * .Sandcats.io souhaitez-vous? *. Par exemple, si vous entrez * exemple * ici, vous pourrez accéder à votre installation Sandstorm à partir de + .sandcats.io +. Choisissez un nom qui correspond à votre objectif pour cette installation Sandstorm.

Utiliser votre propre domaine

Dans cette section, nous allons configurer les paramètres DNS si vous souhaitez utiliser votre Sandstorm avec votre propre domaine ou sous-domaine. Ceci est une configuration avancée; pour la plupart des utilisations, le service + sandcats.io + convient, en particulier pour les tests.

Si vous souhaitez utiliser un domaine personnalisé, vous aurez besoin d’un nom de domaine avec les enregistrements DNS suivants:

  • Un enregistrement CNAME générique redirigeant vers votre adresse IP Sandstorm (`+ *. CNAME. + `)

  • Un enregistrement A pointant sur votre domaine (`+. A + `).

Vous pouvez trouver plus d’informations sur la configuration d’un nom de domaine dans cette explicative.

Les nouvelles applications Sandstorm sont situées sur un sous-domaine. Les enregistrements DNS tels que + *. 111.111.111.111 + n’existent pas, vous ne pouvez donc pas utiliser l’adresse IP de votre Droplet; un nom de domaine et un enregistrement DNS générique sont requis. Vous pouvez également utiliser le service xip.io qui fournit un DNS générique pour toute adresse IOP; En savoir plus sur xip.io dans la documentation Sandstorm .

Une fois que vous avez configuré les enregistrements DNS, assurez-vous de répondre * aucun * à la question * Quel sous-domaine * .sandcats.io aimeriez-vous? [] * pendant le processus d’installation. Répondez à * l’URL que les utilisateurs entreront dans le navigateur: [http: // sammy: 6080] * avec votre nom de domaine, tel que + http: //example.com: 6080 +. Veillez à indiquer le domaine générique correct pour la question * Hôte générique: [* .exemple: 6080] *. Ce sera généralement déjà correct car Sandstorm le déduit de la question précédente.

Étape 2 - Configuration des fournisseurs d’identité

Dans cette section, nous allons configurer Sandstorm.

Après avoir installé Sandstorm, l’assistant de configuration vous fournira une URL pour accéder à votre serveur:

Your server is now online! It should work immediately if you use Chrome.
Visit this link to start using it:

 https://.sandcats.io/setup/token/f19d0a6873f5dc5ad389a0977d832ee0fac14c5a

NOTE: This URL expires in 15 minutes. You can generate a new setup URL by running
'sudo sandstorm admin-token' from the command line.

Naviguez jusqu’à l’URL en le copiant depuis le terminal et en le collant dans votre navigateur. Vous verrez un écran intitulé * Bienvenue à Sandstorm! *.

image: https: //assets.digitalocean.com/articles/sandstorm/dNSte8I.png [Initial de tempête de sable]

Cliquez sur * Commencer la configuration standard *. Vous verrez un écran intitulé * Configurer le (s) fournisseur (s) d’identité *.

image: https: //assets.digitalocean.com/articles/sandstorm/CPLsgg1.png [Fournisseurs d’identité de tempête de sable]

Vous pouvez maintenant configurer un ou plusieurs fournisseurs d’identité. Choisissez un fournisseur d’identité (email, Google ou GitHub) et reportez-vous à la section appropriée ci-dessous. L’utilisation de Google ou de GitHub est recommandée, car la messagerie électronique nécessitera la configuration d’un serveur SMTP.

Email (sans mot de passe)

Cliquez sur * Configurer * à la droite de * Email (sans mot de passe) *, puis cliquez sur * Activer * dans l’invite relative à un relais de messagerie.

image: https: //assets.digitalocean.com/articles/sandstorm/JWchrra.png [Courriel de tempête de sable (sans mot de passe)]

Toutefois, notez que Google et GitHub sont généralement plus faciles à configurer car ils ne nécessitent pas de serveur SMTP.

Google

Cliquez sur * Configurer * à droite de * Google *. Si vous choisissez la connexion à Google, vous verrez les instructions dans Sandstorm, comme indiqué ici:

image: https: //assets.digitalocean.com/articles/sandstorm/ArDuyPC.png [Sandstorm Google Login]

Suivez ces instructions et après avoir saisi les * ID client * et * Client Secret *, cliquez sur * Activer *.

GitHub

Cliquez sur * Configurer * à droite de * GitHub *. Si vous choisissez la connexion à GitHub, vous verrez les instructions dans Sandstorm, comme indiqué ici:

image: https: //assets.digitalocean.com/articles/sandstorm/HLBmo32.png [Ouverture d’une session Sandstorm GitHub]

Suivez ces instructions et après avoir saisi les * ID client * et * Client Secret *, cliquez sur * Activer *.

Étape 3 - Terminer l’assistant d’installation

Après avoir configuré vos fournisseurs d’identité, continuez avec l’assistant de configuration en cliquant sur * Suivant * en bas à droite. L’écran suivant s’intitule * Configuration du courrier sortant *.

image: https: //assets.digitalocean.com/articles/sandstorm/XXeKTWF.png [Configuration de la messagerie par tempête de sable]

Si vous ne souhaitez pas pouvoir envoyer de courrier électronique, cliquez sur * Ignorer pour le moment *. Il est toujours possible d’ajouter ces données ultérieurement. Toutefois, cette étape est requise si vous avez configuré le fournisseur d’identification d’e-mail ou si vous souhaitez utiliser les notifications par e-mail.

Si vous souhaitez configurer cela, ajoutez vos informations SMTP et assurez-vous de cliquer sur * Test * pour vérifier si vous avez entré les données correctes. Une fois le test réussi, cliquez sur * Enregistrer et continuer *.

La prochaine étape vous demandera de créer un compte administrateur. Utilisez l’une des options de connexion pour créer le compte administrateur. La dernière étape consiste à confirmer votre compte en cliquant sur * Terminer *.

Votre installation est maintenant terminée!

image: https: //assets.digitalocean.com/articles/sandstorm/Wav5qjN.png [Installation de la tempête de sable terminée]

Cliquez sur * Commencer à utiliser Sandstorm * pour continuer jusqu’à Sandstorm.

Étape 4 - Installation des applications (facultatif)

Par exemple, nous allons suivre le processus d’installation de quelques applications populaires. Pour des descriptions plus spécifiques, veuillez consulter les exemples (WordPress, MediaWiki et EtherPad) ci-dessous.

Tout d’abord, cliquez sur * Installer… à partir d’App Market *. L’écran suivant vous montrera diverses applications que vous pouvez installer, notamment WordPress, GitLab, MediaWiki, Apache Wave et Roundcube. Lorsque vous cliquez sur * Installer *, Sandstorm se charge automatiquement de toutes les étapes de l’installation et vous obtiendrez immédiatement une version complètement opérationnelle de l’application.

Cliquez sur * Installer en regard de l’application que vous souhaitez installer. Vous serez redirigé vers votre installation, qui affichera une page de progression. Une fois l’application téléchargée, cliquez à nouveau sur Installer *. Ensuite, vous serez redirigé vers un écran avec un bouton personnalisé pour l’application que vous avez installée. Par exemple, pour WordPress, il indiquera * Nouveau site WordPress *. Lorsque vous cliquez sur ce bouton, un nouveau site sera créé. Lorsque vous ouvrez ce site, le chargement prendra un peu de temps car Sandstorm devra lancer le code WordPress. Pour des instructions plus détaillées, veuillez vous reporter à l’exemple d’installation de WordPress. C’est ça!

Vous pouvez partager des autorisations de modification sur un site en cliquant sur * Partager l’accès * dans la barre du haut. Lorsque quelqu’un arrive sur votre serveur et s’authentifie via le fournisseur de connexion choisi, Sandstorm les empêche de créer de nouveaux grains ou d’installer des applications par défaut. Pour donner plus d’autorisations aux utilisateurs, visitez les * Paramètres administrateur * en cliquant sur votre nom dans le coin supérieur droit et en affectant une nouvelle * Classe utilisateur * dans l’onglet * Utilisateurs *.

Pour minimiser l’utilisation de la RAM par les applications, Sandstorm arrête leurs processus pendant les périodes d’inactivité. Cela signifie que lorsque vous visitez à nouveau un grain après plus de quinze minutes, il peut prendre un moment pour recommencer, alors gardez cela à l’esprit.

Exemple: Installation de WordPress

Par exemple, nous allons installer WordPress. Vous pouvez installer WordPress si vous souhaitez publier un blog public, à condition de ne pas avoir besoin de commentaires, car WordPress sur Sandstorm ne prend pas cela en charge. Vous pouvez également l’utiliser pour maintenir un blog privé, rien que pour vous, ou partagé avec des amis. Notez que même si vous utilisez WordPress pour modifier le site, Sandstorm est responsable de le servir au monde entier. Sandstorm agit comme un cache HTTP agressif. Dans WordPress, vous devez cliquer sur "Reconstruire le site public" pour mettre à jour ce cache. Cela signifie que le code PHP WordPress n’est jamais exécuté par des utilisateurs anonymes et non fiables. Pour plus d’informations, veuillez consulter visit la documentation Sandstorm.

Une fois connecté, vous serez sur l’écran d’accueil. Cliquez sur * Installer… à partir d’App Market * et recherchez WordPress dans la liste. Lorsque vous l’avez trouvé, cliquez sur * Installer *. Il va commencer à télécharger et décompresser l’application. Lorsque cela est terminé, cliquez sur * Installer WordPress *. Une fois l’installation de l’application terminée, vous arriverez à une page comme celle-ci:

image: https: //assets.digitalocean.com/articles/sandstorm/JbOQWk4.png [Tempête de sable WordPress]

Pour créer un nouveau site WordPress, cliquez sur * Créer un nouveau site *. Une fois terminé, vous verrez un nouveau site WordPress. Vous pouvez changer le titre qui s’affichera dans Sandstorm en cliquant sur * Untitled WordPress Site *. Vous pouvez également simplement commencer à utiliser le site directement; il fonctionne comme un site WordPress normal.

Vous pouvez fermer le site en revenant à la page d’accueil en cliquant sur * Sandstorm * dans le coin supérieur gauche.

Exemple: installer EtherPad

Pour cet exemple, nous allons installer EtherPad, un éditeur de documents collaboratif qui est l’une des applications les plus populaires de Sandstorm. Dans Sandstorm, chaque document est son propre grain, ce qui rend le contrôle d’accès très efficace.

Sur l’écran d’accueil, cliquez sur * Installer… à partir d’App Market * et, dans la liste, choisissez * Installer * pour EtherPad. Après quelques instants, cliquez sur * Installer EtherPad * après le téléchargement. Maintenant, vous pouvez créer un nouveau pad en cliquant sur * Créer un nouveau pad *. Cela va créer un nouveau document. Il est possible de partager ce document avec d’autres utilisateurs en cliquant sur "Partager l’accès" en haut. Cela montrera deux options pour le partager: en envoyant des invitations ou en partageant une URL. Il est même possible de déterminer les autorisations que cet utilisateur aura.

Exemple: Installation de MediaWiki

Pour ce dernier exemple, nous installerons MediaWiki. L’application MediaWiki dans Sandstorm ne prend pas en charge le système de publication statique Sandstorm, elle ne peut donc pas être facilement utilisée en tant que wiki public.

Sur l’écran d’accueil, cliquez sur * Installer… à partir d’App Market * pour lancer l’installation de l’application. Dans la liste, choisissez * Installer * pour MediaWiki. Une fois l’application téléchargée et décompressée, cliquez sur * Installer MediaWiki *. Une fois terminé, vous pouvez créer un nouveau MediaWiki en cliquant sur * Créer un nouveau wiki *. Vous pourrez changer le titre comme vous le feriez avec les sites WordPress. Vous pouvez par exemple utiliser ce wiki comme documentation privée.

Pour ajouter d’autres personnes à ce wiki, utilisez le bouton * Share Access * en haut de l’interface Sandstorm. Si vous souhaitez rendre ce wiki public, vous pouvez créer un lien de partage et le distribuer. N’oubliez pas que les liens de partage Sandstorm ont des URL longues et difficiles à retenir.

Conclusion

Sandstorm est utile pour de nombreuses applications différentes et est activement développé. Pour plus d’informations et de documentation sur Sandstorm, visitez leur documentation.