Skip to content

Commit

Permalink
🌐 Add French translation for deployment/deta.md (#3692)
Browse files Browse the repository at this point in the history
Co-authored-by: Sam Courtemanche <smlep.pro@gmail.com>
Co-authored-by: Ruidy <r.nemausat@empfohlen.de>
Co-authored-by: SebastiĂĄn RamĂ­rez <tiangolo@gmail.com>
  • Loading branch information
4 people committed Oct 31, 2022
1 parent c53e5bd commit c7fe6fe
Show file tree
Hide file tree
Showing 2 changed files with 246 additions and 0 deletions.
245 changes: 245 additions & 0 deletions docs/fr/docs/deployment/deta.md
@@ -0,0 +1,245 @@
# DĂ©ployer FastAPI sur Deta

Dans cette section, vous apprendrez à déployer facilement une application **FastAPI** sur <a href="https://www.deta.
sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> en utilisant le plan tarifaire gratuit. 🎁

Cela vous prendra environ **10 minutes**.

!!! info
<a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> sponsorise **FastAPI**. 🎉

## Une application **FastAPI** de base

* Créez un répertoire pour votre application, par exemple `./fastapideta/` et déplacez-vous dedans.

### Le code FastAPI

* Créer un fichier `main.py` avec :

```Python
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int):
return {"item_id": item_id}
```

### DĂ©pendances

Maintenant, dans le mĂȘme rĂ©pertoire, crĂ©ez un fichier `requirements.txt` avec :

```text
fastapi
```

!!! tip "Astuce"
Il n'est pas nécessaire d'installer Uvicorn pour déployer sur Deta, bien qu'il soit probablement souhaitable de l'installer localement pour tester votre application.

### Structure du répertoire

Vous aurez maintenant un répertoire `./fastapideta/` avec deux fichiers :

```
.
└── main.py
└── requirements.txt
```

## Créer un compte gratuit sur Deta

Créez maintenant un <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">compte gratuit
sur Deta</a>, vous avez juste besoin d'une adresse email et d'un mot de passe.

Vous n'avez mĂȘme pas besoin d'une carte de crĂ©dit.

## Installer le CLI (Interface en Ligne de Commande)

Une fois que vous avez votre compte, installez le <abbr title="Command Line Interface application">CLI</abbr> de Deta :

=== "Linux, macOS"

<div class="termy">

```console
$ curl -fsSL https://get.deta.dev/cli.sh | sh
```

</div>

=== "Windows PowerShell"

<div class="termy">

```console
$ iwr https://get.deta.dev/cli.ps1 -useb | iex
```

</div>

AprÚs l'avoir installé, ouvrez un nouveau terminal afin que la nouvelle installation soit détectée.

Dans un nouveau terminal, confirmez qu'il a été correctement installé avec :

<div class="termy">

```console
$ deta --help

Deta command line interface for managing deta micros.
Complete documentation available at https://docs.deta.sh

Usage:
deta [flags]
deta [command]

Available Commands:
auth Change auth settings for a deta micro

...
```

</div>

!!! tip "Astuce"
Si vous rencontrez des problĂšmes pour installer le CLI, consultez la <a href="https://docs.deta. sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">documentation officielle de Deta (en anglais)</a>.

## Connexion avec le CLI

Maintenant, connectez-vous à Deta depuis le CLI avec :

<div class="termy">

```console
$ deta login

Please, log in from the web page. Waiting..
Logged in successfully.
```

</div>

Cela ouvrira un navigateur web et permettra une authentification automatique.

## DĂ©ployer avec Deta

Ensuite, déployez votre application avec le CLI de Deta :

<div class="termy">

```console
$ deta new

Successfully created a new micro

// Notice the "endpoint" 🔍

{
"name": "fastapideta",
"runtime": "python3.7",
"endpoint": "https://qltnci.deta.dev",
"visor": "enabled",
"http_auth": "enabled"
}

Adding dependencies...


---> 100%


Successfully installed fastapi-0.61.1 pydantic-1.7.2 starlette-0.13.6
```

</div>

Vous verrez un message JSON similaire à :

```JSON hl_lines="4"
{
"name": "fastapideta",
"runtime": "python3.7",
"endpoint": "https://qltnci.deta.dev",
"visor": "enabled",
"http_auth": "enabled"
}
```

!!! tip "Astuce"
Votre déploiement aura une URL `"endpoint"` différente.

## VĂ©rifiez

Maintenant, dans votre navigateur ouvrez votre URL `endpoint`. Dans l'exemple ci-dessus, c'Ă©tait
`https://qltnci.deta.dev`, mais la vÎtre sera différente.

Vous verrez la réponse JSON de votre application FastAPI :

```JSON
{
"Hello": "World"
}
```

Et maintenant naviguez vers `/docs` dans votre API, dans l'exemple ci-dessus ce serait `https://qltnci.deta.dev/docs`.

Vous verrez votre documentation comme suit :

<img src="/img/deployment/deta/image01.png">

## Activer l'accĂšs public

Par défaut, Deta va gérer l'authentification en utilisant des cookies pour votre compte.

Mais une fois que vous ĂȘtes prĂȘt, vous pouvez le rendre public avec :

<div class="termy">

```console
$ deta auth disable

Successfully disabled http auth
```

</div>

Maintenant, vous pouvez partager cette URL avec n'importe qui et ils seront en mesure d'accĂ©der Ă  votre API. 🚀

## HTTPS

FĂ©licitations ! Vous avez dĂ©ployĂ© votre application FastAPI sur Deta ! 🎉 🍰

Remarquez Ă©galement que Deta gĂšre correctement HTTPS pour vous, vous n'avez donc pas Ă  vous en occuper et pouvez ĂȘtre sĂ»r que vos clients auront une connexion cryptĂ©e sĂ©curisĂ©e. ✅ 🔒

## VĂ©rifiez le Visor

À partir de l'interface graphique de votre documentation (dans une URL telle que `https://qltnci.deta.dev/docs`)
envoyez une requĂȘte Ă  votre *opĂ©ration de chemin* `/items/{item_id}`.

Par exemple avec l'ID `5`.

Allez maintenant sur <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>.

Vous verrez qu'il y a une section à gauche appelée <abbr title="ça vient de Micro(server)">"Micros"</abbr> avec chacune de vos applications.

Vous verrez un onglet avec "Details", et aussi un onglet "Visor", allez Ă  l'onglet "Visor".

Vous pouvez y consulter les requĂȘtes rĂ©centes envoyĂ©es Ă  votre application.

Vous pouvez Ă©galement les modifier et les relancer.

<img src="/img/deployment/deta/image02.png">

## En savoir plus

À un moment donnĂ©, vous voudrez probablement stocker certaines donnĂ©es pour votre application d'une maniĂšre qui
persiste dans le temps. Pour cela, vous pouvez utiliser <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a>, il dispose également d'un généreux **plan gratuit**.

Vous pouvez Ă©galement en lire plus dans la <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">documentation Deta</a>.
1 change: 1 addition & 0 deletions docs/fr/mkdocs.yml
Expand Up @@ -72,6 +72,7 @@ nav:
- deployment/index.md
- deployment/versions.md
- deployment/https.md
- deployment/deta.md
- deployment/docker.md
- project-generation.md
- alternatives.md
Expand Down

0 comments on commit c7fe6fe

Please sign in to comment.