Modifica delle specifiche di build nella console Amplify

Puoi personalizzare le impostazioni di build di un'applicazione modificando le specifiche di build nella console Amplify. Le impostazioni di build vengono applicate a tutti i rami dell'app, ad eccezione dei rami che hanno un amplify.yml file salvato nel repository Git.

Per modificare le impostazioni di build nella console Amplify

1. Accedi a AWS Management Console e apri la console Amplify.

2. Scegli l'app per cui desideri modificare le impostazioni di build.

3. Nel pannello di navigazione, scegli Hosting, quindi scegli Crea impostazioni.

4. Nella pagina delle impostazioni di compilazione, nella sezione Specifiche di build dell'app, scegli Modifica.

5. Nella finestra Modifica le specifiche di build, inserisci gli aggiornamenti.

6. Seleziona Salva.

Puoi utilizzare gli esempi descritti nei seguenti argomenti per aggiornare le impostazioni di build per scenari specifici.

Impostazione delle impostazioni di build specifiche del ramo con script

Puoi utilizzare lo scripting della shell Bash per specificare le impostazioni di compilazione specifiche per il ramo. Ad esempio, lo script seguente utilizza la variabile di ambiente di sistema $ AWS_BRANCH per eseguire un set di comandi se il nome del ramo è main e un set diverso di comandi se il nome del ramo è dev.

frontend:
  phases:
    build:
      commands:
        - if [ "${AWS_BRANCH}" = "main" ]; then echo "main branch"; fi
        - if [ "${AWS_BRANCH}" = "dev" ]; then echo "dev branch"; fi

Impostazione di un comando per accedere a una sottocartella

Per monorepos, gli utenti vogliono poter cd accedere a una cartella per eseguire la build. Dopo aver eseguito il cd comando, questo si applica a tutte le fasi della build, quindi non è necessario ripetere il comando in fasi separate.

version: 1
env:
  variables:
    key: value
frontend:
  phases:
    preBuild:
      commands:
        - cd react-app
        - npm ci
    build:
      commands:
        - npm run build

Implementazione del backend con il front-end per un'app di prima generazione

Nota

Questa sezione si applica solo alle applicazioni Amplify Gen 1. Un backend di prima generazione viene creato utilizzando Amplify Studio e l'interfaccia a riga di comando Amplify (). CLI

Il amplifyPush comando è uno script di supporto che ti aiuta con le implementazioni di backend. Le impostazioni di compilazione riportate di seguito determinano automaticamente l'ambiente back-end corretto da distribuire per il ramo corrente.

version: 1
env:
  variables:
    key: value
backend:
  phases:
    build:
      commands:
        - amplifyPush --simple

Impostazione della cartella di output

Le seguenti impostazioni di compilazione impostano la directory di output per la cartella pubblica.

frontend:
  phases:
    commands:
      build:
        - yarn run build
  artifacts:
    baseDirectory: public

Installazione di pacchetti come parte di una build

È possibile utilizzare i yarn comandi npm o per installare i pacchetti durante la compilazione.

frontend:
  phases:
    build:
      commands:
        - npm install -g <package>
        - <package> deploy
        - yarn run build
  artifacts:
    baseDirectory: public

Utilizzo di un registro npm privato

Si possono aggiungere riferimenti a un registro privato nelle impostazioni di compilazione oppure come variabile d'ambiente.

build:
  phases:
    preBuild:
      commands:
        - npm config set <key> <value>
        - npm config set registry https://registry.npmjs.org
        - npm config set always-auth true
        - npm config set email [e-mail]
        - yarn install

Installazione di pacchetti del sistema operativo

L'immagine AL2 023 di Amplify esegue il codice con un utente non privilegiato denominato. amplify Amplify concede a questo utente i privilegi per eseguire i comandi del sistema operativo utilizzando il comando Linux. sudo Se desideri installare pacchetti del sistema operativo per le dipendenze mancanti, puoi usare comandi come e with. yum rpm sudo

La sezione build di esempio seguente mostra la sintassi per l'installazione di un pacchetto del sistema operativo utilizzando il comando. sudo

build:
  phases:
    preBuild:
      commands:
        - sudo yum install -y <package>

Impostazione dell'archiviazione chiave-valore per ogni build

envCacheFornisce l'archiviazione dei valori chiave in fase di compilazione. I valori memorizzati in envCache possono essere modificati solo durante una build e possono essere riutilizzati nella build successiva. UtilizzandoenvCache, possiamo archiviare informazioni sull'ambiente distribuito e renderle disponibili al contenitore di build nelle build successive. A differenza dei valori memorizzati inenvCache, le modifiche alle variabili di ambiente durante una build non vengono mantenute nelle build future.

Esempio di utilizzo:

envCache --set <key> <value>
envCache --get <key>

Saltare la build per un commit

Per saltare una compilazione automatica su un particolare commit, includi il testo [skip-cd] alla fine del messaggio di commit.

Disattivazione delle build automatiche su ogni commit

Puoi configurare Amplify per disattivare le build automatiche su ogni commit di codice. Per effettuare la configurazione, scegli Impostazioni app, Impostazioni Branch, quindi individua la sezione Branches che elenca i rami collegati. Seleziona un ramo, quindi scegli Azioni, Disabilita la creazione automatica. I nuovi commit verso quel ramo non daranno più inizio a una nuova build.

Configurazione della compilazione e della distribuzione del frontend basato su diff

Puoi configurare Amplify per utilizzare build di frontend basate su diff. Se abilitato, all'inizio di ogni build Amplify tenta di eseguire un diff sulla appRoot tua cartella o /src/ sulla cartella per impostazione predefinita. Se Amplify non rileva alcuna differenza, salta i passaggi di compilazione, test (se configurato) e distribuzione del frontend e non aggiorna l'app ospitata.

Per configurare un frontend basato su diff, compila e distribuisci

1. Accedi a AWS Management Console e apri la console Amplify.

2. Scegli l'app per cui configurare la build e la distribuzione del frontend basato su diff.

3. Nel pannello di navigazione, scegli Hosting, Variabili di ambiente.

4. Nella sezione Variabili di ambiente, scegli Gestisci variabili.

5. La procedura per configurare la variabile di ambiente varia a seconda che stiate abilitando o disabilitando la creazione e la distribuzione del frontend basato su diff.

   • Per abilitare la creazione e la distribuzione di frontend basati su differenze

     1. Nella sezione Gestisci variabili, sotto Variabile, inserisci. AMPLIFY_DIFF_DEPLOY

     2. In Valore, specifica true.

   • Per disabilitare la creazione e la distribuzione del frontend basato su diff

     1. Esegui una di queste operazioni:

        • Nella sezione Gestisci le variabili, individua. AMPLIFY_DIFF_DEPLOY In Valore, specifica false.

        • Rimuovi la variabile di AMPLIFY_DIFF_DEPLOY ambiente.

6. Seleziona Salva.

Facoltativamente, puoi impostare la variabile di AMPLIFY_DIFF_DEPLOY_ROOT ambiente in modo che sovrascriva il percorso predefinito con un percorso relativo alla radice del repository, ad esempio. dist

Configurazione di build di backend basate su diff per un'app di prima generazione

Nota

Questa sezione si applica solo alle applicazioni Amplify Gen 1. Un backend di prima generazione viene creato utilizzando Amplify Studio e l'interfaccia a riga di comando Amplify (). CLI

Puoi configurare Amplify Hosting per utilizzare build di backend basate su diff utilizzando la variabile di ambiente. AMPLIFY_DIFF_BACKEND Quando abiliti le build di backend basate su diff, all'inizio di ogni build Amplify tenta di eseguire un diff nella cartella del tuo repository. amplify Se Amplify non rileva alcuna differenza, salta la fase di creazione del backend e non aggiorna le risorse del backend. Se il progetto non ha una amplify cartella nel repository, Amplify ignora il valore della variabile di ambiente. AMPLIFY_DIFF_BACKEND

Se al momento hai dei comandi personalizzati specificati nelle impostazioni di compilazione della fase di backend, le build condizionali di backend non funzioneranno. Se desideri che questi comandi personalizzati vengano eseguiti, devi spostarli nella fase di frontend delle impostazioni di build nel file dell'app. amplify.yml

Per configurare build di backend basate su diff

1. Accedi a AWS Management Console e apri la console Amplify.

2. Scegli l'app per cui configurare le build di backend basate su diff.

3. Nel pannello di navigazione, scegli Hosting, Variabili di ambiente.

4. Nella sezione Variabili di ambiente, scegli Gestisci variabili.

5. La procedura per configurare la variabile di ambiente varia a seconda che si stiano abilitando o disabilitando le build di backend basate su diff.

   • Per abilitare le build di backend basate su diff

     1. Nella sezione Gestisci variabili, sotto Variabile, inserisci. AMPLIFY_DIFF_BACKEND

     2. In Valore, specifica true.

   • Per disabilitare le build di backend basate su diff

     1. Esegui una di queste operazioni:

        • Nella sezione Gestisci le variabili, individua. AMPLIFY_DIFF_BACKEND In Valore, specifica false.

        • Rimuovi la variabile di AMPLIFY_DIFF_BACKEND ambiente.

6. Seleziona Salva.