# General Translation Integrations: Развёртывание в Databricks
URL: https://generaltranslation.com/ru/docs/integrations/databricks/guides/deploying.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Как развернуть переведённое приложение Databricks App вместе с переводами и ключом API General Translation, который хранится в секрете Databricks.

Развёрнутому приложению нужны от General Translation две вещи: переводы интерфейса, которые поставляются вместе с исходным кодом, и ключ API для перевода данных во время выполнения — его Databricks берёт из секрета.

## Перед началом работы [#before-start]

Пройдите [Быстрый старт](/docs/integrations/databricks/quickstart), затем установите [Databricks CLI](https://docs.databricks.com/aws/en/dev-tools/cli/) и войдите в своё рабочее пространство.

## Доставка переводов интерфейса [#translations]

Запускайте [`npx gt translate`](/docs/cli/reference/commands/translate) перед каждым развёртыванием и коммитьте файлы, которые команда создаёт в `client/src/_gt/`. Databricks собирает приложение из исходного кода, поэтому переводы, которых нет в дереве исходников, не попадут в приложение.

Если вы хотите выполнять перевод в CI, запускайте там [`npx gt translate`](/docs/cli/reference/commands/translate) перед развёртыванием, используя `GT_API_KEY` из хранилища секретов CI (см. [учётные данные CLI](/docs/cli/guides/configuring#credentials)).

## Сохраните ключ API как секрет [#api-key]

Сервер считывает `GT_PROJECT_ID` и `GT_API_KEY`. Идентификатор проекта не является секретным, а вот ключ — да, поэтому храните его в секрете Databricks:

1. Создайте ключ и передайте его в секрет через конвейер. Значение ключа не выводится в терминал:

   ```bash
   npx gt api-key create --project-id <project-id> --name 'Databricks app' --permission project:translations:generate \
     | databricks secrets put-secret gt api-key
   ```

   Если области `gt` ещё нет, сначала создайте её командой `databricks secrets create-scope gt`.

2. Привяжите секрет к приложению в `databricks.yml`:

   ```yaml title="databricks.yml"
   resources:
     apps:
       app:
         resources:
           - name: gt-api-key
             secret:
               scope: gt
               key: api-key
               permission: READ
   ```

3. Задайте обе переменные в `app.yaml`. В `valueFrom` указывается имя ресурса из предыдущего шага:

   ```yaml title="app.yaml"
   env:
     - name: GT_PROJECT_ID
       value: <project-id>
     - name: GT_API_KEY
       valueFrom: gt-api-key
   ```

4. Разверните приложение. При запуске приложения Databricks подставляет значение секрета в `GT_API_KEY`.

<Callout type="warn">
  **Внимание:** Никогда не указывайте сам ключ в `app.yaml`, `databricks.yml` или клиентском коде. Всё содержимое `client/` попадает в браузер.
</Callout>

## Проверьте развёрнутое приложение [#check]

Откройте приложение, выберите язык и убедитесь, что переключаются и интерфейс, и данные. Если интерфейс переключается, а данные остаются на языке-источнике, значит, на сервере не заданы `GT_PROJECT_ID` или `GT_API_KEY`: в рабочей среде [`tx`](/docs/node/reference/functions/tx) записывает ошибку в лог и возвращает исходный текст, так что приложение продолжает работать.

## Next steps

- /docs/integrations/databricks/guides/translating-data

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
