# Environnement de Développement

Ensemble de tutos sur comment mettre en place certain environnements de développement spécifiques, notamment à l'aide de Docker

# Récupérer la licence étudiante Jetbrains

Jetbrains est une entreprise Tchèque spécialisée dans le développement d'IDE en tous genre, qui sont parmis les plus qualitatifs existant (c'est un avis personnel bien sur). Ces IDE sont sous licence commerciale, mais il est possible en tant qu'étudiant d'obtenir une licence étudiante gratuite. Cela peut se faire de plusieurs façon.

## Via le Github Student Pack (recommandé)

Le github student pack est une ensemble d'offre étudiante packagées par Github, accessible à tout étudiant ayant un compte Github, inscription au student pack via [ce lien](https://education.github.com/discount_requests/student_application).

La licence étudiante jetbrain fait partie du student pack. Une fois le Github student pack obtenu, rendez vous sur [ce lien](https://www.jetbrains.com/shop/eform/students) et via l'onglet "Github" du formulaire, connectez vous avec Github, ce qui validera votre status d'étudiant.

## Via Jetbrains directement

Rendez vous sur [ce lien](https://www.jetbrains.com/shop/eform/students), et remplissez le formulaire de candidature au programme étudiant, deux possibilité : 

- Via l'adresse email scolaire (premier onglet du formulaire) : recommandé car instané sur l'adresse est reconnu
- Sinon via l'onglet "Document Officiel" en uploadant un certificat de scolarité pour l'année en cours : cela demandera du temps car un employé de Jetbrains devra vérifier votre document. 

## Vérification

Pour vérifier que la licence étudiante est bien active, connectez vous à votre compte Jetbrains nouvellement créé puis vérifiez que vosu avez bien la licence suivante dans l'onglet licences de votre compte : 

[![Capture d’écran 2022-01-15 134656.png](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/scaled-1680-/capture-decran-2022-01-15-134656.png)](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/capture-decran-2022-01-15-134656.png)

## Installer la Jetbrains Toolbox

### Via Winget

```bash
winget install JetBrains.Toolbox
```

### Manuellement

Via [ce lien](https://www.jetbrains.com/toolbox-app/).

## Installer une application Jetbrains

Une fois l'application Toolbox installée, vous pouvez l'ouvrir et tout simplement cliquer sur "Installer" à coté de l'application qui vous intéresse. La toolbox va aussi s'occuper de faire les mises à jours.

## Les applications Jetbrains

- PyCharm : pour le Python
- Webstorm : pour le JavaScript / TypeScript et le web en général
- DataSpell : pour la DataScience (supporte les Jupyter Notebooks)
- CLion pour le C, C++ (supporte CUDA et Qt) et Rust
- DataGrip : pour toute sortes de bases de données
- GoLand : pour le Go
- Rider : pour le .NET (C#, F#, VB .NET)
- PhpStorm : pour le PHP
- RubyMine : pour le Ruby

# Installer Docker

## Installer Docker Desktop sur Windows

Il faut tout d'abord installer WSL (Windows Subsystem for Linux) : 

```bash
wsl --install
```

### Installation via Winget

```bash
winget install Docker.DockerDesktop
```

### Installation via Chocolatey

```bash
choco install docker-desktop
```

### Installation manuelle

Téléchargez et exécuter l'installeur via [ce lien](https://docs.docker.com/desktop/windows/install/).

# Installer Oracle via docker et s'y connecter avec Datagrip

## Prérequis

- [Installer DataGrip](https://knowledge.arsenelapostolet.fr/books/environnement-de-developpement/page/recuperer-la-licence-etudiante-jetbrains)
-  [Installer Docker](https://knowledge.arsenelapostolet.fr/books/environnement-de-developpement/page/installer-docker)

## Lancer une image Docker pour Oracle

Lancer le Docker engine en exécutant l'application Docker Desktop : 

[![Capture d’écran 2022-01-15 122035.png](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/scaled-1680-/capture-decran-2022-01-15-122035.png)](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/capture-decran-2022-01-15-122035.png)

Exécuter la commande Docker suivante : 

```bash
docker run -d -p 1521:1521 --name mon-oracle quay.io/maksymbilenko/oracle-12c
```

> Cette image est particulièrement grosse (environ 4 Go) donc ça peut prendre quelques minutes selon votre connexion internet

Explication des options : 

- `-d` : lancer le conteneur en arrière-plan
- `-p 1521:1521` : forwarder le port 1521 du conteneur vers le port 1521 de la machine hote. C'est le port utiliser pour se connecter à la base
- `--name mon-oracle` : on nomme notre conteneur pour permettre de le manipuler avec un nom simple
- `quay.io/maksymbilenko/oracle-12c` : emplacement de l'image que l'on veut appliquer à notre conteneur

Pour voir l'état de votre conteneur pour pouvez accéder à la GUI Docker Desktop, pour l'ouvrir, cliquez sur la petite icone de baleine en bas à droite de votre écran : 

[![Capture d’écran 2022-01-15 123251.png](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/scaled-1680-/capture-decran-2022-01-15-123251.png)](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/capture-decran-2022-01-15-123251.png)

Cela vous ouvre l'interface, ainsi quand vous cliquez sur "Containers / Apps" vous voyez une liste des conteneurs que vous avez créés : 

[![Capture d’écran 2022-01-15 123724.png](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/scaled-1680-/capture-decran-2022-01-15-123724.png)](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/capture-decran-2022-01-15-123724.png)

Vous pouvez cliquer sur la ligne de votre image pour voir ses logs. Dans ses logs vous pouvez voir la progression de l'initialisation de la base : 

[![Capture d’écran 2022-01-15 130455.png](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/scaled-1680-/capture-decran-2022-01-15-130455.png)](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/capture-decran-2022-01-15-130455.png)

Attends que cette initialisation soit terminée (affichage du message `Database ready to use. Enjoy! ;)`) avant de vous connecter avec Datagrip.

## Se connecter à Oracle sur DataGrip

Ouvrez Datagrip, puis cliquez sur l'icone `+` pour ajouter une nouvelle source de donnée de type Oracle : 

[![Capture d’écran 2022-01-15 130829.png](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/scaled-1680-/capture-decran-2022-01-15-130829.png)](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/capture-decran-2022-01-15-130829.png)

Vous arrivez ensuite à la page de connexion à la base. Voici les étapes pour se connecter : 

1. En bas à gauche du formulaire, cliquez sur "Download missing driver"
2. Dans "Name" renseignez le nom que vous voulez
3. Dans "Host" indiquez `localhost`
4. Dans "Port" indiquez `1521`
5. Dans "SID" indiquez `xe` (en minuscule, la valeur de base est XE mais en majuscule)
6. Dans "User" indiquez `system`
7. Dans "Password" indiquez `oracle`

Enfin cliquez sur "Test Connection" pour vérifier que tout est bon, si vous avez une popup verte cliquez sur "OK".

Patientez ensuite quelques seconde le temps que la base de donnée soit explorée par l'outil, puis faites clic droit sur votre nouvelle Datasource puis `New > Query Console`. Cela va vous ouvrir une invite de commande SQL avec une bonne autocompletion et coloration syntaxique.

## Ouvrir et exécuter des fichiers de script SQL

Pour ouvrir un script SQL avec Datagrip, vous pouvez simplement le Drag & Drop dans l'éditeur : 

[![Capture d’écran 2022-01-15 132336.png](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/scaled-1680-/capture-decran-2022-01-15-132336.png)](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/capture-decran-2022-01-15-132336.png)

Infos à savoir : 

- Avec le bouton "Change dialect to" vous pouvez régler l'éditeur pour lui dire de valider la syntaxe d'Oracle
- Avec la liste déroulante "Session", vous pouvez rattacher l'éditeur à une session de connexion (existante ou en créer une nouvelle) cela permettra à l'éditeur de fournir de la validation et de l'autocomplétion en étant conscient du contenu de votre base).
- Le bouton "Run" (à gauche) permet d'exécuter le script SQL sur la session courante, quand vous exécutez, il vous demande si vous voulez exécuter seulement le statement sur lequel est votre curseur, ou tout le fichier

Quand vous exécutez une comande sur une console ou un script, une console de log s'ouvre pour afficher le résultat de l'exécution : 

[![Capture d’écran 2022-01-15 132921.png](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/scaled-1680-/capture-decran-2022-01-15-132921.png)](https://knowledge.arsenelapostolet.fr/uploads/images/gallery/2022-01/capture-decran-2022-01-15-132921.png)

J'au aussi entouré la liste de déroulante "Tx: Manual", cela permet de changer de mode de transaction : 

- "Manual" : n'autocommit pas, il faut appuyer sur la coche verte juste à droite pour commit la transaction
- "Auto" : autocommit les commandes

Par défaut mettez sur "Auto".