DocumentazioneCommerceGuida alla configurazione

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Configurazione del sistema di build

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

Puoi avere un sistema di build che soddisfa i seguenti requisiti:

  • Tutto il codice Commerce è controllato dal codice sorgente nello stesso archivio dei sistemi di sviluppo e produzione

  • Assicurarsi che tutti i seguenti elementi siano inclusi nel controllo del codice sorgente:

    • app/etc/config.php
    • Directory generated (e sottodirectory)
    • Directory pub/media
    • Directory pub/media/wysiwyg (e sottodirectory)
    • Directory pub/static (e sottodirectory)

  • Deve essere installata una versione PHP compatibile

  • Deve avere Compositore installato

  • Ha la proprietà del file system e le autorizzazioni impostate come descritto in Prerequisiti per i sistemi di sviluppo, compilazione e produzione.

  • Il sistema di build non ha bisogno di Commerce per essere installato, ma il codice deve essere disponibile.

WARNING
La connessione al database non è necessaria se è già contenuta in config.php. Vedere Esportare la configurazione. In caso contrario, è necessaria la connessione al database.
INFO
Il computer di compilazione può trovarsi sul proprio host o sullo stesso host di un sistema Commerce installato.

Configurare il computer di compilazione

Nelle sezioni seguenti viene illustrato come configurare il computer di compilazione.

Installa Compositore

Innanzitutto, verifica se Composer è già installato:

Al prompt dei comandi immettere uno dei comandi seguenti:

  • composer --help
  • composer list --help

Se viene visualizzata la Guida del comando, Composer è già installato.

Se viene visualizzato un errore, attieniti alla procedura seguente per installare Composer.

Per installare Composer:

  1. Cambia in o crea una directory vuota sul server Commerce.

  2. Immettete i seguenti comandi:

    code language-bash 
    curl -sS https://getcomposer.org/installer | php
    code language-bash 
    mv composer.phar /usr/local/bin/composer

Per ulteriori opzioni di installazione, vedere la documentazione sull'installazione del Compositore.

Installare PHP

Installa PHP in CentOS o Ubuntu.

Configurare il sistema di build

Per impostare il sistema di build:

  1. Accedi al sistema di build come proprietario del file system o passa a tale proprietario.

  2. Recupera il codice Commerce dal controllo del codice sorgente.

    Se utilizzi Git, utilizza il seguente comando:

    code language-bash 
    git clone [-b <branch name>] <repository URL>

  3. Passa alla directory principale di Commerce e immetti:

    code language-bash 
    composer install

  4. Attendere l'aggiornamento delle dipendenze.

  5. Imposta proprietà:

    code language-bash 
    chown -R <Commerce file system owner name>:<web server username> .

    Ad esempio:

    code language-bash 
    chown -R commerce-username:apache .

  6. Se si utilizza Git, aprire .gitignore in un editor di testo.

  7. Iniziare ciascuna delle righe seguenti con un carattere # per aggiungerle come commento:

    code language-conf 
    # app/etc/config.php
# pub/media/*
# generated/*
# pub/media/*.*
# pub/media/wysiwyg/*
# pub/static/*

  8. Salvare le modifiche apportate a .gitignore e uscire dall'editor di testo.

  9. Se utilizzi Git, utilizza i seguenti comandi per confermare la modifica:

    code language-bash 
    git add .gitignore && git commit -m "Modify .gitignore for build and production"

    Per ulteriori informazioni, vedere il riferimento .gitignore.

  10. Il sistema di compilazione deve utilizzare modalità predefinita o modalità sviluppatore:

    code language-bash 
    bin/magento deploy:mode:set <mode>

    <mode> è obbligatorio. Può essere default o developer.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c