Bienvenue chez Dotworld, développeur superstar! 🌟 Voici DotInstall, l'outil incontournable pour gérer et installer vos environnements de développement en toute simplicité.

DotInstall vous permet de :

• Compiler de nouvelles images Docker 🐳
• Construire des stacks de devcontainer prêtes à l'emploi 🛠️
• Mettre à jour Dotdev, le cœur de votre environnement de développement, qui configure tout dès le démarrage et vous offre une commande magique pour interagir avec vos environnements ✨

Avant de commencer, assurez-vous d'avoir installé wget ou curl sur votre machine. Placez-vous ensuite dans le codespace de votre projet ou dans votre dépôt git local.

1. Téléchargez la dernière version de dotinstall.sh :

   • Avec wget :

     wget https://github.com/mus-inn/devcontainer-dotworld/releases/latest/download/dotinstall.sh

   • Ou avec curl :

     curl -L -o dotinstall.sh https://github.com/mus-inn/devcontainer-dotworld/releases/latest/download/dotinstall.sh

2. Exécutez le script téléchargé :

   bash dotinstall.sh

3. Suivez les instructions à l'écran. Le formulaire est interactif et vous guidera tout au long du processus 📝.

Bienvenue dans notre série de vidéos expliquant le projet devcontainer Dotworld ! 🎥

Le projet est organisé en trois dossiers principaux :

1. docker-build : Contient les images Docker à créer pour nos conteneurs de développement.
2. .dev : Centralise les commandes et automatisations des conteneurs de développement, avec des commandes par défaut et des utilitaires.
3. stacks : Représente les différentes stacks installables, telles que "starter" et "PHP 8.1, Next.js".

1. dotInstall : Démarrez un environnement de développement, compilez des images, et mettez à jour les outils nécessaires.
2. build docker dotworld : Compilez des images Docker personnalisées à partir du dépôt devcontainer dotworld, en adaptant les paquets et technologies.

• Utilisez dotInstall pour créer un nouvel espace de développement en sélectionnant une stack et en démarrant l'environnement.
• Avec build docker dotworld, compilez des images adaptées à vos besoins spécifiques, comme passer de PHP 8.1 à PHP 8.2.

• Le build docker dotworld peut être effectué localement pour des tests ou pour une publication sur Docker Hub, prenant en charge les architectures x86 et ARM64.

Pour installer un devcontainer sur un dépôt avec CodeSpace, suivez ces étapes :

1. Allez dans le dépôt souhaité, cliquez sur "Code", puis sélectionnez "CodeSpace".
2. Une fois que le conteneur de base a démarré, ouvrez le README du devcontainer pour obtenir les commandes nécessaires.
3. Utilisez curl ou wget pour télécharger les fichiers requis dans le terminal du CodeSpace.
4. Téléchargez la dernière version de dotinstall et exécutez-la pour installer l'environnement de développement.
5. Configurez le devcontainer selon la technologie, par exemple avec la stack Next.js.
6. Redémarrez le CodeSpace avec l'icône de rechargement ou la commande Ctrl+P, puis rebuild.
7. Vous êtes prêt à travailler dans votre nouvel environnement de développement !

Suivez les instructions pour ouvrir les ports nécessaires et saisissez le mot de passe demandé pour démarrer votre session. Profitez de votre nouvel environnement de développement avec CodeSpace ! 🌐

Pour installer le DevContainer localement, procédez comme suit :

Pour gérer des DevContainers via la ligne de commande de manière globale :

Assurez-vous que npm (Node.js) ou Python (pour pip) est installé. Avec npm : Installez le package @devcontainers/cli :

npm install -g @devcontainers/cli

Avec pip (si disponible) : Installez le CLI pour gérer les DevContainers :

pip install devcontainer

Dans un projet :

Créez un dossier .devcontainer à la racine. Ajoutez un fichier devcontainer.json ou Dockerfile pour décrire votre configuration. Démarrez le DevContainer : Si vous utilisez VS Code, ouvrez le projet, et exécutez Dev Containers: Reopen in Container dans la palette de commandes (Cmd+Shift+P). Sinon, utilisez la CLI :

devcontainer up

1. Assurez-vous d'avoir Docker installé sur votre machine.
2. Clonez le projet dans le répertoire souhaité avec git clone.
3. Accédez au répertoire du projet et téléchargez Dotinstall avec curl ou wget.
4. Exécutez bash dotinstall pour télécharger et installer le DevContainer.
5. Une fois l'installation terminée, vous verrez le .devcontainer dans le répertoire.
6. Sortez du répertoire avec cd ...
7. Lancez le DevContainer avec devcontainer up --workspace-folder Test-World-Frontend.
8. Utilisez Visual Studio Code pour accéder au projet dans le DevContainer.

Dotdev fournit un terminal avec un en-tête mis à jour à chaque réinitialisation. Personnalisez le message de bienvenue en modifiant le fichier "welcome" dans le répertoire "custom".

• Le fichier "install" exécute des commandes au démarrage, idéal pour préparer l'environnement (par ex. installation de dépendances).
• Les "alias" permettent de créer des raccourcis dans le terminal.
• Les "commandes" permettent de définir des actions personnalisées pour votre projet.

Dotdev vous permet de mettre à jour le conteneur de développement, de changer l'environnement, et de gérer les images Docker. Utilisez dotdev pour simplifier vos tâches courantes sans mémoriser une tonne de commandes.

ℹ️ tip: dotdev se lance depuis le container Docker, il faut donc d'abord executer make bash depuis la racine du projet pour aller dans le container.

💡 If you want to use local devcontainer-dotworld repository, please add the following code to your .bashrc/.zshrc to set the vars

    export DEVCONTAINER_USE_LOCAL_REPOSITORY=true 
    export DEVCONTAINER_LOCAL_REPOSITORY_FULLPATH=/path/to/devcontainer-dotworld # Change this to your local repository path

This mode will use the local repository instead of the remote one.

Se mettre dans le repertoire et lancer cette commande

devcontainer up --workspace-folder .

Pour exposer votre application, rien de plus simple :

dotdev share

ou bien :

dotdev share http://localhost:8000

Par défaut, le partage se fera sur l'hôte 127.0.0.1:80.
Si le sous-domaine existe déjà, considérez-vous chanceux avec une probabilité de 1 sur plus de 10 000.
Dans ce cas, vous pouvez forcer la création d'un nouveau sous-domaine en ajoutant l'option --force :

dotdev share http://localhost:8000 --force

Pour toute question ou problème, veuillez ouvrir une issue sur notre dépôt GitHub. Les contributions sont les bienvenues. N'hésitez pas à proposer des améliorations ou à signaler des bugs.

Merci d'utiliser Dotinstall ! 🎉