Distribuzione in produzione

Distribuiamo la tua app Next.js con GT.

Panoramica

Questo breve tutorial ti aiuta a distribuire la tua app Next.js con GT.

In totale, dovrebbe richiedere meno di 5 minuti.

Lo faremo in 3 passaggi:

Aggiungi le chiavi API di produzione.

Esegui il comando gtx-cli configure per configurare il progetto.

Aggiungi il comando di traduzione allo script di build.

Prerequisiti

Supponiamo che tu abbia già configurato la tua app Next.js con GT. Se non l'hai fatto, configura prima il tuo progetto seguendo la Guida rapida.

Passaggio 1: Aggiungi le chiavi API di produzione 🔑

Per distribuire la tua app in produzione, devi utilizzare una chiave API di produzione.

Dalla dashboard, vai su API Keys nella barra laterale. Fai clic su Create API Key e aggiungila al tuo ambiente di produzione.

GT_API_KEY="LA_TUA_API_KEY_GT"
GT_PROJECT_ID="IL_TUO_PROJECT_ID_GT"

Proteggi le tue chiavi API!

Le chiavi di produzione devono essere utilizzate solo in produzione. Allo stesso modo, le chiavi di sviluppo devono essere utilizzate solo in sviluppo. Non pubblicare mai le tue chiavi API in un repository pubblico!

Passaggio 2: Esegui il comando gtx-cli configure 🔧

Se in precedenza hai eseguito la configurazione guidata, puoi saltare questo passaggio. La configurazione guidata ha già eseguito il comando gtx-cli configure per te.

Esegui il comando gtx-cli configure per configurare il progetto.

npx gtx-cli configure

Se non desideri che le tue traduzioni siano ospitate sul CDN di GT, seleziona “No” quando richiesto. Dovrai anche configurare la funzione loadTranslations.

Passaggio 3: Aggiungi il comando translate allo script di build 🏗️

L’ultimo passaggio è aggiungere il comando translate allo script di build. Assicurati che il comando translate venga eseguito prima del comando di build.

package.json
{
  "scripts": {
    "build": "npx gtx-cli translate && <...IL_TUO_COMANDO_DI BUILD...>"
  }
}

Ecco fatto! Ora, quando distribuisci la tua app in produzione ed esegui npm run build, il progetto verrà tradotto automaticamente e distribuito insieme all’app.


Prossimi passi

  • Consulta la documentazione della CLI per maggiori informazioni sullo strumento CLI.
  • Scopri le diverse opzioni di configurazione dello strumento CLI qui.
  • Leggi in cosa differiscono gli ambienti di produzione e di sviluppo qui.

Come valuti questa guida?

Distribuzione in produzione