# Déploiement d'une application existante

> Source : [Confluence EasyWMS France](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/3000089575437/D%C3%A9ploiement+d%27une+application+existante)  
> Dernière mise à jour : 04/07/2024 (v20)

---

### 1 - Vérifier le fichier "env.secrets.yaml" du Deploy

Vérifier les informations concernant la base de données utilisée sur le projet.

**Pour Oracle :**

| Paramètre | Valeur par défaut |
|-----------|-------------------|
| `Engine`  | `Oracle`          |
| `Server`  | `localhost/orcl`  |
| `Password` (des différentes bases) | `robmec` |

**Pour PostgreSQL :**

| Paramètre | Valeur par défaut |
|-----------|-------------------|
| `Engine`  | `PostgreSQL`      |
| `Server`  | `localhost`       |
| `Password` (des différentes bases) | `robmec` |

---

### 2 - Déploiement complet

Ouvrir **PowerShell en administrateur** dans le dossier `Deploy` de la VM.

> Pour se déplacer dans le dossier Deploy depuis PowerShell : `cd C:\deploy`

Par défaut la commande utilise la branche **Master** du projet Git. Pour déployer une branche spécifique, ajouter son nom après le nom du projet.

```powershell
# Déploiement sur la branche Master (par défaut)
.\deploy_repository.ps1 NomDuProjetGit

# Déploiement sur une branche spécifique
.\deploy_repository.ps1 NomDuProjetGit Branche
```

Exemple :

```powershell
.\deploy_repository.ps1 1707_FRANCE_MA_PIECES_AUTOS_BRETAGNE develop
```

> Plus de détails sur l'exécution du script : [Documentation Mecalux](https://msscc.mecalux.com/documentation/ExternalProcedures/master/EN/ProfessionalServices/TaskWorkBreakDownAndVerification/TaskWorkBreakdownAndVerification.md#md-developmentenvironmentarchitecture)

> ℹ️ D'après l'Espagne, il devrait être possible de déployer n'importe quelle version depuis la **21.1.19.2**. Si ce n'est pas le cas, ouvrir un ticket.

> En cas d'erreur : consulter la page [Installation machine virtuelle de développement](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/2786690269319) au paragraphe **"Deploy 1"**.

> ✅ Sans erreur, vous pouvez **sauter les étapes 3, 4, 5 et 6**.  
> ⚠️ L'**étape 7 est obligatoire** dans tous les cas.

---

### 3 - Deploy 1 *(anciens scripts de deploy uniquement)*

Ouvrir PowerShell en administrateur dans le dossier `Deploy` de la VM et exécuter :

```powershell
.\deploy.ps1
```

Choisir **"1. Complete"**.

> En cas d'erreur : consulter la page [Installation machine virtuelle de développement](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/2786690269319) au paragraphe **"Deploy 1"**.

---

### 4 - Intégrer la configuration d'entrepôt *(anciens scripts de deploy uniquement)*

Ouvrir PowerShell en administrateur dans le dossier `Deploy` de la VM et exécuter :

```powershell
.\deploy.ps1
```

Choisir **"2. Load"**.

Cela transférera :
- La configuration entrepôt depuis **`C:\deploy\Config`**
- Les paramètres exportés via uGNA depuis **`C:\deploy\Data`**

> Il est également possible d'utiliser **EasyS** pour charger le fichier de config via un *Transfert Data* vers la VM.

---

### 5 - Assignation de l'utilisateur à l'entrepôt *(anciens scripts de deploy uniquement)*

Ouvrir PowerShell en administrateur dans **`C:\deploy`** et exécuter :

```powershell
.\Commands\commands.ps1
```

Il est aussi possible de faire l'assignation via le WMS : dans **SmartUI**, aller dans **"Organisation"** → **"Utilisateurs"**, sélectionner l'utilisateur (par défaut `mecalux`) et l'éditer pour ajouter les sites autorisés.

---

### 6 - Faire l'import de l'application custom *(anciens scripts de deploy uniquement)*

Suivre la documentation : [Gestion de la custom application — Import](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/3000089673775/Gestion+de+la+custom+application#2---Import-de-l%27application-custom)

---

### 7 - Désactiver les instances stockées sur la base de données

> ⚠️ **Cette étape est obligatoire.** Sans cette modification, les instances ne fonctionneront pas.

Dans le fichier **`Tenants.xml`** situé dans `C:\inetpub\wwwroot\ApplicationService`, remplacer la ligne :

```xml
<processStore name="TENANT ProcessStore" providerName="Oracle.ManagedDataAccess.Client" … />
```

par :

```xml
<processStore name="TENANT ProcessStore" providerName="InMemory" connectionString="MaxProcessInfoLogs=20;MaxProcessLogEntries=50"/>
```

Puis effectuer un redémarrage de l'application (`iisreset` ou recyclage du pool de l'ApplicationService) — voir : [Restart pool + iisreset](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/3000244731905).

#### Astuce Notepad++ (remplacement automatique multi-tenant)

Utiliser l'outil **"Replace"** de Notepad++ (`Ctrl+H`) en activant le mode **Regular expression** :

**Recherche :**
```
(<processStore name=")(.*)(ProcessStore.*$)
```

**Remplacement :**
```
<processStore name="\2ProcessStore" providerName="InMemory" connectionString="MaxProcessInfoLogs=20;MaxProcessLogEntries=50"/>
```

Cela remplacera la ligne directement avec le bon nom de Tenant.