From 7aa29bb6fb518bc9c6dd2448e8397551adffb95e Mon Sep 17 00:00:00 2001 From: Dunkan <70066170+dcdunkan@users.noreply.github.com> Date: Tue, 18 Jun 2024 18:04:17 +0530 Subject: [PATCH 01/12] Update Deno Deploy guide --- site/docs/hosting/deno-deploy.md | 43 ++++++++++++++++---------------- 1 file changed, 22 insertions(+), 21 deletions(-) diff --git a/site/docs/hosting/deno-deploy.md b/site/docs/hosting/deno-deploy.md index 7700219ab..0f67716b9 100644 --- a/site/docs/hosting/deno-deploy.md +++ b/site/docs/hosting/deno-deploy.md @@ -20,7 +20,7 @@ The result of this tutorial [can be seen in our example bots repository](https:/ > Remember that you need to [run your bot on webhooks](../guide/deployment-types#how-to-use-webhooks), so you should use `webhookCallback` and not call `bot.start()` in your code. 1. Make sure that you have a file which exports your `Bot` object, so that you can import it later to run it. -2. Create a file named `mod.ts` or `mod.js`, or actually any name you like (but you should be remembering and using this as the main file to deploy), with the following content: +2. Create a file named `main.ts` or `main.js`, or actually any name you like (but you should be remembering and using this as the main file to deploy), with the following content: ```ts import { webhookCallback } from "https://deno.land/x/grammy/mod.ts"; @@ -59,42 +59,43 @@ Here, we are using the bot token (`/`). > It is recommended that you have a single stable branch and you do your testing stuff in other branches, so that you won't get some unexpected things happen. -3. Visit your [Deno Deploy dashboard](https://dash.deno.com/projects). -4. Click on "New Project", and go to the "Deploy from GitHub repository" section. +3. Visit your [Deno Deploy dashboard](https://dash.deno.com/account/overview). +4. Click on "New Project". 5. Install the GitHub app on your account or organization, and choose your repository. -6. Select the branch you want to deploy, and then choose your `mod.ts` file to be deployed. +6. Select the branch you want to deploy. +7. Select the entrypoint file `main.ts`, and click "Deploy Project" to deploy. ### Method 2: With `deployctl` -> This is a method for more advanced users. It allows you to deploy the project via the command line or Github Actions. +> This is a method for more advanced users or if you don't want to upload your code to GitHub. +> It allows you to deploy the project via the command line or Github Actions. -1. Visit your [Deno Deploy dashboard](https://dash.deno.com/projects). -2. Click "New Project", and then "Empty Project". -3. Install [`deployctl`](https://github.com/denoland/deployctl). -4. [Create an access token](https://dash.deno.com/account#access-tokens). -5. Run the following command: +1. Install [`deployctl`](https://github.com/denoland/deployctl). +2. Create an access token from the "Access Tokens" section in [account settings](https://dash.deno.com/account). +3. Go to your project directory and run the following command: - ```sh - deployctl deploy --project ./mod.ts --prod --token + ```sh:no-line-numbers + deployctl deploy --project= --entrypoint=./main.ts --prod --token= ``` -6. To set up Github Actions, refer to [this](https://github.com/denoland/deployctl/blob/main/action/README.md). + ::: tip Setting environment variables + Environment variables can be set by heading to your project's settings after deploying. -### Method 3: With URL + But this is also possible from the command line as well: + 1. You can assign environment variables from a dotenv file by adding the `--env-file=` argument. + 2. You can also specify them individually by using the `--env=` argument. + ::: +4. To set up Github Actions, refer to [this](https://github.com/denoland/deployctl/blob/main/action/README.md). -> All you need for following this method to deploy your grammY bot, is a public URL to your `mod.ts` file. - -1. Create a new project on Deno Deploy. -2. Click "Deploy URL". -3. Input the public URL to your `mod.ts` file, and click "Deploy". +Checkout the [deployctl documentation](https://docs.deno.com/deploy/manual/deployctl) for more information. ### Note After getting your app running, you should configure your bot's webhook settings to point to your app. To do that, send a request to -```text -https://api.telegram.org/bot/setWebhook?url= +```http:no-line-numbers +GET https://api.telegram.org/bot/setWebhook?url= ``` replacing `` with your bot token, and `` with the full URL of your app along with the path to the webhook handler. From faed25ae973b703be1503b7ad9f996754d1d45d3 Mon Sep 17 00:00:00 2001 From: Dunkan <70066170+dcdunkan@users.noreply.github.com> Date: Tue, 18 Jun 2024 18:06:23 +0530 Subject: [PATCH 02/12] fmt --- site/docs/hosting/deno-deploy.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/site/docs/hosting/deno-deploy.md b/site/docs/hosting/deno-deploy.md index 0f67716b9..03863aa45 100644 --- a/site/docs/hosting/deno-deploy.md +++ b/site/docs/hosting/deno-deploy.md @@ -74,18 +74,19 @@ Here, we are using the bot token (`/`). 2. Create an access token from the "Access Tokens" section in [account settings](https://dash.deno.com/account). 3. Go to your project directory and run the following command: - ```sh:no-line-numbers - deployctl deploy --project= --entrypoint=./main.ts --prod --token= - ``` +```sh:no-line-numbers +deployctl deploy --project= --entrypoint=./main.ts --prod --token= +``` + +::: tip Setting environment variables +Environment variables can be set by heading to your project's settings after deploying. - ::: tip Setting environment variables - Environment variables can be set by heading to your project's settings after deploying. +But this is also possible from the command line as well: - But this is also possible from the command line as well: - 1. You can assign environment variables from a dotenv file by adding the `--env-file=` argument. - 2. You can also specify them individually by using the `--env=` argument. +1. You can assign environment variables from a dotenv file by adding the `--env-file=` argument. +2. You can also specify them individually by using the `--env=` argument. ::: -4. To set up Github Actions, refer to [this](https://github.com/denoland/deployctl/blob/main/action/README.md). +3. To set up Github Actions, refer to [this](https://github.com/denoland/deployctl/blob/main/action/README.md). Checkout the [deployctl documentation](https://docs.deno.com/deploy/manual/deployctl) for more information. From 84431e7405b567d86699e53f2f83d16f4751b372 Mon Sep 17 00:00:00 2001 From: Dunkan <70066170+dcdunkan@users.noreply.github.com> Date: Tue, 18 Jun 2024 18:20:08 +0530 Subject: [PATCH 03/12] fmt --- site/docs/hosting/deno-deploy.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/site/docs/hosting/deno-deploy.md b/site/docs/hosting/deno-deploy.md index 03863aa45..b8da64e70 100644 --- a/site/docs/hosting/deno-deploy.md +++ b/site/docs/hosting/deno-deploy.md @@ -73,20 +73,20 @@ Here, we are using the bot token (`/`). 1. Install [`deployctl`](https://github.com/denoland/deployctl). 2. Create an access token from the "Access Tokens" section in [account settings](https://dash.deno.com/account). 3. Go to your project directory and run the following command: + ```sh:no-line-numbers + deployctl deploy --project= --entrypoint=./main.ts --prod --token= + ``` -```sh:no-line-numbers -deployctl deploy --project= --entrypoint=./main.ts --prod --token= -``` + ::: tip Setting environment variables + Environment variables can be set by heading to your project's settings after deploying. -::: tip Setting environment variables -Environment variables can be set by heading to your project's settings after deploying. + But this is also possible from the command line as well: -But this is also possible from the command line as well: + 1. You can assign environment variables from a dotenv file by adding the `--env-file=` argument. + 2. You can also specify them individually by using the `--env=` argument. -1. You can assign environment variables from a dotenv file by adding the `--env-file=` argument. -2. You can also specify them individually by using the `--env=` argument. ::: -3. To set up Github Actions, refer to [this](https://github.com/denoland/deployctl/blob/main/action/README.md). +4. To set up Github Actions, refer to [this](https://github.com/denoland/deployctl/blob/main/action/README.md). Checkout the [deployctl documentation](https://docs.deno.com/deploy/manual/deployctl) for more information. From 4b96892f63cab6fa0ab99aad0e32db064b6452c2 Mon Sep 17 00:00:00 2001 From: Dunkan <70066170+dcdunkan@users.noreply.github.com> Date: Tue, 18 Jun 2024 22:20:10 +0530 Subject: [PATCH 04/12] Apply suggestions from code review Co-authored-by: KnorpelSenf --- site/docs/hosting/deno-deploy.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/site/docs/hosting/deno-deploy.md b/site/docs/hosting/deno-deploy.md index b8da64e70..7d3fbb4b1 100644 --- a/site/docs/hosting/deno-deploy.md +++ b/site/docs/hosting/deno-deploy.md @@ -68,7 +68,7 @@ Here, we are using the bot token (`/`). ### Method 2: With `deployctl` > This is a method for more advanced users or if you don't want to upload your code to GitHub. -> It allows you to deploy the project via the command line or Github Actions. +> It allows you to deploy the project via the command line or GitHub Actions. 1. Install [`deployctl`](https://github.com/denoland/deployctl). 2. Create an access token from the "Access Tokens" section in [account settings](https://dash.deno.com/account). @@ -80,15 +80,15 @@ Here, we are using the bot token (`/`). ::: tip Setting environment variables Environment variables can be set by heading to your project's settings after deploying. - But this is also possible from the command line as well: + But this is possible from the command line, as well: 1. You can assign environment variables from a dotenv file by adding the `--env-file=` argument. 2. You can also specify them individually by using the `--env=` argument. ::: -4. To set up Github Actions, refer to [this](https://github.com/denoland/deployctl/blob/main/action/README.md). +4. To set up GitHub Actions, refer to [this](https://github.com/denoland/deployctl/blob/main/action/README.md). -Checkout the [deployctl documentation](https://docs.deno.com/deploy/manual/deployctl) for more information. +Check out the [deployctl documentation](https://docs.deno.com/deploy/manual/deployctl) for more information. ### Note From 4bd77e66faec09b0346ffe3a703a085570cfb6e5 Mon Sep 17 00:00:00 2001 From: Dunkan <70066170+dcdunkan@users.noreply.github.com> Date: Tue, 18 Jun 2024 23:14:52 +0530 Subject: [PATCH 05/12] fix linting error --- site/docs/hosting/deno-deploy.md | 1 + 1 file changed, 1 insertion(+) diff --git a/site/docs/hosting/deno-deploy.md b/site/docs/hosting/deno-deploy.md index 7d3fbb4b1..a348e24aa 100644 --- a/site/docs/hosting/deno-deploy.md +++ b/site/docs/hosting/deno-deploy.md @@ -73,6 +73,7 @@ Here, we are using the bot token (`/`). 1. Install [`deployctl`](https://github.com/denoland/deployctl). 2. Create an access token from the "Access Tokens" section in [account settings](https://dash.deno.com/account). 3. Go to your project directory and run the following command: + ```sh:no-line-numbers deployctl deploy --project= --entrypoint=./main.ts --prod --token= ``` From c5458522018a44f2be90fdce2d79ed77fa360e86 Mon Sep 17 00:00:00 2001 From: Dunkan <70066170+dcdunkan@users.noreply.github.com> Date: Wed, 3 Jul 2024 15:43:54 +0530 Subject: [PATCH 06/12] make the http request a curl command --- site/docs/hosting/deno-deploy.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/docs/hosting/deno-deploy.md b/site/docs/hosting/deno-deploy.md index a348e24aa..d49409092 100644 --- a/site/docs/hosting/deno-deploy.md +++ b/site/docs/hosting/deno-deploy.md @@ -96,8 +96,8 @@ Check out the [deployctl documentation](https://docs.deno.com/deploy/manual/depl After getting your app running, you should configure your bot's webhook settings to point to your app. To do that, send a request to -```http:no-line-numbers -GET https://api.telegram.org/bot/setWebhook?url= +```sh:no-line-numbers +curl https://api.telegram.org/bot/setWebhook?url= ``` replacing `` with your bot token, and `` with the full URL of your app along with the path to the webhook handler. From c869292ed496a9f57f40b460766c2a800415ea9a Mon Sep 17 00:00:00 2001 From: Qz Date: Mon, 15 Jul 2024 08:45:27 +0700 Subject: [PATCH 07/12] Sync changes to Indonesian --- site/docs/id/hosting/deno-deploy.md | 41 ++++++++++++++++++----------- 1 file changed, 26 insertions(+), 15 deletions(-) diff --git a/site/docs/id/hosting/deno-deploy.md b/site/docs/id/hosting/deno-deploy.md index 16f8186dc..62268b168 100644 --- a/site/docs/id/hosting/deno-deploy.md +++ b/site/docs/id/hosting/deno-deploy.md @@ -22,7 +22,7 @@ Hasil dari tutorial disini dapat dilihat di [repositori bot kami](https://github > Ingat! Kamu perlu [menjalankan bot dengan webhooks](../guide/deployment-types#bagaimana-cara-menggunakan-webhook), jadi kamu harus menggunakan `webhookCallback` alih-alih memanggil `bot.start()` di kodemu. 1. Pastikan kamu meng-export object bot di dalam sebuah file agar nantinya bisa di-import ketika ingin menjalankannya. -2. Buat sebuah file dengan nama `mod.ts` atau `mod.js`, ataupun nama lainnya sesuai dengan keinginanmu (tetapi kamu harus mengingatnya karena nanti file tersebut akan digunakan sebagai file deploy utama). File tersebut berisikan: +2. Buat sebuah file dengan nama `main.ts` atau `main.js`, ataupun nama lainnya sesuai dengan keinginanmu (tetapi kamu harus mengingatnya karena nanti file tersebut akan digunakan sebagai file deploy utama). File tersebut berisikan: ```ts import { webhookCallback } from "https://deno.land/x/grammy/mod.ts"; @@ -62,26 +62,37 @@ Di contoh kali ini, kita menggunakan token bot (`/`) sebagai direktor > Direkomendasikan untuk mempunyai satu branch stabil dan branch lain untuk pengetesan supaya branch utama kamu terhindar dari hal-hal yang tidak diinginkan. -3. Kunjungi [dashboard Deno Deploy](https://dash.deno.com/projects). -4. Pilih "New Project", lalu pergi ke bagian "Deploy from GitHub repository". +3. Kunjungi [dashboard Deno Deploy](https://dash.deno.com/account/overview). +4. Pilih "New Project". 5. Pasang aplikasi GitHub di akun atau organisasimu, kemudian pilih repositori kode bot kamu berada. -6. Pilih branch dan file `mod.ts` yang akan di-deploy. +6. Pilih branch yang akan di-deploy. +7. Pilih file `main.ts` sebagai entrypoint, lalu deploy proyek dengan mengklik "Deploy Project". ### Metode 2: Menggunakan `deployctl` -> Metode ini diperuntukkan kepada pengguna tingkat lanjut yang nantinya proyek akan di-deploy melalui command line atau GitHub Actions. +> Metode ini diperuntukkan untuk penggunaan tingkat lanjut atau jika kamu tidak ingin mengunggah kode proyek ke GitHub. +> Melalui cara ini, kamu bisa men-deploy proyek menggunakan command line atau GitHub Actions. -1. Kunjungi [dashboard Deno Deploy](https://dash.deno.com/projects). -2. Pilih "New Project", kemudian pilih "Empty Project". -3. Pasang [`deployctl`](https://github.com/denoland/deployctl). -4. Buat [token akses](https://dash.deno.com/account#access-tokens) baru. -5. Jalankan dengan perintah: +1. Instal [`deployctl`](https://github.com/denoland/deployctl). +2. Buat sebuah token akses di bagian "Access Tokens", [pengaturan akun](https://dash.deno.com/account). +3. Pergi ke direktori proyek, lalu jalankan perintah berikut: - ```sh - deployctl deploy --project ./mod.ts --prod --token + ```sh:no-line-numbers + deployctl deploy --project= --entrypoint=./main.ts --prod --token= ``` -6. Untuk menyiapkan GitHub Actions, dapat merujuk ke [sini](https://github.com/denoland/deployctl/blob/main/action/README.md). + ::: tip Mengatur environment variable + Setelah di-deploy, kamu bisa mengatur environment variable di bagian pengaturan proyek. + + Selain melalui pengaturan proyek, kamu juga bisa mengaturnya melalui command line: + + 1. Taruh semua environment variable di file dotenv, lalu akses dengan menambahkan argumen `--env-file=`. + 2. Kamu juga bisa menambahkan environment variable satu per satu menggunakan argumen `--env=`. + + ::: +4. Untuk mengatur GitHub Actions, lihat panduan [berikut](https://github.com/denoland/deployctl/blob/main/action/README.md). + +Lihat [dokumentasi deployctl](https://docs.deno.com/deploy/manual/deployctl) untuk informasi lebih lanjut. ### Metode 3: Menggunakan URL @@ -95,8 +106,8 @@ Di contoh kali ini, kita menggunakan token bot (`/`) sebagai direktor Setelah mendapati bot-mu dapat berjalan, kamu harus melakukan konfigurasi pada pengaturan webhook untuk menggunakan URL bot-mu yang baru. -```text -https://api.telegram.org/bot/setWebhook?url= +```sh:no-line-numbers +curl https://api.telegram.org/bot/setWebhook?url= ``` Ganti `` dengan token bot-mu, dan `` dengan URL lengkap bot kamu. From a6e67cf2b72e94daf47879d68c2ac48362a9a362 Mon Sep 17 00:00:00 2001 From: Nazar Antoniuk Date: Mon, 15 Jul 2024 09:17:31 +0300 Subject: [PATCH 08/12] sync to Ukrainian --- site/docs/uk/hosting/deno-deploy.md | 44 ++++++++++++++++------------- 1 file changed, 24 insertions(+), 20 deletions(-) diff --git a/site/docs/uk/hosting/deno-deploy.md b/site/docs/uk/hosting/deno-deploy.md index 051de5c57..508164f51 100644 --- a/site/docs/uk/hosting/deno-deploy.md +++ b/site/docs/uk/hosting/deno-deploy.md @@ -20,7 +20,7 @@ Deno Deploy ідеально підходить для більшості про > Памʼятайте, що вам потрібно [запустити свого бота на вебхуках](../guide/deployment-types#як-використовувати-вебхуки), тому ви повинні використовувати `webhookCallback` і не викликати `bot.start()` у своєму коді. 1. Переконайтеся, що у вас є файл, який експортує ваш обʼєкт `Bot`, щоб ви могли імпортувати його пізніше для запуску. -2. Створіть файл з назвою `mod.ts` або `mod.js` або насправді будь-якою назвою, яку ви хочете, але ви повинні памʼятати та використовувати його як головний файл для розгортання, із наступним вмістом: +2. Створіть файл з назвою `main.ts` або `main.js` або насправді будь-якою назвою, яку ви хочете, але ви повинні памʼятати та використовувати його як головний файл для розгортання, із наступним вмістом: ```ts import { webhookCallback } from "https://deno.land/x/grammy/mod.ts"; @@ -59,42 +59,46 @@ Deno.serve(async (req) => { > Рекомендується мати одну стабільну гілку, а тестувати свої напрацювання в інших гілках, щоб уникнути непередбачуваних помилок. -3. Відвідайте свою [панель керування Deno Deploy](https://dash.deno.com/projects). -4. Натисніть на "New Project" і перейдіть до розділу "Deploy from GitHub repository". +3. Відвідайте свою [панель керування Deno Deploy](https://dash.deno.com/account/overview). +4. Натисніть на "New Project". 5. Встановіть GitHub-застосунок Deno Deploy на свій обліковий запис або організацію та виберіть свій репозиторій. -6. Виберіть гілку, яку ви хочете розгорнути, а потім виберіть файл `mod.ts` для розгортання. +6. Виберіть гілку, яку ви хочете розгорнути. +7. Виберіть вхідний файл `main.ts` і натисніть "Deploy Project", щоб розгорнути проєкт. ### 2-й метод: за допомогою `deployctl` -> Це метод для більш досвідчених користувачів. Він дозволяє розгорнути проєкт за допомогою командного рядка або Github Actions. +> Це метод для більш досвідчених користувачів або якщо ви не хочете розміщувати свій код на GitHub. +> Він дозволяє розгорнути проєкт через командний рядок або GitHub Actions. -1. Відвідайте свою [панель керування Deno Deploy](https://dash.deno.com/projects). -2. Натисніть на "New Project", а потім на "Empty Project". -3. Встановіть [`deployctl`](https://github.com/denoland/deployctl). -4. [Створіть токен доступу](https://dash.deno.com/account#access-tokens). -5. Виконайте наступну команду: +1. Встановіть [`deployctl`](https://github.com/denoland/deployctl). +2. Створіть токен доступу в розділі "Access Tokens" в [налаштуваннях облікового запису](https://dash.deno.com/account). +3. Перейдіть до каталогу вашого проєкту і виконайте наступну команду: - ```sh - deployctl deploy --project <назва-проєкту> ./mod.ts --prod --token <токен-доступу> + ```sh:no-line-numbers + deployctl deploy --project=<назва-проєкту> --entrypoint=./main.ts --prod --token=<токен-доступу> ``` -6. Щоб налаштувати Github Actions, дивіться [це](https://github.com/denoland/deployctl/blob/main/action/README.md). + ::: tip Налаштування змінних середовища + Змінні середовища можна встановити, перейшовши до налаштувань вашого проєкту після розгортання. -### 3-й метод: за допомогою URL + Також це можна зробити з командного рядка: -> Все, що вам потрібно зробити, щоб скористатися цим методом для розгортання вашого бота на grammY, --- це отримати публічний URL-адрес вашого файлу `mod.ts`. + 1. Ви можете призначити змінні оточення з dotenv-файлу, додавши аргумент `--env-file=<файл>`. + 2. Ви також можете вказати їх окремо за допомогою аргументу `--env=<ключ=значення>`. -1. Створіть новий проєкт на Deno Deploy. -2. Натисніть на "Deploy URL". -3. Введіть загальнодоступну URL-адресу вашого файлу `mod.ts` і натисніть на "Deploy". + ::: + +4. Щоб налаштувати Github Actions, дивіться [це](https://github.com/denoland/deployctl/blob/main/action/README.md). + +Перегляньте [документацію deployctl](https://docs.deno.com/deploy/manual/deployctl) для отримання додаткової інформації. ### Примітка Після запуску застосунку вам потрібно налаштувати вебхук вашого бота так, щоб він вказував на URL-адресу вашого застосунку. Для цього надішліть запит на адресу -```text -https://api.telegram.org/bot<токен-бота>/setWebhook?url=<адреса> +```sh:no-line-numbers +curl https://api.telegram.org/bot<токен-бота>/setWebhook?url=<адреса> ``` замінивши `<токен-бота>` на токен вашого бота, а `<адреса>` --- на повну URL-адресу вашого застосунку разом з шляхом до обробника вебхуків. From b2f23d816f5ab20b8b15fe511ff039294ac8c479 Mon Sep 17 00:00:00 2001 From: DzikrL <150493299+dzikrl@users.noreply.github.com> Date: Tue, 16 Jul 2024 08:01:19 +0700 Subject: [PATCH 09/12] Sync changes Remove text --- site/docs/id/hosting/deno-deploy.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/site/docs/id/hosting/deno-deploy.md b/site/docs/id/hosting/deno-deploy.md index 62268b168..6cf713fde 100644 --- a/site/docs/id/hosting/deno-deploy.md +++ b/site/docs/id/hosting/deno-deploy.md @@ -94,14 +94,6 @@ Di contoh kali ini, kita menggunakan token bot (`/`) sebagai direktor Lihat [dokumentasi deployctl](https://docs.deno.com/deploy/manual/deployctl) untuk informasi lebih lanjut. -### Metode 3: Menggunakan URL - -> Kamu memerlukan URL publik yang mengarah ke file `mod.ts`-mu untuk menggunakan metode ini. - -1. Buat proyek baru di Deno Deploy. -2. Pilih "Deploy URL" -3. Masukkan URL publik file `mod.ts`-mu, lalu pilih "Deploy". - ### Catatan Setelah mendapati bot-mu dapat berjalan, kamu harus melakukan konfigurasi pada pengaturan webhook untuk menggunakan URL bot-mu yang baru. From e3768847f480164833574937ac7c18647e887127 Mon Sep 17 00:00:00 2001 From: Acer <> Date: Wed, 17 Jul 2024 13:15:57 +0000 Subject: [PATCH 10/12] sync zh #1081 --- site/docs/zh/hosting/deno-deploy.md | 43 +++++++++++++++-------------- 1 file changed, 23 insertions(+), 20 deletions(-) diff --git a/site/docs/zh/hosting/deno-deploy.md b/site/docs/zh/hosting/deno-deploy.md index 440da1b3b..6f00677b2 100644 --- a/site/docs/zh/hosting/deno-deploy.md +++ b/site/docs/zh/hosting/deno-deploy.md @@ -20,7 +20,7 @@ Deno Deploy 是大多数简单 bot 的理想选择，并且你应该注意，Den > 请注意，你需要 [在 webhooks 上运行你的 bot](../guide/deployment-types#如何使用-webhooks)，所以你应该调用 `webhookCallback`，而不是 `bot.start()`。 1. 确保你有一个文件可以导出你的`Bot`对象，这样你就可以在以后导入它来运行它。 -2. 创建一个名为 `mod.ts` 或 `mod.js` 的文件，或任何你喜欢的名字（但你应该记住并使用这个文件作为部署的主要文件），其内容如下： +2. 创建一个名为 `main.ts` 或 `main.js` 的文件，或任何你喜欢的名字（但你应该记住并使用这个文件作为部署的主要文件），其内容如下： ```ts import { webhookCallback } from "https://deno.land/x/grammy/mod.ts"; @@ -59,42 +59,45 @@ Deno.serve(async (req) => { > 建议你有一个单一且稳定的分支，然后在其他分支中进行测试，这样你就不会发送一些意外的事情。 -3. 访问你的 [Deno Deploy 仪表台](https://dash.deno.com/projects)。 -4. 点击 "New Project"，然后进入 "Deploy from GitHub repository" 部分 +3. 访问你的 [Deno Deploy 仪表台](https://dash.deno.com/account/overview)。 +4. 点击 "New Project"。 5. 安装 GitHub 应用程序到你的账户或组织，并选择你的仓库。 -6. 选择你想部署的分支，然后选择你要部署的`mod.ts`文件 +6. 选择你想部署的分支，然后选择你要部署的`mod.ts`文件。 +7. 选择入口文件 `main.ts`，然后点击 "Deploy Project" 进行部署。 ### 方法 2: 使用 `deployctl` -> 这是一个更高级的方法，它允许你通过命令行或 Github Actions 来部署项目。 +> 这是一种适用于更高级用户或者不想将代码上传到 GitHub 的方法。 +> 它允许你通过命令行或 Github Actions 来部署项目。 -1. 访问你的 [Deno Deploy 仪表台](https://dash.deno.com/projects). -2. 点击 "New Project"，然后再选择 "Empty Project". -3. 安装 [`deployctl`](https://github.com/denoland/deployctl). -4. [创建一个访问 token](https://dash.deno.com/account#access-tokens). -5. 执行以下命令： +1. 安装 [`deployctl`](https://github.com/denoland/deployctl)。 +2. 从 [account settings](https://dash.deno.com/account) 中的 "Access Tokens" 部分创建访问令牌。 +3. 转到你的项目目录并运行以下命令： - ```sh - deployctl deploy --project ./mod.ts --prod --token + ```sh:no-line-numbers + deployctl deploy --project= --entrypoint=./main.ts --prod --token= ``` -6. 配置 GitHub Action，请参考 [这里](https://github.com/denoland/deployctl/blob/main/action/README.md). + ::: tip 设置环境变量 + 部署后可以前往项目的设置来设置环境变量。 -### 方法 3：使用 URL + 但这也可以通过命令行实现： -> 按照这个方法部署你的 grammY bot，你只需要一个到你的 `mod.ts` 的公开 URL。 + 1. 你可以通过添加 `--env-file=` 参数从 dotenv 文件添加环境变量。 + 2. 你还可以使用 `--env=` 参数单独指定它们。 -1. 在 Deno Deploy 上创建一个新的项目。 -2. 点击 "Deploy URL"。 -3. 输入你的 `mod.ts` 文件的公开 URL，然后点击 "Deploy"。 + ::: +4. 要设置 GitHub Actions，请参考 [这里](https://github.com/denoland/deployctl/blob/main/action/README.md)。 + +查看 [deployctl 文档](https://docs.deno.com/deploy/manual/deployctl) 了解更多信息。 ### 注意 在部署完成后，你需要配置你的 bot 的 webhook 设置来指向你的 app。 为了配置 webhook，发送一个请求到 -```text -https://api.telegram.org/bot/setWebhook?url= +```sh:no-line-numbers +curl https://api.telegram.org/bot/setWebhook?url= ``` 将 `` 替换为你的 bot 的 token，并将 `` 替换为你的 app 的完整的 URL 以及 webhook 处理程序的路径。 From 23d3a430d5ade563b7a8b49e4c3935ff64453e0f Mon Sep 17 00:00:00 2001 From: Habemuscode <{ID}+{username}@users.noreply.github.com> Date: Sat, 20 Jul 2024 21:16:59 +0200 Subject: [PATCH 11/12] Add Spanish --- site/docs/es/hosting/deno-deploy.md | 43 +++++++++++++++-------------- 1 file changed, 23 insertions(+), 20 deletions(-) diff --git a/site/docs/es/hosting/deno-deploy.md b/site/docs/es/hosting/deno-deploy.md index b0d38e76f..b1e449344 100644 --- a/site/docs/es/hosting/deno-deploy.md +++ b/site/docs/es/hosting/deno-deploy.md @@ -20,7 +20,7 @@ El resultado de este tutorial [puede verse en nuestro repositorio de bots de eje > Recuerda que necesitas [ejecutar tu bot en webhhoks](../guide/deployment-types#como-usar-webhooks), por lo que debes usar `webhookCallback` y no llamar a `bot.start()` en tu código. 1. Asegúrate de que tienes un archivo que exporta tu objeto `Bot`, para que puedas importarlo después para ejecutarlo. -2. Crea un archivo llamado `mod.ts` o `mod.js`, o en realidad cualquier nombre que te guste (pero deberías recordar y usar este como el archivo principal para desplegar), con el siguiente contenido: +2. Crea un archivo llamado `main.ts` o `main.js`, o en realidad cualquier nombre que te guste (pero deberías recordar y usar este como el archivo principal para desplegar), con el siguiente contenido: ```ts import { Bot, webhookCallback } from "https://deno.land/x/grammy/mod.ts"; @@ -59,42 +59,45 @@ Aquí, estamos usando el token del bot (`/`). > Es recomendable que tengas una única rama estable y que hagas tus pruebas en otras ramas, para que no te ocurran cosas inesperadas. -3. Visita tu [Deno Deploy dashboard](https://dash.deno.com/projects). -4. Haz clic en "Nuevo proyecto", y ve a la sección "Despliegue desde el repositorio de GitHub". +3. Visite su [Deno Deploy dashboard](https://dash.deno.com/account/overview). +4. Haga clic en "Nuevo proyecto". 5. Instala la app de GitHub en tu cuenta u organización, y elige tu repositorio. -6. Selecciona la rama que quieres desplegar, y luego elige tu archivo `mod.ts` para ser desplegado. +6. Selecciona la rama que quieres desplegar. +7. Selecciona el archivo de entrada `main.ts`, y haz clic en "Deploy Project" para desplegar. ### Método 2: Con `deployctl` -> Este es un método para usuarios más avanzados. Te permite desplegar el proyecto a través de la línea de comandos o de las acciones de Github. +> Este es un método para usuarios más avanzados o si no quieres subir tu código a GitHub. +> Te permite desplegar el proyecto a través de la línea de comandos o de las GitHub Actions. -1. Visita tu [Deno Deploy dashboard](https://dash.deno.com/projects). -2. Haz clic en "Nuevo proyecto", y luego en "Proyecto vacío". -3. Instale [`deployctl`](https://github.com/denoland/deployctl). -4. [Crear un token de acceso](https://dash.deno.com/account). -5. Ejecuta el siguiente comando: +1. Instala [`deployctl`](https://github.com/denoland/deployctl). +2. Crea un token de acceso desde la sección "Access Tokens" en [configuración de la cuenta](https://dash.deno.com/account). +3. Vaya al directorio de su proyecto y ejecute el siguiente comando: - ```sh - deployctl deploy --project ./mod.ts --prod --token + ```sh:no-line-numbers + deployctl deploy --project= --entrypoint=./main.ts --prod --token= ``` -6. Para configurar las acciones de Github, consulte [esto](https://github.com/denoland/deployctl/blob/main/action/README.md). + ::: tip Configuración de variables de entorno + Las variables de entorno pueden establecerse accediendo a la configuración del proyecto después de desplegarlo. -### Método 3: Con URL + Pero esto también es posible desde la línea de comandos: -> Todo lo que necesitas para seguir este método para desplegar tu bot de grammY, es una URL pública a tu archivo `mod.ts`. + 1. Puedes asignar variables de entorno desde un archivo dotenv añadiendo el argumento `--env-file=`. + 2. También puede especificarlas individualmente utilizando el argumento `--env=`. -1. Crea un nuevo proyecto en Deno Deploy. -2. Haz clic en "Desplegar URL". -3. Introduzca la URL pública de su archivo `mod.ts` y haga clic en "Deploy". +::: +4. Para configurar las Acciones de GitHub, consulta [this](https://github.com/denoland/deployctl/blob/main/action/README.md). + +Consulta la [documentación de deployctl](https://docs.deno.com/deploy/manual/deployctl) para más información. ### Nota Después de poner en marcha tu aplicación, debes configurar los ajustes de los webhooks de tu bot para que apunten a tu aplicación. Para ello, envía una petición a -```text -https://api.telegram.org/bot/setWebhook?url= +```sh:no-line-numbers +curl https://api.telegram.org/bot/setWebhook?url= ``` sustituyendo `` por el token de tu bot, y `` por la URL completa de tu aplicación junto con la ruta al manejador del webhook. From 1d6660956d2ebd3f173cc6b290415f3f074d2d11 Mon Sep 17 00:00:00 2001 From: Habemuscode <{ID}+{username}@users.noreply.github.com> Date: Sat, 20 Jul 2024 21:18:00 +0200 Subject: [PATCH 12/12] Add missing space --- site/docs/es/hosting/deno-deploy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/docs/es/hosting/deno-deploy.md b/site/docs/es/hosting/deno-deploy.md index b1e449344..6d2c2a732 100644 --- a/site/docs/es/hosting/deno-deploy.md +++ b/site/docs/es/hosting/deno-deploy.md @@ -86,7 +86,7 @@ Aquí, estamos usando el token del bot (`/`). 1. Puedes asignar variables de entorno desde un archivo dotenv añadiendo el argumento `--env-file=`. 2. También puede especificarlas individualmente utilizando el argumento `--env=`. -::: + ::: 4. Para configurar las Acciones de GitHub, consulta [this](https://github.com/denoland/deployctl/blob/main/action/README.md). Consulta la [documentación de deployctl](https://docs.deno.com/deploy/manual/deployctl) para más información.