Skip to content

Commit

Permalink
Documentation teleport (#567)
Browse files Browse the repository at this point in the history
* Create teleport.md

* adjust teleport documentation

* Update teleport.md

* various fixes

---------

Co-authored-by: Gary van Woerkens <[email protected]>
  • Loading branch information
LucasBassoOcto and gary-van-woerkens authored Apr 5, 2024
1 parent fbf7fa1 commit f128f72
Showing 1 changed file with 53 additions and 0 deletions.
53 changes: 53 additions & 0 deletions docs/infrastructure/teleport.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Teleport sur OVH

## Scission des environnement de dev et de prod

Sur OVH, deux teleport sont accessibles.
- Le premier servant à se connecter à l'environnement de dev et se situant à l'adresse suivante: https://teleport-hp.fabrique.social.gouv.fr/
- Le second servant à se connecter à l'environnement de prod et se situant à l'adresse suivante: https://teleport-prod.fabrique.social.gouv.fr/

## Connection à une base de donnée

### Pré-requis
Installation de Teleport v14 (que l'on peut télécharger [ici](https://goteleport.com/download/#install-links) ou à partir du terminal) et un client postgres.

### Utilisation

Vous disposez maintenant de tous les outils nécessaires pour vous connecter à votre base de données.
Une fois Teleport installé vous allez pouvoir accéder au cli nommé `tsh` dans votre terminal.

La première chose à faire est de vous connecter au cluster à partir de ce dernier, pour cela utilisez une des commandes suivantes en fonction de l'environnement souhaité:

Pour la prod:

```
tsh login --proxy=teleport-prod.fabrique.social.gouv.fr:443 teleport-prod.fabrique.social.gouv.fr --auth=github
```

Pour le dev:

```
tsh login --proxy=teleport-hp.fabrique.social.gouv.fr:443 teleport-hp.fabrique.social.gouv.fr --auth=github
```

Ensuite listez les bases de données qui vous sont accessibles avec la commande suivante:

```
tsh app ls
```

Ensuite vous devez créer un tunnel vers cette application avec les deux commandes suivantes:
```
tsh apps login <Nom de votre db>
tsh proxy app <Nom de votre db>
```

Il ne vous reste plus ensuite à vous connecter à l'aide de votre cli psql sur le port indiqué par la commande de proxy.
Ps: il faudra vous munir du mot de passe de votre utilisateur admin
```
psql -U <AdminUsername> -h localhost -p <ProxyPort> <db-name>
```

Vous pouvez vous connecter à une autre db en changeant postgres par le nom correspondant.

Ps: vous pouvez aussi vous connecter avec PgAdmin en renseignant les mêmes champs que pour psql

0 comments on commit f128f72

Please sign in to comment.