Add Spanish translation for deploy/fly.md (#1034)

docs/basics/async.es.md

@@ -312,7 +312,7 @@ print(string) /// String
 
 ### Esperar
 
-!!! warning Advertencia
+!!! warning "Advertencia"
     La función `wait()` está obsoleta, ver [`Get`](#get) para el enfoque recomendado.
 
 Puedes utilizar `.wait()` para esperar sincrónicamente a que se complete el futuro. Dado que un futuro puede fracasar, esta función puede lanzar errores (throwing).

docs/deploy/fly.es.md

@@ -0,0 +1,215 @@
+# Fly
+
+Fly es una plataforma de alojamiento que permite ejecutar aplicaciones de servidor y bases de datos, con un enfoque en la computación descentralizada. Consulta [su página web](https://fly.io/) para más información.
+
+!!! note "Nota"
+    Los comandos especificados en este documento están sujetos a [los precios de Fly](https://fly.io/docs/about/pricing/). Asegúrate de entenderlos correctamente antes de continuar.
+
+## Registrarse
+
+Si no tienes una cuenta, necesitas [crear una](https://fly.io/app/sign-up).
+
+## Instalando flyctl
+
+La principal forma de interactuar con Fly es utilizando su herramienta CLI dedicada, `flyctl`, que necesitarás instalar.
+
+### macOS
+
+```bash
+brew install flyctl
+```
+
+### Linux
+
+```bash
+curl -L https://fly.io/install.sh | sh
+```
+
+### Otras opciones de instalación
+
+Para más opciones y detalles, consulta la [documentación sobre la instalación de flyctl](https://fly.io/docs/flyctl/install/).
+
+## Iniciar sesión
+
+Para iniciar sesión desde tu terminal, ejecuta el siguiente comando:
+
+```bash
+fly auth login
+```
+
+## Configurando tu proyecto de Vapor
+
+Antes de desplegar en Fly, debes asegurarte de tener un proyecto de Vapor con un Dockerfile configurado adecuadamente, ya que Fly lo requiere para construir tu aplicación. En la mayoría de los casos, esto será muy sencillo porque las plantillas predeterminadas de Vapor ya incluyen uno.
+
+### Nuevo proyecto de Vapor
+
+La forma más fácil de crear un nuevo proyecto es comenzar con una plantilla. Puedes crear uno utilizando las plantillas de GitHub o la herramienta Vapor toolbox. Si necesitas una base de datos, se recomienda usar Fluent con Postgres, ya que Fly facilita la creación de una base de datos Postgres para conectar tus aplicaciones (consulta la [sección dedicada](#configurando-postgres) más abajo).
+
+#### Usando la Vapor toolbox
+
+Primero, asegúrate de haber instalado la Vapor toolbox (consulta las instrucciones para instalarla en [macOS](../install/macos.md#install-toolbox) o [Linux](../install/linux.md#install-toolbox)).
+
+Crea tu nueva aplicación con el siguiente comando, reemplazando `app-name` por el nombre que desees:
+
+```bash
+vapor new app-name
+```
+
+Este comando mostrará un asistente interactivo que te permitirá configurar tu proyecto de Vapor. Aquí es donde puedes seleccionar Fluent y Postgres si los necesitas.
+
+#### Usando plantillas de GitHub
+
+Elige la plantilla que mejor se adapte a tus necesidades de la siguiente lista. Puedes clonarla localmente usando Git o crear un proyecto en GitHub con el botón “Use this template”.
+
+- [Barebones template](https://github.com/vapor/template-bare)
+- [Fluent/Postgres template](https://github.com/vapor/template-fluent-postgres)
+- [Fluent/Postgres + Leaf template](https://github.com/vapor/template-fluent-postgres-leaf)
+
+### Proyecto existente de Vapor
+
+Si ya tienes un proyecto de Vapor, asegúrate de tener un `Dockerfile` configurado adecuadamente en la raíz de tu directorio. La [documentación de Vapor sobre el uso de Docker](../deploy/docker.md) y la [documentación de Fly sobre el despliegue de una app mediante un Dockerfile](https://fly.io/docs/languages-and-frameworks/dockerfile/) pueden ser útiles.
+
+## Lanzando tu aplicación en Fly
+
+Una vez que tu proyecto de Vapor esté listo, puedes lanzarlo en Fly.
+
+Primero, asegúrate de que tu directorio actual esté en la raíz de tu aplicación de Vapor y ejecuta el siguiente comando:
+
+```bash
+fly launch
+```
+
+Esto iniciará un asistente interactivo para configurar los ajustes de tu aplicación en Fly:
+
+- **Name:** puedes escribir un nombre o dejarlo en blanco para que se genere automáticamente.
+- **Region:** el valor predeterminado será la más cercana a ti. Puedes usarla o elegir otra de la lista. Esto es fácil de cambiar más tarde.
+- **Database:** puedes pedir a Fly que cree una base de datos para usar con tu aplicación. Si prefieres, siempre puedes hacerlo más tarde con los comandos `fly pg create` y `fly pg attach` (consulta la sección [Configurando Postgres](#configurando-postgres) para más detalles).
+
+El comando `fly launch` crea automáticamente un archivo `fly.toml`. Éste contiene configuraciones como asignaciones de puertos privados y/o públicos, parámetros de comprobación de estado, entre otros. Si acabas de crear un proyecto nuevo con `vapor new`, el archivo `fly.toml` predeterminado no necesita cambios. Si tienes un proyecto existente, es probable que el archivo `fly.toml` también esté bien sin cambios o solo con ajustes menores. Puedes encontrar más información en la [documentación de `fly.toml`](https://fly.io/docs/reference/configuration/).
+
+Nota que si solicitas a Fly crear una base de datos, tendrás que esperar un poco a que se cree y que pasen las verificaciones de estado.
+
+Antes de salir, el comando `fly launch` te preguntará si deseas desplegar tu aplicación de inmediato. Puedes aceptarlo o hacerlo más tarde usando `fly deploy`.
+
+!!! tip "Consejo"
+    Cuando tu directorio actual está en la raíz de tu aplicación, la herramienta CLI de Fly detecta automáticamente la presencia de un archivo `fly.toml`, lo que permite a Fly saber a qué aplicación están dirigidos tus comandos. Si deseas apuntar a una aplicación específica sin importar en qué directorio te encuentres, puedes agregar `-a name-of-your-app` a la mayoría de los comandos de Fly.
+
+## Desplegando
+
+Ejecuta el comando `fly deploy` cada vez que necesites desplegar nuevos cambios en Fly.
+
+Fly lee los archivos `Dockerfile` y `fly.toml` de tu directorio para determinar cómo construir y ejecutar tu proyecto de Vapor.
+
+Una vez que tu contenedor se construye, Fly inicia una instancia de él. Ejecutará varias comprobaciones de estado para asegurarse de que tu aplicación funciona correctamente y responde a las solicitudes. El comando `fly deploy` saldrá con un error si las comprobaciones de estado fallan.
+
+Por defecto, Fly volverá a la última versión funcional de tu aplicación si las comprobaciones de estado fallan para la nueva versión que intentaste desplegar.
+
+## Configurando Postgres
+
+### Creando una base de datos Postgres en Fly
+
+Si no creaste una aplicación de base de datos cuando lanzaste tu aplicación por primera vez, puedes hacerlo más tarde con:
+
+```bash
+fly pg create
+```
+
+Este comando crea una aplicación de Fly que podrá alojar bases de datos disponibles para tus otras aplicaciones en Fly. Consulta la [documentación dedicada de Fly](https://fly.io/docs/postgres/) para más detalles.
+
+Una vez que tu aplicación de base de datos esté creada, ve al directorio raíz de tu aplicación de Vapor y ejecuta:
+
+```bash
+fly pg attach name-of-your-postgres-app
+```
+
+Si no sabes el nombre de tu aplicación Postgres, puedes encontrarlo con `fly pg list`.
+
+El comando `fly pg attach` crea una base de datos y un usuario destinado a tu aplicación, y luego la expone a través de la variable de entorno `DATABASE_URL`.
+
+!!! note "Nota"
+    La diferencia entre `fly pg create` y `fly pg attach` es que el primero asigna y configura una aplicación de Fly que puede alojar bases de datos Postgres, mientras que el segundo crea una base de datos real y un usuario destinado a la aplicación de tu elección. Siempre que cumpla con tus requisitos, una sola aplicación de Postgres en Fly puede alojar múltiples bases de datos utilizadas por varias aplicaciones. Cuando pides a Fly crear una aplicación de base de datos en `fly launch`, hace el equivalente a llamar tanto a `fly pg create` como a `fly pg attach`.
+
+### Conectando tu aplicación de Vapor a la base de datos
+
+Una vez que tu aplicación esté conectada a tu base de datos, Fly configura la variable de entorno `DATABASE_URL` con la URL de conexión que contiene tus credenciales (debe tratarse como información sensible).
+
+En la mayoría de las configuraciones comunes de proyectos de Vapor, configuras tu base de datos en `configure.swift`. Aquí tienes un ejemplo de cómo hacerlo:
+
+```swift
+if let databaseURL = Environment.get("DATABASE_URL") {
+    try app.databases.use(.postgres(url: databaseURL), as: .psql)
+} else {
+    // Manejar la ausencia de DATABASE_URL aquí...
+    //
+    // Alternativamente, también podrías establecer una configuración 
+    // diferente dependiendo de si app.environment está configurado como 
+    // `.development` o `.production`.
+}
+```
+
+En este punto, tu proyecto debería estar listo para ejecutar migraciones y usar la base de datos.
+
+### Ejecutando migraciones
+
+Con el comando `release_command` de `fly.toml`, puedes pedir a Fly que ejecute un cierto comando antes de ejecutar tu proceso principal del servidor. Agrega esto a `fly.toml`:
+
+```toml
+[deploy]
+ release_command = "migrate -y"
+```
+
+!!! note "Nota"
+    El fragmento de código anterior asume que estás utilizando el Dockerfile predeterminado de Vapor, que establece tu `ENTRYPOINT` como `./App`. Concretamente, esto significa que cuando configuras `release_command` como `migrate -y`, Fly llamará a `./App migrate -y`. Si tu `ENTRYPOINT` está configurado en un valor diferente, necesitarás adaptar el valor de `release_command`.
+
+Fly ejecutará tu comando de lanzamiento en una instancia temporal que tiene acceso a tu red interna de Fly, secrets y variables de entorno.
+
+Si tu comando de lanzamiento falla, el despliegue no continuará.
+
+### Otras bases de datos
+
+Aunque Fly facilita la creación de una aplicación de base de datos Postgres, es posible alojar otros tipos de bases de datos también (por ejemplo, consulta [“Use a MySQL database”](https://fly.io/docs/app-guides/mysql-on-fly/) en la documentación de Fly).
+
+## Secrets y variables de entorno
+
+### Secrets
+
+Usa secrets para establecer cualquier valor sensible como variables de entorno.
+
+```bash
+ fly secrets set MYSECRET=A_SUPER_SECRET_VALUE
+```
+
+!!! warning "Advertencia"
+    Ten en cuenta que la mayoría de las shells mantienen un historial de los comandos que escribes. Sé cauteloso al configurar secrets de esta manera. Algunas shells pueden configurarse para no recordar comandos que están precedidos por un espacio. Consulta también el [comando `fly secrets import`](https://fly.io/docs/flyctl/secrets-import/).
+
+Para más información, consulta la [documentación de `fly secrets`](https://fly.io/docs/apps/secrets/).
+
+### Variables de entorno
+
+Puedes establecer otras [variables de entorno no sensibles en `fly.toml`](https://fly.io/docs/reference/configuration/#the-env-variables-section), por ejemplo:
+
+```toml
+[env]
+  MAX_API_RETRY_COUNT = "3"
+  SMS_LOG_LEVEL = "error"
+```
+
+## Conexión SSH
+
+Puedes conectarte a las instancias de una aplicación utilizando:
+
+```bash
+fly ssh console -s
+```
+
+## Verificando los registros
+
+Puedes verificar los registros en vivo de tu aplicación utilizando:
+
+```bash
+fly logs
+```
+
+## Próximos pasos
+
+Ahora que tu aplicación de Vapor está desplegada, hay mucho más que puedes hacer, como escalar tus aplicaciones vertical y horizontalmente en múltiples regiones, añadir volúmenes persistentes, configurar despliegues contínuos, o incluso crear clústeres de aplicaciones distribuidas. El mejor lugar para aprender cómo hacer todo esto y más es la [documentación de Fly](https://fly.io/docs/).

docs/deploy/fly.md

@@ -22,7 +22,7 @@ curl -L https://fly.io/install.sh | sh
 ```
 
 ### Other install options
-For more options and details, see [the `flyctl` installation docs](https://fly.io/docs/hands-on/install-flyctl/).
+For more options and details, see [the `flyctl` installation docs](https://fly.io/docs/flyctl/install/).
 
 ## Logging in
 To log in from your terminal, run the following command:
@@ -53,7 +53,7 @@ Choose the template that best suits your needs in the following list. You can ei
 - [Fluent/Postgres + Leaf template](https://github.com/vapor/template-fluent-postgres-leaf)
 
 ### Existing Vapor project
-If you have an existing Vapor project, make sure you have a properly configured `Dockerfile` present at the root of your directory; the [Vapor docs about using Docker](../deploy/docker.md) and [Fly docs about deploying an app via a Dockerfile](https://fly.io/docs/getting-started/dockerfile/) might come in handy.
+If you have an existing Vapor project, make sure you have a properly configured `Dockerfile` present at the root of your directory; the [Vapor docs about using Docker](../deploy/docker.md) and [Fly docs about deploying an app via a Dockerfile](https://fly.io/docs/languages-and-frameworks/dockerfile/) might come in handy.
 
 ## Launch your app on Fly
 Once your Vapor project is ready, you can launch it on Fly.
@@ -95,7 +95,7 @@ If you didn't create a database app when you first launched your app, you can do
 fly pg create
 ```
 
-This command creates a Fly app that will be able to host databases available to your other apps on Fly, see the [dedicated Fly docs](https://fly.io/docs/reference/postgres/) for more details.
+This command creates a Fly app that will be able to host databases available to your other apps on Fly, see the [dedicated Fly docs](https://fly.io/docs/postgres/) for more details.
 
 Once your database app is created, go to your Vapor app's root directory and run:
 ```bash
@@ -154,7 +154,7 @@ Use secrets to set any sensitive values as environment variables.
 !!! warning
     Keep in mind that most shells keep an history of the commands you typed. Be cautious about this when setting secrets this way. Some shells can be configured to not remember commands that are prefixed by a whitespace. See also the [`fly secrets import` command](https://fly.io/docs/flyctl/secrets-import/).
 
-For more information, see the [documentation of `fly secrets`](https://fly.io/docs/reference/secrets/).
+For more information, see the [documentation of `fly secrets`](https://fly.io/docs/apps/secrets/).
 
 ### Environment variables
 You can set other non-sensitive [environment variables in `fly.toml`](https://fly.io/docs/reference/configuration/#the-env-variables-section), for instance:

docs/deploy/fly.nl.md

@@ -22,7 +22,7 @@ curl -L https://fly.io/install.sh | sh
 ```
 
 ### Andere installatiemogelijkheden
-Voor meer opties en details, zie [de `flyctl` installatie docs](https://fly.io/docs/hands-on/install-flyctl/).
+Voor meer opties en details, zie [de `flyctl` installatie docs](https://fly.io/docs/flyctl/install/).
 
 ## Aanmelden
 Om aan te melden vanuit je terminal, voer je het volgende commando uit:
@@ -54,7 +54,7 @@ Kies in de volgende lijst het sjabloon dat het beste bij uw behoeften past. Je k
 - [Fluent/Postgres + Leaf template](https://github.com/vapor/template-fluent-postgres-leaf)
 
 ### Bestaand Vapor project
-Als je een bestaand Vapor-project hebt, zorg er dan voor dat je een goed geconfigureerde `Dockerfile` in de root van je map hebt staan; de [Vapor docs over het gebruik van Docker](../deploy/docker.md) en [Fly docs over het deployen van een app via een Dockerfile](https://fly.io/docs/getting-started/dockerfile/) kunnen van pas komen.
+Als je een bestaand Vapor-project hebt, zorg er dan voor dat je een goed geconfigureerde `Dockerfile` in de root van je map hebt staan; de [Vapor docs over het gebruik van Docker](../deploy/docker.md) en [Fly docs over het deployen van een app via een Dockerfile](https://fly.io/docs/languages-and-frameworks/dockerfile/) kunnen van pas komen.
 
 ## Start uw app op Fly
 Zodra uw Vapor-project klaar is, kunt u het lanceren op Fly.
@@ -96,7 +96,7 @@ Als u geen database-app hebt gemaakt toen u uw app voor het eerst lanceerde, kun
 fly pg create
 ```
 
-Dit commando creëert een Fly app die databases kan hosten die beschikbaar zijn voor uw andere apps op Fly, zie de [toegewijde Fly documentatie](https://fly.io/docs/reference/postgres/) voor meer details.
+Dit commando creëert een Fly app die databases kan hosten die beschikbaar zijn voor uw andere apps op Fly, zie de [toegewijde Fly documentatie](https://fly.io/docs/postgres/) voor meer details.
 
 Zodra uw database-app is gemaakt, gaat u naar de hoofdmap van uw Vapor-app en voert u dit commando uit:
 ```bash
@@ -155,7 +155,7 @@ Gebruik geheimen om gevoelige waarden in te stellen als omgevingsvariabelen.
 !!! warning "Waarschuwing"
     Onthoud dat de meeste shells een geschiedenis bijhouden van de commando's die je getypt hebt. Wees hier voorzichtig mee als je op deze manier geheimen instelt. Sommige shells kunnen geconfigureerd worden om commando's die voorafgegaan worden door een spatie niet te onthouden. Zie ook het [`fly secrets import` commando](https://fly.io/docs/flyctl/secrets-import/).
 
-Voor meer informatie, bekijk de [documentatie van `fly secrets`](https://fly.io/docs/reference/secrets/).
+Voor meer informatie, bekijk de [documentatie van `fly secrets`](https://fly.io/docs/apps/secrets/).
 
 ### Omgevingsvariabelen
 U kunt andere niet-gevoelige [omgevingsvariabelen instellen in `fly.toml`](https://fly.io/docs/reference/configuration/#the-env-variables-section), bijvoorbeeld:

docs/deploy/fly.zh.md

@@ -22,7 +22,7 @@ curl -L https://fly.io/install.sh | sh
 ```
 
 ### 其它安装选项
-有关更多选项和详细信息，请参阅 [flyctl 文档](https://fly.io/docs/hands-on/install-flyctl/)。
+有关更多选项和详细信息，请参阅 [flyctl 文档](https://fly.io/docs/flyctl/install/)。
 
 ## 登录
 通过终端登录，运行如下命令：
@@ -52,7 +52,7 @@ vapor new app-name
 - [Fluent/Postgres + Leaf template](https://github.com/vapor/template-fluent-postgres-leaf)
 
 ### 已有的 Vapor 项目
-如果你有一个现有的 Vapor 项目，请确保项目的根目录中有一个正确配置的 `Dockerfile` 文件；[Vapor 文档中关于使用 Docker](../deploy/docker.zh.md) 和 [Fly 文档中关于通过 Dockerfile 部署应用程序](https://fly.io/docs/getting-started/dockerfile/)可能会对你有所帮助。
+如果你有一个现有的 Vapor 项目，请确保项目的根目录中有一个正确配置的 `Dockerfile` 文件；[Vapor 文档中关于使用 Docker](../deploy/docker.zh.md) 和 [Fly 文档中关于通过 Dockerfile 部署应用程序](https://fly.io/docs/languages-and-frameworks/dockerfile/)可能会对你有所帮助。
 
 ## 在 Fly 上启动应用
 一旦你的 Vapor 项目准备就绪，就可以在 Fly 上启动它。
@@ -94,7 +94,7 @@ Fly 会读取你的目录中的 `Dockerfile` 和 `fly.toml` 文件来确定如
 fly pg create
 ```
 
-这个命令创建了一个 Fly 应用程序，可以为其他 Fly 上的应用程序提供数据库服务，详情请参阅 [Fly 文档](https://fly.io/docs/reference/postgres/)。
+这个命令创建了一个 Fly 应用程序，可以为其他 Fly 上的应用程序提供数据库服务，详情请参阅 [Fly 文档](https://fly.io/docs/postgres/)。
 
 创建完数据库应用之后，进入你的 Vapor 应用程序的根目录，运行以下命令：
 ```bash
@@ -153,7 +153,7 @@ Fly 将在具有访问 Fly 内部网络、密钥和环境变量的临时实例
 !!! warning "警告"
     请注意，大多数 shell 都会保留你输入的命令历史记录。在使用此方式设置密钥时要注意。某些 shell 可以配置为不记录以空格为前缀的命令。请参阅 [`fly secrets import` 命令](https://fly.io/docs/flyctl/secrets-import/)的文档。
 
-更多信息，请参阅 [`fly secrets` 文档](https://fly.io/docs/reference/secrets/) 。
+更多信息，请参阅 [`fly secrets` 文档](https://fly.io/docs/apps/secrets/) 。
 
 ### 环境变量
 你可以在 [`fly.toml`](https://fly.io/docs/reference/configuration/#the-env-variables-section) 中设置其他非敏感的环境变量，例如：