# General Translation Integrations: Distribuzione su Databricks
URL: https://generaltranslation.com/it/docs/integrations/databricks/guides/deploying.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Come distribuire una Databricks App tradotta, insieme alle relative traduzioni e a una chiave API di General Translation archiviata come segreto Databricks.

Un&#39;app distribuita richiede due elementi da General Translation: le traduzioni dell&#39;interfaccia, incluse nel codice sorgente, e una chiave API per tradurre i dati a runtime, che Databricks fornisce tramite un segreto.

## Prima di iniziare [#before-start]

Completa l&#39;[Avvio rapido](/docs/integrations/databricks/quickstart) e installa la [CLI di Databricks](https://docs.databricks.com/aws/en/dev-tools/cli/), con l&#39;accesso effettuato al tuo workspace.

## Distribuire le traduzioni dell&#39;interfaccia [#translations]

Esegui [`npx gt translate`](/docs/cli/reference/commands/translate) prima di ogni distribuzione ed esegui il commit dei file che genera in `client/src/_gt/`. Databricks esegue la build della tua app a partire dal codice sorgente, quindi le traduzioni assenti dall&#39;albero dei sorgenti non saranno incluse nell&#39;app.

Se invece preferisci tradurre in CI, esegui lì [`npx gt translate`](/docs/cli/reference/commands/translate) prima della distribuzione, usando una `GT_API_KEY` conservata nell&#39;archivio dei segreti della CI. (Vedi [credenziali della CLI](/docs/cli/guides/configuring#credentials).)

## Archiviare la chiave API come segreto [#api-key]

Il server legge `GT_PROJECT_ID` e `GT_API_KEY`. L&#39;ID progetto non è un dato riservato, mentre la chiave sì: conservala quindi in un segreto Databricks.

1. Crea la chiave e passala tramite pipe a un segreto. Il valore non viene mai mostrato nel terminale:

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

   Se l&#39;ambito `gt` non esiste, crealo prima con `databricks secrets create-scope gt`.

2. Associa il segreto alla tua app in `databricks.yml`:

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

3. Imposta entrambe le variabili in `app.yaml`. `valueFrom` indica il nome della risorsa definita nel passaggio precedente:

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

4. Distribuisci l&#39;app. All&#39;avvio, Databricks risolve il segreto e ne assegna il valore a `GT_API_KEY`.

<Callout type="warn">
  **Attenzione:** non inserire mai la chiave vera e propria in `app.yaml`, `databricks.yml` o nel codice client. Tutto ciò che si trova in `client/` viene inviato al browser.
</Callout>

## Verifica l&#39;app distribuita [#check]

Apri l&#39;app, scegli una lingua e controlla che cambino lingua sia l&#39;interfaccia sia i dati. Se l&#39;interfaccia cambia ma i dati restano nella lingua di origine, sul server manca `GT_PROJECT_ID` o `GT_API_KEY`: in produzione, [`tx`](/docs/node/reference/functions/tx) registra un errore e restituisce il testo di origine, così l&#39;app continua a funzionare.

## Next steps

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

## Sitemap

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