Fix Terraform instructuion (#8693)

Co-authored-by: Ivan Blinkov <ivan@ydb.tech>

Author: Pseudolukian

ydb/docs/en/core/devops/ansible/_includes/terraform/aws.md

@@ -1,4 +1,4 @@
-Create an [account](https://console.aws.amazon.com) in AWS and add enough balance to run 9 VMs. Using the [calculator] (https://calculator.aws/#/createCalculator/ec2-enhancement), you can estimate the approximate cost of maintaining infrastructure depending on the region and other circumstances.
+Create an [account](https://console.aws.amazon.com) in AWS and add enough balance to run 9 VMs. Using the [calculator](https://calculator.aws/#/createCalculator/ec2-enhancement), you can estimate the approximate cost of maintaining infrastructure depending on the region and other circumstances.
 
 Create a user and connection key in AWS Cloud to run the AWS CLI:
 

ydb/docs/en/core/devops/ansible/_includes/terraform/azure.md

@@ -1,7 +1,7 @@
 Create an [account](https://portal.azure.com/#home) in Azure and top up your [account](https://portal.azure.com/#view/Microsoft_Azure_GTM/ModernBillingMenuBlade/~/BillingAccounts) account with the amount, sufficient to operate 9 VMs. You can estimate the approximate cost of maintaining infrastructure depending on the region and other circumstances using [calculator](https://azure.com/e/26977c150e854617a888fb3a7d1a399d).
 
 Authentication to the Azure Provider for Terraform goes through the CLI:
-1. You can download, install, and configure the Azure CLI by following [these instructions](https://learn.microsoft.com/ru-ru/cli/azure/install-azure-cli).
+1. You can download, install, and configure the Azure CLI by following [these instructions]({{ azure_docs }}/cli/azure/install-azure-cli).
 2. Log in using the Azure CLI interactively with the `az login` command.
 3. The easiest way to create a pair of SSH keys (Linux, macOS) is to use the `ssh-keygen` command.
 

ydb/docs/en/core/devops/ansible/_includes/terraform/yc.md

@@ -1,49 +1,32 @@
 To create infrastructure in Yandex Cloud using Terraform, you need:
 
 1. Prepare the cloud for work:
-     * [Register](https://console.cloud.yandex.ru/) in Yandex Cloud.
-     * [Connect](https://cloud.yandex.com/ru/docs/billing/concepts/billing-account) payment account.
-     * [Make sure](https://console.cloud.yandex.ru/billing) that there are enough funds to create nine VMs.
-2. Install and configure Yandex Cloud CLI:
-     * [Download](https://cloud.yandex.ru/ru/docs/cli/quickstart) Yandex Cloud CLI.
-     * [Create](https://cloud.yandex.ru/ru/docs/cli/quickstart#initialize) profile
-3. [Create](https://cloud.yandex.com/ru/docs/tutorials/infrastructure-management/terraform-quickstart#get-credentials) service account using the CLI.
-4. [Generate](https://cloud.yandex.ru/ru/docs/cli/operations/authentication/service-account#auth-as-sa) SA key in JSON format for connecting Terraform to the cloud using the CLI: `yc iam key create --service-account-name <acc name> --output <file name> --folder-id <cloud folder id>`. An SA key will be generated, and secret information will be output to the terminal:
+     * [Register](https://console.yandex.cloud) in Yandex Cloud.
+     * [Connect]({{ yandex_docs }}/billing/concepts/billing-account) payment account.
+     * [Make sure](https://billing.yandex.cloud) that there are enough funds to create nine VMs.
+1. Install and configure Yandex Cloud CLI:
+     * [Download]({{ yandex_docs }}/cli/quickstart) Yandex Cloud CLI.
+     * [Create]({{ yandex_docs }}/cli/quickstart#initialize) profile
+1. [Create]({{ yandex_docs }}/tutorials/infrastructure-management/terraform-quickstart#get-credentials) service account using the CLI.
+1. [Generate]({{ yandex_docs }}/cli/operations/authentication/service-account#auth-as-sa) Authorized key in JSON format for connecting Terraform to the cloud using the CLI: `yc iam key create --service-account-name <acc name> --output <file name> --folder-id <cloud folder id>`. Information about the created key will be displayed in the terminal:
      ```
-     access_key:
-         id: ajenhnhaqgd3vp...
-         service_account_id: aje90em65r6922...
-         created_at: "2024-03-05T20:10:50.0150..."
-         key_id: YCAJElaLsa0z3snzH4E...
-     secret: YCPKNJDVhRZgyywl4hQwVdcSRC...
-     ```
-     Copy `access_key.id` and `secret`. The values of these fields will be needed later when working with AWS CLI.
-5. [Download](https://aws.amazon.com/ru/cli/) AWS CLI.
-6. Set up the AWS CLI environment:
-     * Run the `aws configure` command and sequentially enter the previously saved `access_key.id` and `secret`. For the region value, use `ru-central1`:
-     ```
-     aws configure
-     AWS Access Key ID [None]: AKIAIOSFODNN********
-     AWS Secret Access Key [None]: wJalr********/*******/bPxRfiCYEX********
-     Default region name [None]: ru-central1
-     Default output format [None]:
-     ```
-     The files `~/.aws/credentials` and `~/.aws/config` will be created.
-7. Edit `~/.aws/credentials` and `~/.aws/config` as follows:
-     * Add `[Ya_def_reg]` to `~/.aws/config` before `region = ru-central1-a`.
-     * Add `[Yandex]` before the secret information about connection keys.
-8. [Configure](https://cloud.yandex.com/ru/docs/tutorials/infrastructure-management/terraform-quickstart#configure-provider) Yandex Cloud Terraform provider.
-9. Download this repository with the command `git clone https://github.com/ydb-platform/ydb-terraform.git`.
-10. Go to the `yandex_cloud` directory in the downloaded repository and make changes to the following variables in the `variables.tf` file:
+    id: ajenap572v8e1l...
+    service_account_id: aje90em65r69...
+    created_at: "2024-09-03T15:34:57.495126296Z"
+    key_algorithm: RSA_2048
+    ```
+    The authorized key will be created in the directory where the command was executed.
+1. [Configure]({{ yandex_docs }}/tutorials/infrastructure-management/terraform-quickstart#configure-provider) Yandex Cloud Terraform provider.
+1. Download this repository with the command `git clone https://github.com/ydb-platform/ydb-terraform.git`.
+1. Go to the `yandex_cloud` directory in the downloaded repository and make changes to the following variables in the `variables.tf` file:
      * `key_path` – path to the SA key generated using the CLI.
      * `cloud_id` – cloud ID. You can get a list of available clouds with the command `yc resource-manager cloud list`.
-     * `profile` – profile name from the file `~/.aws/config`.
      * `folder_id` – Cloud folder ID. Can be obtained with the command `yc resource-manager folder list`.
 
 Now, being in the `yandex_cloud` subdirectory, you can run the following sequence of commands to install the provider, initialize modules, and create the infrastructure:
 
 1. `terraform init` – installing the provider and initializing modules.
-2. `terraform plan` – creating a plan for future infrastructure.
-3. `terraform init` – create resources in the cloud.
+1. `terraform plan` – creating a plan for future infrastructure.
+1. `terraform init` – create resources in the cloud.
 
-Next, use the commands `terraform plan`, `terraform init`, and `terraform destroy` (destruction of the created infrastructure) to apply further changes as necessary.
+Next, use the commands `terraform plan`, `terraform init`, and `terraform destroy` (destruction of the created infrastructure) to apply further changes as necessary.

ydb/docs/en/presets.yaml

@@ -1,6 +1,8 @@
 default:
   lang: en
   pub-cover-size: 700x400
+  yandex_docs: https://yandex.cloud/en/docs
+  azure_docs: https://learn.microsoft.com/en-us
   team:
       blinkov:
         name: Ivan Blinkov

ydb/docs/ru/core/devops/ansible/_includes/terraform/azure.md

@@ -2,7 +2,7 @@
 
 Аутентификация в провайдере Azure для Terraform осуществляется через CLI:
 
-1. Скачать, установить и настроить Azure CLI можно, следуя [этой](https://learn.microsoft.com/ru-ru/cli/azure/install-azure-cli) инструкции.
+1. Скачать, установить и настроить Azure CLI можно, следуя [этой]({{ azure_docs }}/cli/azure/install-azure-cli) инструкции.
 2. Авторизоваться в Azure с помощью Azure CLI можно в интерактивном режиме командой `az login`, а для создания пары SSH-ключей (Linux, macOS) проще всего будет воспользоваться командой `ssh-keygen`.
 
 После авторизации в Azure и генерации SSH-ключей нужно изменить дефолтное значение следующих переменных в корневом файле `variables.tf`:

ydb/docs/ru/core/devops/ansible/_includes/terraform/yc.md

@@ -1,55 +1,38 @@
 Для создания инфраструктуры в Yandex Cloud с помощью Terraform нужно:
 
 1. Подготовить облако к работе:
-    * [Зарегистрироваться](https://console.cloud.yandex.ru/) в Yandex Cloud.
-    * [Подключить](https://cloud.yandex.com/ru/docs/billing/concepts/billing-account) платежный аккаунт.
-    * [Убедится](https://console.cloud.yandex.ru/billing) в наличии достаточного количества средств для создания девяти ВМ.
-2. Установить и настроить Yandex Cloud CLI:
-    * [Скачать](https://cloud.yandex.ru/ru/docs/cli/quickstart) Yandex Cloud CLI.
-    * [Создать](https://cloud.yandex.ru/ru/docs/cli/quickstart#initialize) профиль
-3. [Создать](https://cloud.yandex.com/ru/docs/tutorials/infrastructure-management/terraform-quickstart#get-credentials) сервисный аккаунт с помощью CLI.
-4. [Сгенерировать](https://cloud.yandex.ru/ru/docs/cli/operations/authentication/service-account#auth-as-sa) SA ключ в JSON формате для подключения Terraform к облаку с помощью CLI: `yc iam key create --service-account-name <acc name> --output <file name> --folder-id <cloud folder id>`. Будет сгенерирован SA ключ, а в терминал будет выведена секретная информация:
+    * [Зарегистрироваться](https://console.yandex.cloud) в Yandex Cloud.
+    * [Подключить]({{ yandex_docs }}/billing/concepts/billing-account) платежный аккаунт.
+    * [Убедится](https://billing.yandex.cloud/) в наличии достаточного количества средств для создания девяти ВМ.
+1. Установить и настроить Yandex Cloud CLI:
+    * [Скачать]({{ yandex_docs }}/cli/quickstart) Yandex Cloud CLI.
+    * [Создать]({{ yandex_docs }}/cli/quickstart#initialize) профиль
+1. [Создать]({{ yandex_docs }}/tutorials/infrastructure-management/terraform-quickstart#get-credentials) сервисный аккаунт с помощью CLI.
+1. [Сгенерировать]({{ yandex_docs }}/cli/operations/authentication/service-account#auth-as-sa) авторизованный ключ в JSON формате для подключения Terraform к облаку с помощью CLI: `yc iam key create --service-account-name <acc name> --output <file name> --folder-id <cloud folder id>`. В терминал будет выведена информация о созданном ключе:
     ```
-    access_key:
-        id: ajenhnhaqgd3vp...
-        service_account_id: aje90em65r6922...
-        created_at: "2024-03-05T20:10:50.0150..."
-        key_id: YCAJElaLsa0z3snzH4E...
-    secret: YCPKNJDVhRZgyywl4hQwVdcSRC...
+    id: ajenap572v8e1l...
+    service_account_id: aje90em65r69...
+    created_at: "2024-09-03T15:34:57.495126296Z"
+    key_algorithm: RSA_2048
     ```
-    Скопируйте `access_key.id` и `secret`. Значения этих полей нужны будут в дальнейшем при работе с AWS CLI.
-5. [Скачать](https://aws.amazon.com/ru/cli/) AWS CLI.
-6. Настроить окружение AWS CLI:
-    * Запустите команду `aws configure` и последовательно введите сохраненные ранее `access_key.id` и `secret`. Для значения региона используйте `ru-central1`:
-    ```
-    aws configure
-    AWS Access Key ID [None]: AKIAIOSFODNN********
-    AWS Secret Access Key [None]: wJalr********/*******/bPxRfiCYEX********
-    Default region name [None]: ru-central1
-    Default output format [None]:
-    ```
-    Будут созданы файлы `~/.aws/credentials` и `~/.aws/config`.
-7. Отредактировать `~/.aws/credentials` и `~/.aws/config` следующим образом:
-    * Добавьте `[Ya_def_reg]` в `~/.aws/config` перед `region = ru-central1-a`.
-    * Добавьте `[Yandex]` перед секретной информацией о ключах подключения.
-8. [Настроить](https://cloud.yandex.com/ru/docs/tutorials/infrastructure-management/terraform-quickstart#configure-provider) Yandex Cloud Terraform провайдера.
-9. Скачать данный репозиторий командой `git clone https://github.com/ydb-platform/ydb-terraform.git`.
-10. Перейти в директорию `yandex_cloud` (директория в скаченном репозитории) и внести изменения в следующие переменные, в файле `variables.tf`:
-    * `key_path` – путь к сгенерированному SA ключу с помощью CLI.
+    Авторизованный ключ будет создан в директории, где вызывалась команда.
+1. [Настроить]({{ yandex_docs }}/tutorials/infrastructure-management/terraform-quickstart#configure-provider) Yandex Cloud Terraform провайдера.
+1. Скачать данный репозиторий командой `git clone https://github.com/ydb-platform/ydb-terraform.git`.
+1. Перейти в директорию `yandex_cloud` (директория в скаченном репозитории) и внести изменения в следующие переменные, в файле `variables.tf`:
+    * `key_path` – путь к сгенерированному авторизованному ключу с помощью CLI.
     * `cloud_id` – ID облака. Можно получить список доступных облаков командой `yc resource-manager cloud list`.
-    * `profile` – название профиля из файла `~/.aws/config`.
     * `folder_id` – ID Cloud folder. Можно получить командой `yc resource-manager folder list`.
 
 Теперь, находясь в поддиректории `yandex_cloud`, можно выполнить последовательность следующих команд для установки провайдера, инициализации модулей и создания инфраструктуры:
 
 1. `terraform init` – установка провайдера и инициализация модулей.
-2. `terraform plan` – создание плана будущей инфраструктуры.
-3. `terraform apply` (повторное выполнение) – создание ресурсов в облаке.
+1. `terraform plan` – создание плана будущей инфраструктуры.
+1. `terraform apply` (повторное выполнение) – создание ресурсов в облаке.
 
 Далее используются команды `terraform plan`, `terraform apply` и `terraform destroy` (уничтожение созданной инфраструктуры).
 
 {% note info %}
 
-С помощью Yandex Cloud провайдера можно не только создавать инфраструктуру для дальнейшего развертывания на ней {{ ydb-short-name }} кластера с помощью [Ansible](../../initial-deployment.md), но и управлять [serverless или dedicated](https://cloud.yandex.ru/ru/services/ydb) версией {{ ydb-short-name }} прямо из Terraform. О возможностях работы с {{ ydb-short-name }} в Yandex Cloud читайте в разделе [Работа с YDB через Terraform](https://cloud.yandex.ru/ru/docs/ydb/terraform/intro) документации Yandex Cloud.
+С помощью Yandex Cloud провайдера можно не только создавать инфраструктуру для дальнейшего развертывания на ней {{ ydb-short-name }} кластера с помощью [Ansible](../../initial-deployment.md), но и управлять [serverless или dedicated](https://yandex.cloud/ru/services/ydb) версией {{ ydb-short-name }} прямо из Terraform. О возможностях работы с {{ ydb-short-name }} в Yandex Cloud читайте в разделе [Работа с YDB через Terraform]({{ yandex_docs }}/ydb/terraform/intro) документации Yandex Cloud.
 
 {% endnote %}

ydb/docs/ru/presets.yaml

@@ -1,6 +1,8 @@
 default:
   lang: ru
   pub-cover-size: 700x400
+  yandex_docs: https://cloud.yandex/ru/docs
+  azure_docs: https://learn.microsoft.com/ru-ru
   team:
     babich:
       name: Михаил Бабич