]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add French translation for `deployment/deta.md` (#3692)
authorRuidy <ruidy.nemausat@gmail.com>
Mon, 31 Oct 2022 18:07:22 +0000 (19:07 +0100)
committerGitHub <noreply@github.com>
Mon, 31 Oct 2022 18:07:22 +0000 (18:07 +0000)
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>
docs/fr/docs/deployment/deta.md [new file with mode: 0644]
docs/fr/mkdocs.yml

diff --git a/docs/fr/docs/deployment/deta.md b/docs/fr/docs/deployment/deta.md
new file mode 100644 (file)
index 0000000..cceb7b0
--- /dev/null
@@ -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>.
index b980acceb5846797e113ad44ad891bb92a7ab95b..1c4f45682f00cc4c64628e65e1aa7170e98b7a71 100644 (file)
@@ -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