Sebastián Ramírez
2 years ago
committed by
GitHub
GitHub
8 changed files with 21 additions and 1393 deletions
@ -1,258 +0,0 @@ |
|||
# 🛠️ FastAPI 🔛 🪔 |
|||
|
|||
👉 📄 👆 🔜 💡 ❔ 💪 🛠️ **FastAPI** 🈸 🔛 <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🪔</a> ⚙️ 🆓 📄. 👶 |
|||
|
|||
⚫️ 🔜 ✊ 👆 🔃 **1️⃣0️⃣ ⏲**. |
|||
|
|||
!!! info |
|||
<a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🪔</a> **FastAPI** 💰. 👶 |
|||
|
|||
## 🔰 **FastAPI** 📱 |
|||
|
|||
* ✍ 📁 👆 📱, 🖼, `./fastapideta/` & ⛔ 🔘 ⚫️. |
|||
|
|||
### FastAPI 📟 |
|||
|
|||
* ✍ `main.py` 📁 ⏮️: |
|||
|
|||
```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} |
|||
``` |
|||
|
|||
### 📄 |
|||
|
|||
🔜, 🎏 📁 ✍ 📁 `requirements.txt` ⏮️: |
|||
|
|||
```text |
|||
fastapi |
|||
``` |
|||
|
|||
!!! tip |
|||
👆 🚫 💪 ❎ Uvicorn 🛠️ 🔛 🪔, 👐 👆 🔜 🎲 💚 ❎ ⚫️ 🌐 💯 👆 📱. |
|||
|
|||
### 📁 📊 |
|||
|
|||
👆 🔜 🔜 ✔️ 1️⃣ 📁 `./fastapideta/` ⏮️ 2️⃣ 📁: |
|||
|
|||
``` |
|||
. |
|||
└── main.py |
|||
└── requirements.txt |
|||
``` |
|||
|
|||
## ✍ 🆓 🪔 🏧 |
|||
|
|||
🔜 ✍ <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">🆓 🏧 🔛 🪔</a>, 👆 💪 📧 & 🔐. |
|||
|
|||
👆 🚫 💪 💳. |
|||
|
|||
## ❎ ✳ |
|||
|
|||
🕐 👆 ✔️ 👆 🏧, ❎ 🪔 <abbr title="Command Line Interface application">✳</abbr>: |
|||
|
|||
=== "💾, 🇸🇻" |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ curl -fsSL https://get.deta.dev/cli.sh | sh |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
=== "🚪 📋" |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ iwr https://get.deta.dev/cli.ps1 -useb | iex |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
⏮️ ❎ ⚫️, 📂 🆕 📶 👈 ❎ ✳ 🔍. |
|||
|
|||
🆕 📶, ✔ 👈 ⚫️ ☑ ❎ ⏮️: |
|||
|
|||
<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 |
|||
🚥 👆 ✔️ ⚠ ❎ ✳, ✅ <a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">🛂 🪔 🩺</a>. |
|||
|
|||
## 💳 ⏮️ ✳ |
|||
|
|||
🔜 💳 🪔 ⚪️➡️ ✳ ⏮️: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ deta login |
|||
|
|||
Please, log in from the web page. Waiting.. |
|||
Logged in successfully. |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
👉 🔜 📂 🕸 🖥 & 🔓 🔁. |
|||
|
|||
## 🛠️ ⏮️ 🪔 |
|||
|
|||
⏭, 🛠️ 👆 🈸 ⏮️ 🪔 ✳: |
|||
|
|||
<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> |
|||
|
|||
👆 🔜 👀 🎻 📧 🎏: |
|||
|
|||
```JSON hl_lines="4" |
|||
{ |
|||
"name": "fastapideta", |
|||
"runtime": "python3.7", |
|||
"endpoint": "https://qltnci.deta.dev", |
|||
"visor": "enabled", |
|||
"http_auth": "enabled" |
|||
} |
|||
``` |
|||
|
|||
!!! tip |
|||
👆 🛠️ 🔜 ✔️ 🎏 `"endpoint"` 📛. |
|||
|
|||
## ✅ ⚫️ |
|||
|
|||
🔜 📂 👆 🖥 👆 `endpoint` 📛. 🖼 🔛 ⚫️ `https://qltnci.deta.dev`, ✋️ 👆 🔜 🎏. |
|||
|
|||
👆 🔜 👀 🎻 📨 ⚪️➡️ 👆 FastAPI 📱: |
|||
|
|||
```JSON |
|||
{ |
|||
"Hello": "World" |
|||
} |
|||
``` |
|||
|
|||
& 🔜 🚶 `/docs` 👆 🛠️, 🖼 🔛 ⚫️ 🔜 `https://qltnci.deta.dev/docs`. |
|||
|
|||
⚫️ 🔜 🎦 👆 🩺 💖: |
|||
|
|||
<img src="/img/deployment/deta/image01.png"> |
|||
|
|||
## 🛠️ 📢 🔐 |
|||
|
|||
🔢, 🪔 🔜 🍵 🤝 ⚙️ 🍪 👆 🏧. |
|||
|
|||
✋️ 🕐 👆 🔜, 👆 💪 ⚒ ⚫️ 📢 ⏮️: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ deta auth disable |
|||
|
|||
Successfully disabled http auth |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
🔜 👆 💪 💰 👈 📛 ⏮️ 🙆 & 👫 🔜 💪 🔐 👆 🛠️. 👶 |
|||
|
|||
## 🇺🇸🔍 |
|||
|
|||
㊗ ❗ 👆 🛠️ 👆 FastAPI 📱 🪔 ❗ 👶 👶 |
|||
|
|||
, 👀 👈 🪔 ☑ 🍵 🇺🇸🔍 👆, 👆 🚫 ✔️ ✊ 💅 👈 & 💪 💭 👈 👆 👩💻 🔜 ✔️ 🔐 🗜 🔗. 👶 👶 |
|||
|
|||
## ✅ 🕶 |
|||
|
|||
⚪️➡️ 👆 🩺 🎚 (👫 🔜 📛 💖 `https://qltnci.deta.dev/docs`) 📨 📨 👆 *➡ 🛠️* `/items/{item_id}`. |
|||
|
|||
🖼 ⏮️ 🆔 `5`. |
|||
|
|||
🔜 🚶 <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>. |
|||
|
|||
👆 🔜 👀 📤 📄 ◀️ 🤙 <abbr title="it comes from Micro(server)">"◾"</abbr> ⏮️ 🔠 👆 📱. |
|||
|
|||
👆 🔜 👀 📑 ⏮️ "ℹ", & 📑 "🕶", 🚶 📑 "🕶". |
|||
|
|||
📤 👆 💪 ✔ ⏮️ 📨 📨 👆 📱. |
|||
|
|||
👆 💪 ✍ 👫 & 🏤-🤾 👫. |
|||
|
|||
<img src="/img/deployment/deta/image02.png"> |
|||
|
|||
## 💡 🌅 |
|||
|
|||
☝, 👆 🔜 🎲 💚 🏪 💽 👆 📱 🌌 👈 😣 🔘 🕰. 👈 👆 💪 ⚙️ <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">🪔 🧢</a>, ⚫️ ✔️ 👍 **🆓 🎚**. |
|||
|
|||
👆 💪 ✍ 🌅 <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">🪔 🩺</a>. |
|||
|
|||
## 🛠️ 🔧 |
|||
|
|||
👟 🔙 🔧 👥 🔬 [🛠️ 🔧](./concepts.md){.internal-link target=_blank}, 📥 ❔ 🔠 👫 🔜 🍵 ⏮️ 🪔: |
|||
|
|||
* **🇺🇸🔍**: 🍵 🪔, 👫 🔜 🤝 👆 📁 & 🍵 🇺🇸🔍 🔁. |
|||
* **🏃♂ 🔛 🕴**: 🍵 🪔, 🍕 👫 🐕🦺. |
|||
* **⏏**: 🍵 🪔, 🍕 👫 🐕🦺. |
|||
* **🧬**: 🍵 🪔, 🍕 👫 🐕🦺. |
|||
* **💾**: 📉 🔁 🪔, 👆 💪 📧 👫 📈 ⚫️. |
|||
* **⏮️ 🔁 ⏭ ▶️**: 🚫 🔗 🐕🦺, 👆 💪 ⚒ ⚫️ 👷 ⏮️ 👫 💾 ⚙️ ⚖️ 🌖 ✍. |
|||
|
|||
!!! note |
|||
🪔 🔧 ⚒ ⚫️ ⏩ (& 🆓) 🛠️ 🙅 🈸 🔜. |
|||
|
|||
⚫️ 💪 📉 📚 ⚙️ 💼, ✋️ 🎏 🕰, ⚫️ 🚫 🐕🦺 🎏, 💖 ⚙️ 🔢 💽 (↖️ ⚪️➡️ 🪔 👍 ☁ 💽 ⚙️), 🛃 🕹 🎰, ♒️. |
|||
|
|||
👆 💪 ✍ 🌅 ℹ <a href="https://docs.deta.sh/docs/micros/about/" class="external-link" target="_blank">🪔 🩺</a> 👀 🚥 ⚫️ ▶️️ ⚒ 👆. |
|||
@ -0,0 +1,17 @@ |
|||
# Deploy FastAPI on Cloud Providers |
|||
|
|||
You can use virtually **any cloud provider** to deploy your FastAPI application. |
|||
|
|||
In most of the cases, the main cloud providers have guides to deploy FastAPI with them. |
|||
|
|||
## Cloud Providers - Sponsors |
|||
|
|||
Some cloud providers ✨ [**sponsor FastAPI**](../help-fastapi.md#sponsor-the-author){.internal-link target=_blank} ✨, this ensures the continued and healthy **development** of FastAPI and its **ecosystem**. |
|||
|
|||
And it shows their true commitment to FastAPI and its **community** (you), as they not only want to provide you a **good service** but also want to make sure you have a **good and healthy framework**, FastAPI. 🙇 |
|||
|
|||
You might want to try their services and follow their guides: |
|||
|
|||
* <a href="https://docs.platform.sh/languages/python.html?utm_source=fastapi-signup&utm_medium=banner&utm_campaign=FastAPI-signup-June-2023" class="external-link" target="_blank">Platform.sh</a> |
|||
* <a href="https://docs.porter.run/language-specific-guides/fastapi" class="external-link" target="_blank">Porter</a> |
|||
* <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> |
|||
@ -1,391 +0,0 @@ |
|||
# Deploy FastAPI on Deta Space |
|||
|
|||
In this section you will learn how to easily deploy a **FastAPI** application on <a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Deta Space</a>, for free. 🎁 |
|||
|
|||
It will take you about **10 minutes** to deploy an API that you can use. After that, you can optionally release it to anyone. |
|||
|
|||
Let's dive in. |
|||
|
|||
!!! info |
|||
<a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Deta</a> is a **FastAPI** sponsor. 🎉 |
|||
|
|||
## A simple **FastAPI** app |
|||
|
|||
* To start, create an empty directory with the name of your app, for example `./fastapi-deta/`, and then navigate into it. |
|||
|
|||
```console |
|||
$ mkdir fastapi-deta |
|||
$ cd fastapi-deta |
|||
``` |
|||
|
|||
### FastAPI code |
|||
|
|||
* Create a `main.py` file with: |
|||
|
|||
```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} |
|||
``` |
|||
|
|||
### Requirements |
|||
|
|||
Now, in the same directory create a file `requirements.txt` with: |
|||
|
|||
```text |
|||
fastapi |
|||
uvicorn[standard] |
|||
``` |
|||
|
|||
### Directory structure |
|||
|
|||
You will now have a directory `./fastapi-deta/` with two files: |
|||
|
|||
``` |
|||
. |
|||
└── main.py |
|||
└── requirements.txt |
|||
``` |
|||
|
|||
## Create a free **Deta Space** account |
|||
|
|||
Next, create a free account on <a href="https://deta.space/signup?dev_mode=true&ref=fastapi" class="external-link" target="_blank">Deta Space</a>, you just need an email and password. |
|||
|
|||
You don't even need a credit card, but make sure **Developer Mode** is enabled when you sign up. |
|||
|
|||
|
|||
## Install the CLI |
|||
|
|||
Once you have your account, install the Deta Space <abbr title="Command Line Interface application">CLI</abbr>: |
|||
|
|||
=== "Linux, macOS" |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ curl -fsSL https://get.deta.dev/space-cli.sh | sh |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
=== "Windows PowerShell" |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ iwr https://get.deta.dev/space-cli.ps1 -useb | iex |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
After installing it, open a new terminal so that the installed CLI is detected. |
|||
|
|||
In a new terminal, confirm that it was correctly installed with: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ space --help |
|||
|
|||
Deta command line interface for managing deta micros. |
|||
Complete documentation available at https://deta.space/docs |
|||
|
|||
Usage: |
|||
space [flags] |
|||
space [command] |
|||
|
|||
Available Commands: |
|||
help Help about any command |
|||
link link code to project |
|||
login login to space |
|||
new create new project |
|||
push push code for project |
|||
release create release for a project |
|||
validate validate spacefile in dir |
|||
version Space CLI version |
|||
... |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
!!! tip |
|||
If you have problems installing the CLI, check the official <a href="https://deta.space/docs/en/basics/cli?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a>. |
|||
|
|||
## Login with the CLI |
|||
|
|||
In order to authenticate your CLI with Deta Space, you will need an access token. |
|||
|
|||
To obtain this token, open your <a href="https://deta.space/login?ref=fastapi" class="external-link" target="_blank">Deta Space Canvas</a>, open the **Teletype** (command bar at the bottom of the Canvas), and then click on **Settings**. From there, select **Generate Token** and copy the resulting token. |
|||
|
|||
<img src="/img/deployment/deta/image03.png"> |
|||
|
|||
Now run `space login` from the Space CLI. Upon pasting the token into the CLI prompt and pressing enter, you should see a confirmation message. |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ space login |
|||
|
|||
To authenticate the Space CLI with your Space account, generate a new access token in your Space settings and paste it below: |
|||
|
|||
# Enter access token (41 chars) >$ ***************************************** |
|||
|
|||
👍 Login Successful! |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
## Create a new project in Space |
|||
|
|||
Now that you've authenticated with the Space CLI, use it to create a new <a href="https://deta.space/docs/en/basics/projects" class="external-link" target="_blank">Space Project</a>: |
|||
|
|||
```console |
|||
$ space new |
|||
|
|||
# What is your project's name? >$ fastapi-deta |
|||
``` |
|||
|
|||
The Space CLI will ask you to name the project, we will call ours `fastapi-deta`. |
|||
|
|||
Then, it will try to automatically detect which framework or language you are using, showing you what it finds. In our case it will identify the Python app with the following message, prompting you to confirm: |
|||
|
|||
```console |
|||
⚙️ No Spacefile found, trying to auto-detect configuration ... |
|||
👇 Deta detected the following configuration: |
|||
|
|||
Micros: |
|||
name: fastapi-deta |
|||
L src: . |
|||
L engine: python3.9 |
|||
|
|||
# Do you want to bootstrap "fastapi-deta" with this configuration? (y/n)$ y |
|||
``` |
|||
|
|||
After you confirm, your project will be created in Deta Space inside a special app called <a href="https://deta.space/docs/en/basics/projects#projects-in-builder?ref=fastapi" class="external-link" target="_blank">Builder</a>. Builder is a toolbox that helps you to create and manage your apps in Deta Space. |
|||
|
|||
The CLI will also create a `Spacefile` locally in the `fastapi-deta` directory. The <a href="https://deta.space/docs/en/reference/spacefile?ref=fastapi" class="external-link" target="_blank">Spacefile</a> is a configuration file which tells Deta Space how to run your app. The `Spacefile` for your app will be as follows: |
|||
|
|||
```yaml |
|||
v: 0 |
|||
micros: |
|||
- name: fastapi-deta |
|||
src: . |
|||
engine: python3.9 |
|||
``` |
|||
|
|||
It is a `yaml` file, and you can use it to add features like scheduled tasks or modify how your app functions, which we'll do later. To learn more, read <a href="https://deta.space/docs/en/reference/spacefile" class="external-link" target="_blank">the `Spacefile` documentation</a>. |
|||
|
|||
!!! tip |
|||
The Space CLI will also create a hidden `.space` folder in your local directory to link your local environment with Deta Space. This folder should not be included in your version control and will automatically be added to your `.gitignore` file, if you have initialized a Git repository. |
|||
|
|||
## Define the run command in the Spacefile |
|||
|
|||
The `run` command in the Spacefile tells Space what command should be executed to start your app. In this case it would be `uvicorn main:app`. |
|||
|
|||
```diff |
|||
v: 0 |
|||
micros: |
|||
- name: fastapi-deta |
|||
src: . |
|||
engine: python3.9 |
|||
+ run: uvicorn main:app |
|||
``` |
|||
|
|||
## Deploy to Deta Space |
|||
|
|||
To get your FastAPI live in the cloud, use one more CLI command: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ space push |
|||
|
|||
---> 100% |
|||
|
|||
build complete... created revision: satyr-jvjk |
|||
|
|||
✔ Successfully pushed your code and created a new Revision! |
|||
ℹ Updating your development instance with the latest Revision, it will be available on your Canvas shortly. |
|||
``` |
|||
</div> |
|||
|
|||
This command will package your code, upload all the necessary files to Deta Space, and run a remote build of your app, resulting in a **revision**. Whenever you run `space push` successfully, a live instance of your API is automatically updated with the latest revision. |
|||
|
|||
!!! tip |
|||
You can manage your <a href="https://deta.space/docs/en/basics/revisions#whats-a-revision" class="external-link" target="_blank">revisions</a> by opening your project in the Builder app. The live copy of your API will be visible under the **Develop** tab in Builder. |
|||
|
|||
## Check it |
|||
|
|||
The live instance of your API will also be added automatically to your Canvas (the dashboard) on Deta Space. |
|||
|
|||
<img src="/img/deployment/deta/image04.png"> |
|||
|
|||
Click on the new app called `fastapi-deta`, and it will open your API in a new browser tab on a URL like `https://fastapi-deta-gj7ka8.deta.app/`. |
|||
|
|||
You will get a JSON response from your FastAPI app: |
|||
|
|||
```JSON |
|||
{ |
|||
"Hello": "World" |
|||
} |
|||
``` |
|||
|
|||
And now you can head over to the `/docs` of your API. For this example, it would be `https://fastapi-deta-gj7ka8.deta.app/docs`. |
|||
|
|||
<img src="/img/deployment/deta/image05.png"> |
|||
|
|||
## Enable public access |
|||
|
|||
Deta will handle authentication for your account using cookies. By default, every app or API that you `push` or install to your Space is personal - it's only accessible to you. |
|||
|
|||
But you can also make your API public using the `Spacefile` from earlier. |
|||
|
|||
With a `public_routes` parameter, you can specify which paths of your API should be available to the public. |
|||
|
|||
Set your `public_routes` to `"*"` to open every route of your API to the public: |
|||
|
|||
```yaml |
|||
v: 0 |
|||
micros: |
|||
- name: fastapi-deta |
|||
src: . |
|||
engine: python3.9 |
|||
public_routes: |
|||
- "/*" |
|||
``` |
|||
|
|||
Then run `space push` again to update your live API on Deta Space. |
|||
|
|||
Once it deploys, you can share your URL with anyone and they will be able to access your API. 🚀 |
|||
|
|||
## HTTPS |
|||
|
|||
Congrats! You deployed your FastAPI app to Deta Space! 🎉 🍰 |
|||
|
|||
Also, notice that Deta Space correctly handles HTTPS for you, so you don't have to take care of that and can be sure that your users will have a secure encrypted connection. ✅ 🔒 |
|||
|
|||
## Create a release |
|||
|
|||
Space also allows you to publish your API. When you publish it, anyone else can install their own copy of your API, in their own Deta Space cloud. |
|||
|
|||
To do so, run `space release` in the Space CLI to create an **unlisted release**: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ space release |
|||
|
|||
# Do you want to use the latest revision (buzzard-hczt)? (y/n)$ y |
|||
|
|||
~ Creating a Release with the latest Revision |
|||
|
|||
---> 100% |
|||
|
|||
creating release... |
|||
publishing release in edge locations.. |
|||
completed... |
|||
released: fastapi-deta-exp-msbu |
|||
https://deta.space/discovery/r/5kjhgyxewkdmtotx |
|||
|
|||
Lift off -- successfully created a new Release! |
|||
Your Release is available globally on 5 Deta Edges |
|||
Anyone can install their own copy of your app. |
|||
``` |
|||
</div> |
|||
|
|||
This command publishes your revision as a release and gives you a link. Anyone you give this link to can install your API. |
|||
|
|||
|
|||
You can also make your app publicly discoverable by creating a **listed release** with `space release --listed` in the Space CLI: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ space release --listed |
|||
|
|||
# Do you want to use the latest revision (buzzard-hczt)? (y/n)$ y |
|||
|
|||
~ Creating a listed Release with the latest Revision ... |
|||
|
|||
creating release... |
|||
publishing release in edge locations.. |
|||
completed... |
|||
released: fastapi-deta-exp-msbu |
|||
https://deta.space/discovery/@user/fastapi-deta |
|||
|
|||
Lift off -- successfully created a new Release! |
|||
Your Release is available globally on 5 Deta Edges |
|||
Anyone can install their own copy of your app. |
|||
Listed on Discovery for others to find! |
|||
``` |
|||
</div> |
|||
|
|||
This will allow anyone to find and install your app via <a href="https://deta.space/discovery?ref=fastapi" class="external-link" target="_blank">Deta Discovery</a>. Read more about <a href="https://deta.space/docs/en/basics/releases?ref=fastapi" class="external-link" target="_blank">releasing your app in the docs</a>. |
|||
|
|||
## Check runtime logs |
|||
|
|||
Deta Space also lets you inspect the logs of every app you build or install. |
|||
|
|||
Add some logging functionality to your app by adding a `print` statement to your `main.py` file. |
|||
|
|||
```py |
|||
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): |
|||
print(item_id) |
|||
return {"item_id": item_id} |
|||
``` |
|||
|
|||
The code within the `read_item` function includes a print statement that will output the `item_id` that is included in the URL. Send a request to your _path operation_ `/items/{item_id}` from the docs UI (which will have a URL like `https://fastapi-deta-gj7ka8.deta.app/docs`), using an ID like `5` as an example. |
|||
|
|||
Now go to your <a href="https://deta.space?ref=fastapi" class="external-link" target="_blank">Space's Canvas</a>. Click on the context menu (`...`) of your live app instance, and then click on **View Logs**. Here you can view your app's logs, sorted by time. |
|||
|
|||
<img src="/img/deployment/deta/image06.png"> |
|||
|
|||
## Learn more |
|||
|
|||
At some point, you will probably want to store some data for your app in a way that persists through time. For that you can use <a href="https://deta.space/docs/en/basics/data#deta-base?ref=fastapi" class="external-link" target="_blank">Deta Base</a> and <a href="https://deta.space/docs/en/basics/data#deta-drive?ref=fastapi" class="external-link" target="_blank">Deta Drive</a>, both of which have a generous **free tier**. |
|||
|
|||
You can also read more in the <a href="https://deta.space/docs/?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a>. |
|||
|
|||
!!! tip |
|||
If you have any Deta related questions, comments, or feedback, head to the <a href="https://go.deta.dev/discord" class="external-link" target="_blank">Deta Discord server</a>. |
|||
|
|||
|
|||
## Deployment Concepts |
|||
|
|||
Coming back to the concepts we discussed in [Deployments Concepts](./concepts.md){.internal-link target=_blank}, here's how each of them would be handled with Deta Space: |
|||
|
|||
- **HTTPS**: Handled by Deta Space, they will give you a subdomain and handle HTTPS automatically. |
|||
- **Running on startup**: Handled by Deta Space, as part of their service. |
|||
- **Restarts**: Handled by Deta Space, as part of their service. |
|||
- **Replication**: Handled by Deta Space, as part of their service. |
|||
- **Authentication**: Handled by Deta Space, as part of their service. |
|||
- **Memory**: Limit predefined by Deta Space, you could contact them to increase it. |
|||
- **Previous steps before starting**: Can be configured using the <a href="https://deta.space/docs/en/reference/spacefile?ref=fastapi" class="external-link" target="_blank">`Spacefile`</a>. |
|||
|
|||
!!! note |
|||
Deta Space is designed to make it easy and free to build cloud applications for yourself. Then you can optionally share them with anyone. |
|||
|
|||
It can simplify several use cases, but at the same time, it doesn't support others, like using external databases (apart from Deta's own NoSQL database system), custom virtual machines, etc. |
|||
|
|||
You can read more details in the <a href="https://deta.space/docs/en/basics/micros?ref=fastapi" class="external-link" target="_blank">Deta Space Documentation</a> to see if it's the right choice for you. |
|||
@ -1,245 +0,0 @@ |
|||
# 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,240 +0,0 @@ |
|||
# Deta にデプロイ |
|||
|
|||
このセクションでは、**FastAPI** アプリケーションを <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> の無料プランを利用して、簡単にデプロイする方法を学習します。🎁 |
|||
|
|||
所要時間は約**10分**です。 |
|||
|
|||
!!! info "備考" |
|||
<a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> は **FastAPI** のスポンサーです。🎉 |
|||
|
|||
## ベーシックな **FastAPI** アプリ |
|||
|
|||
* アプリのためのディレクトリ (例えば `./fastapideta/`) を作成し、その中に入ってください。 |
|||
|
|||
### FastAPI のコード |
|||
|
|||
* 以下の `main.py` ファイルを作成してください: |
|||
|
|||
```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} |
|||
``` |
|||
|
|||
### Requirements |
|||
|
|||
では、同じディレクトリに以下の `requirements.txt` ファイルを作成してください: |
|||
|
|||
```text |
|||
fastapi |
|||
``` |
|||
|
|||
!!! tip "豆知識" |
|||
アプリのローカルテストのために Uvicorn をインストールしたくなるかもしれませんが、Deta へのデプロイには不要です。 |
|||
|
|||
### ディレクトリ構造 |
|||
|
|||
以下の2つのファイルと1つの `./fastapideta/` ディレクトリがあるはずです: |
|||
|
|||
``` |
|||
. |
|||
└── main.py |
|||
└── requirements.txt |
|||
``` |
|||
|
|||
## Detaの無料アカウントの作成 |
|||
|
|||
それでは、<a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Detaの無料アカウント</a>を作成しましょう。必要なものはメールアドレスとパスワードだけです。 |
|||
|
|||
クレジットカードさえ必要ありません。 |
|||
|
|||
## CLIのインストール |
|||
|
|||
アカウントを取得したら、Deta <abbr title="Command Line Interface application">CLI</abbr> をインストールしてください: |
|||
|
|||
=== "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> |
|||
|
|||
インストールしたら、インストールした CLI を有効にするために新たなターミナルを開いてください。 |
|||
|
|||
新たなターミナル上で、正しくインストールされたか確認します: |
|||
|
|||
<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 "豆知識" |
|||
CLI のインストールに問題が発生した場合は、<a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">Deta 公式ドキュメント</a>を参照してください。 |
|||
|
|||
## CLIでログイン |
|||
|
|||
CLI から Deta にログインしてみましょう: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ deta login |
|||
|
|||
Please, log in from the web page. Waiting.. |
|||
Logged in successfully. |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
自動的にウェブブラウザが開いて、認証処理が行われます。 |
|||
|
|||
## Deta でデプロイ |
|||
|
|||
次に、アプリケーションを Deta CLIでデプロイしましょう: |
|||
|
|||
<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> |
|||
|
|||
次のようなJSONメッセージが表示されます: |
|||
|
|||
```JSON hl_lines="4" |
|||
{ |
|||
"name": "fastapideta", |
|||
"runtime": "python3.7", |
|||
"endpoint": "https://qltnci.deta.dev", |
|||
"visor": "enabled", |
|||
"http_auth": "enabled" |
|||
} |
|||
``` |
|||
|
|||
!!! tip "豆知識" |
|||
あなたのデプロイでは異なる `"endpoint"` URLが表示されるでしょう。 |
|||
|
|||
## 確認 |
|||
|
|||
それでは、`endpoint` URLをブラウザで開いてみましょう。上記の例では `https://qltnci.deta.dev` ですが、あなたのURLは異なるはずです。 |
|||
|
|||
FastAPIアプリから返ってきたJSONレスポンスが表示されます: |
|||
|
|||
```JSON |
|||
{ |
|||
"Hello": "World" |
|||
} |
|||
``` |
|||
|
|||
そして `/docs` へ移動してください。上記の例では、`https://qltnci.deta.dev/docs` です。 |
|||
|
|||
次のようなドキュメントが表示されます: |
|||
|
|||
<img src="/img/deployment/deta/image01.png"> |
|||
|
|||
## パブリックアクセスの有効化 |
|||
|
|||
デフォルトでは、Deta はクッキーを用いてアカウントの認証を行います。 |
|||
|
|||
しかし、準備が整えば、以下の様に公開できます: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ deta auth disable |
|||
|
|||
Successfully disabled http auth |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
ここで、URLを共有するとAPIにアクセスできるようになります。🚀 |
|||
|
|||
## HTTPS |
|||
|
|||
おめでとうございます！あなたの FastAPI アプリが Deta へデプロイされました！🎉 🍰 |
|||
|
|||
また、DetaがHTTPSを正しく処理するため、その処理を行う必要がなく、クライアントは暗号化された安全な通信が利用できます。✅ 🔒 |
|||
|
|||
## Visor を確認 |
|||
|
|||
ドキュメントUI (`https://qltnci.deta.dev/docs` のようなURLにある) は *path operation* `/items/{item_id}` へリクエストを送ることができます。 |
|||
|
|||
ID `5` の例を示します。 |
|||
|
|||
まず、<a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a> へアクセスします。 |
|||
|
|||
左側に各アプリの <abbr title="it comes from Micro(server)">「Micros」</abbr> というセクションが表示されます。 |
|||
|
|||
また、「Details」や「Visor」タブが表示されています。「Visor」タブへ移動してください。 |
|||
|
|||
そこでアプリに送られた直近のリクエストが調べられます。 |
|||
|
|||
また、それらを編集してリプレイできます。 |
|||
|
|||
<img src="/img/deployment/deta/image02.png"> |
|||
|
|||
## さらに詳しく知る |
|||
|
|||
様々な箇所で永続的にデータを保存したくなるでしょう。そのためには <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a> を使用できます。惜しみない **無料利用枠** もあります。 |
|||
|
|||
詳しくは <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">Deta ドキュメント</a>を参照してください。 |
|||
@ -1,258 +0,0 @@ |
|||
# Implantação FastAPI na Deta |
|||
|
|||
Nessa seção você aprenderá sobre como realizar a implantação de uma aplicação **FastAPI** na <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> utilizando o plano gratuito. 🎁 |
|||
|
|||
Isso tudo levará aproximadamente **10 minutos**. |
|||
|
|||
!!! info "Informação" |
|||
<a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">Deta</a> é uma patrocinadora do **FastAPI**. 🎉 |
|||
|
|||
## Uma aplicação **FastAPI** simples |
|||
|
|||
* Crie e entre em um diretório para a sua aplicação, por exemplo, `./fastapideta/`. |
|||
|
|||
### Código FastAPI |
|||
|
|||
* Crie o arquivo `main.py` com: |
|||
|
|||
```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} |
|||
``` |
|||
|
|||
### Requisitos |
|||
|
|||
Agora, no mesmo diretório crie o arquivo `requirements.txt` com: |
|||
|
|||
```text |
|||
fastapi |
|||
``` |
|||
|
|||
!!! tip "Dica" |
|||
Você não precisa instalar Uvicorn para realizar a implantação na Deta, embora provavelmente queira instalá-lo para testar seu aplicativo localmente. |
|||
|
|||
### Estrutura de diretório |
|||
|
|||
Agora você terá o diretório `./fastapideta/` com dois arquivos: |
|||
|
|||
``` |
|||
. |
|||
└── main.py |
|||
└── requirements.txt |
|||
``` |
|||
|
|||
## Crie uma conta gratuita na Deta |
|||
|
|||
Agora crie <a href="https://www.deta.sh/?ref=fastapi" class="external-link" target="_blank">uma conta gratuita na Deta</a>, você precisará apenas de um email e senha. |
|||
|
|||
Você nem precisa de um cartão de crédito. |
|||
|
|||
## Instale a CLI |
|||
|
|||
Depois de ter sua conta criada, instale Deta <abbr title="Interface de Linha de Comando">CLI</abbr>: |
|||
|
|||
=== "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> |
|||
|
|||
Após a instalação, abra um novo terminal para que a CLI seja detectada. |
|||
|
|||
Em um novo terminal, confirme se foi instalado corretamente com: |
|||
|
|||
<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 "Dica" |
|||
Se você tiver problemas ao instalar a CLI, verifique a <a href="https://docs.deta.sh/docs/micros/getting_started?ref=fastapi" class="external-link" target="_blank">documentação oficial da Deta</a>. |
|||
|
|||
## Login pela CLI |
|||
|
|||
Agora faça login na Deta pela CLI com: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ deta login |
|||
|
|||
Please, log in from the web page. Waiting.. |
|||
Logged in successfully. |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
Isso abrirá um navegador da Web e autenticará automaticamente. |
|||
|
|||
## Implantação com Deta |
|||
|
|||
Em seguida, implante seu aplicativo com a Deta CLI: |
|||
|
|||
<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> |
|||
|
|||
Você verá uma mensagem JSON semelhante a: |
|||
|
|||
```JSON hl_lines="4" |
|||
{ |
|||
"name": "fastapideta", |
|||
"runtime": "python3.7", |
|||
"endpoint": "https://qltnci.deta.dev", |
|||
"visor": "enabled", |
|||
"http_auth": "enabled" |
|||
} |
|||
``` |
|||
|
|||
!!! tip "Dica" |
|||
Sua implantação terá um URL `"endpoint"` diferente. |
|||
|
|||
## Confira |
|||
|
|||
Agora, abra seu navegador na URL do `endpoint`. No exemplo acima foi `https://qltnci.deta.dev`, mas o seu será diferente. |
|||
|
|||
Você verá a resposta JSON do seu aplicativo FastAPI: |
|||
|
|||
```JSON |
|||
{ |
|||
"Hello": "World" |
|||
} |
|||
``` |
|||
|
|||
Agora vá para o `/docs` da sua API, no exemplo acima seria `https://qltnci.deta.dev/docs`. |
|||
|
|||
Ele mostrará sua documentação como: |
|||
|
|||
<img src="/img/deployment/deta/image01.png"> |
|||
|
|||
## Permitir acesso público |
|||
|
|||
Por padrão, a Deta lidará com a autenticação usando cookies para sua conta. |
|||
|
|||
Mas quando estiver pronto, você pode torná-lo público com: |
|||
|
|||
<div class="termy"> |
|||
|
|||
```console |
|||
$ deta auth disable |
|||
|
|||
Successfully disabled http auth |
|||
``` |
|||
|
|||
</div> |
|||
|
|||
Agora você pode compartilhar essa URL com qualquer pessoa e elas conseguirão acessar sua API. 🚀 |
|||
|
|||
## HTTPS |
|||
|
|||
Parabéns! Você realizou a implantação do seu app FastAPI na Deta! 🎉 🍰 |
|||
|
|||
Além disso, observe que a Deta lida corretamente com HTTPS para você, para que você não precise cuidar disso e tenha a certeza de que seus clientes terão uma conexão criptografada segura. ✅ 🔒 |
|||
|
|||
## Verifique o Visor |
|||
|
|||
Na UI da sua documentação (você estará em um URL como `https://qltnci.deta.dev/docs`) envie um request para *operação de rota* `/items/{item_id}`. |
|||
|
|||
Por exemplo com ID `5`. |
|||
|
|||
Agora vá para <a href="https://web.deta.sh/" class="external-link" target="_blank">https://web.deta.sh</a>. |
|||
|
|||
Você verá que há uma seção à esquerda chamada <abbr title="it comes from Micro(server)">"Micros"</abbr> com cada um dos seus apps. |
|||
|
|||
Você verá uma aba com "Detalhes", e também a aba "Visor", vá para "Visor". |
|||
|
|||
Lá você pode inspecionar as solicitações recentes enviadas ao seu aplicativo. |
|||
|
|||
Você também pode editá-los e reproduzi-los novamente. |
|||
|
|||
<img src="/img/deployment/deta/image02.png"> |
|||
|
|||
## Saiba mais |
|||
|
|||
Em algum momento, você provavelmente desejará armazenar alguns dados para seu aplicativo de uma forma que persista ao longo do tempo. Para isso você pode usar <a href="https://docs.deta.sh/docs/base/py_tutorial?ref=fastapi" class="external-link" target="_blank">Deta Base</a>, que também tem um generoso **nível gratuito**. |
|||
|
|||
Você também pode ler mais na <a href="https://docs.deta.sh?ref=fastapi" class="external-link" target="_blank">documentação da Deta</a>. |
|||
|
|||
## Conceitos de implantação |
|||
|
|||
Voltando aos conceitos que discutimos em [Deployments Concepts](./concepts.md){.internal-link target=_blank}, veja como cada um deles seria tratado com a Deta: |
|||
|
|||
* **HTTPS**: Realizado pela Deta, eles fornecerão um subdomínio e lidarão com HTTPS automaticamente. |
|||
* **Executando na inicialização**: Realizado pela Deta, como parte de seu serviço. |
|||
* **Reinicialização**: Realizado pela Deta, como parte de seu serviço. |
|||
* **Replicação**: Realizado pela Deta, como parte de seu serviço. |
|||
* **Memória**: Limite predefinido pela Deta, você pode contatá-los para aumentá-lo. |
|||
* **Etapas anteriores a inicialização**: Não suportado diretamente, você pode fazê-lo funcionar com o sistema Cron ou scripts adicionais. |
|||
|
|||
!!! note "Nota" |
|||
O Deta foi projetado para facilitar (e gratuitamente) a implantação rápida de aplicativos simples. |
|||
|
|||
Ele pode simplificar vários casos de uso, mas, ao mesmo tempo, não suporta outros, como o uso de bancos de dados externos (além do próprio sistema de banco de dados NoSQL da Deta), máquinas virtuais personalizadas, etc. |
|||
|
|||
Você pode ler mais detalhes na <a href="https://docs.deta.sh/docs/micros/about/" class="external-link" target="_blank">documentação da Deta</a> para ver se é a escolha certa para você. |
|||
Loading…
Reference in new issue