Appearance

Bien démarrer ​

Ce document explique comment exécuter StarterKit v3 sur un poste de travail Windows en local.

1. Configuration du fichier hosts ​

Modifier le fichier Windows hosts afin d'enregistrer les domaines locaux

Chemin du fichier :

C:\Windows\System32\drivers\etc\hosts

Ajouter les entrées suivantes :

127.0.0.1 v3.nanoxi.local
127.0.0.1 v3b.nanoxi.local
127.0.0.1 v3c.nanoxi.local

Le fichier doit être modifié avec des droits administrateur

2. Installation de Cake Build ​

Installer Cake (C# Make), requis pour compiler et exécuter le projet.

http://cakebuild.net/blog/Release-Notes/

Vérifier que Cake est accessible depuis PowerShell après l'installation.

3. Configuration des variables d'environnement ​

Se rendre dans le dossier suivant :

./cake/

Éditer le fichier :

Set-EnvironmentVariable.ps1

Mettre à jour le script afin que les paramètres de connexion SQL Server correspondent à votre configuration de base de données locale.

4. Mise à jour de la configuration de build ​

Ouvrir le fichier :

build.cake

Aux lignes 44 à 47, ajouter le nom de votre machine locale afin qu'elle soit reconnue comme environnement WRK-STAGE.

Cette étape est indispensable pour que le build fonctionne en local.

5. Prérequis Visual Studio ​

S'assurer que les éléments suivants sont installés :

  • Visual Studio (avec la charge de travail développement .NET)
  • .NET Framework version cible v4.8
  • IIS (Internet Information Services)

IIS est requis car le processus de build crée et configure automatiquement le site web en local.

6. Prêt à compiler ​

Une fois toutes les étapes ci-dessus terminées :

  • Les variables d'environnement sont configurées
  • Cake est installé
  • Visual Studio est correctement configuré

Vous pouvez lancer le processus de build via Cake et commencer à travailler avec StarterKit v3 en local.

7. Rôle de Cake ​

Cake agit comme un orchestrateur global de build pour le projet.
Le script de build gère l'ensemble du processus de mise en place, notamment :

  • La restauration de la base de données SQL Server
  • La préparation des fichiers du site dans le dossier website
  • La création et la configuration du site IIS en local

Une fois le build terminé avec succès, l'application est prête à être utilisée dans l'environnement local.

Contributors

The avatar of contributor named as Clément Favre Clément Favre

Changelog