Installazione rapida on-premise
Le istruzioni presenti in questa pagina descrivono come installare Adobe Commerce su un’infrastruttura con hosting autonomo. Per informazioni sull'aggiornamento di un'installazione esistente, vedere la Guida all'aggiornamento.
Adobe utilizza Compositore per gestire i componenti Adobe Commerce e le relative dipendenze. L’utilizzo di Composer per ottenere il metapackage di Adobe Commerce offre i seguenti vantaggi:
- Riutilizzare le librerie di terze parti senza unirle al codice sorgente
- Ridurre i conflitti di estensione e i problemi di compatibilità utilizzando un’architettura basata su componenti con una solida gestione delle dipendenze
- Rispetta gli standard PHP-Framework Interoperability Group (FIG)
- Magento Open Source di riconfezionamento con altri componenti
- Utilizzare il software Adobe Commerce in un ambiente di produzione
Prerequisiti
Prima di continuare, è necessario effettuare le seguenti operazioni:
- Completa tutte le attività preliminari.
- Installa Compositore.
- Ottieni chiavi di autenticazione nell'archivio del Compositore Adobe Commerce.
Accedi come proprietario del file system
Per informazioni su proprietà, autorizzazioni e proprietario del file system, vedere l'argomento Panoramica sulla proprietà e sulle autorizzazioni.
Per passare al proprietario del file system:
-
Accedere al server applicazioni come utente con autorizzazioni di scrittura nel file system o passare a tale utente.
Se si utilizza la shell bash, è possibile utilizzare la sintassi seguente per passare al proprietario del file system e immettere contemporaneamente il comando:
code language-bash su <file system owner> -s /bin/bash -c <command>
Se il proprietario del file system non consente l'accesso, è possibile effettuare le seguenti operazioni:
code language-bash sudo -u <file system owner> <command>
-
Per eseguire i comandi CLI da qualsiasi directory, aggiungere
<app_root>/bin
al sistemaPATH
.Poiché le shell hanno sintassi diverse, consultare un riferimento come unix.stackexchange.com.
Shell di base di esempio per CentOS:
code language-bash export PATH=$PATH:/var/www/html/magento2/bin
Facoltativamente, è possibile eseguire i comandi nei modi seguenti:
cd <app_root>/bin
ed eseguirli come./magento <command name>
app_root>/bin/magento <command name>
<app_root>
è una sottodirectory della directory dei documenti del server Web
Ottieni il metapacchetto
Per ottenere il metapacchetto Adobe Commerce:
-
Accedi al server applicazioni come proprietario del file system o passa a tale proprietario.
-
Passare alla directory principale dei documenti del server Web o a una directory configurata come directory principale dei documenti host virtuale.
-
Creare un progetto Compositore utilizzando un metapacchetto Commerce.
Magento Open Source
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>
Adobe Commerce
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>
Quando richiesto, immettere le chiavi di autenticazione. Le chiavi pubbliche e private vengono create e configurate da Commerce Marketplace - Chiavi di accesso. Per
username
, copia e incolla il valore della chiave pubblica. Perpassword
, copia e incolla il valore della chiave privata.note note NOTE Se si utilizza un file Composer [auth.json](https://experienceleague.adobe.com/it/docs/commerce-cloud-service/user-guide/develop/authentication-keys)
o una variabile di ambiente configurata con le chiavi di autenticazione di Commerce, non viene richiesto di immettere le chiavi di autenticazione.Se si verificano errori, ad esempio
Could not find package...
o...no matching package found
, verificare che il comando non contenga errori di battitura. Se riscontri ancora errori, potresti non essere autorizzato a scaricare Adobe Commerce. Contatta il Supporto Adobe Commerce per assistenza.Per ulteriori informazioni sugli errori, vedere Risoluzione dei problemi.
Esempio: versione secondaria
Le versioni secondarie contengono nuove funzioni, correzioni di qualità e correzioni di sicurezza. Utilizza Composer per specificare una versione secondaria. Ad esempio, per specificare il metapackage di Adobe Commerce 2.4.6:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Esempio: patch di qualità
Le patch di qualità contengono principalmente e correzioni di sicurezza funzionali. Tuttavia, a volte possono anche contenere nuove funzioni compatibili con le versioni precedenti. Utilizza Composer per scaricare una patch di qualità. Ad esempio, per specificare il metapackage di Adobe Commerce 2.4.6:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Esempio: patch di sicurezza
Le patch di sicurezza contengono solo correzioni di sicurezza. Sono progettati per rendere il processo di aggiornamento più rapido e semplice.
Le patch di sicurezza utilizzano la convenzione di denominazione del Compositore 2.4.6-px
. Utilizzate Composer per specificare una patch. Ad esempio, per scaricare il metapacchetto Adobe Commerce 2.4.6-p1:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>
Imposta autorizzazioni file
Prima di installare Adobe Commerce, è necessario impostare le autorizzazioni di lettura e scrittura per il gruppo di server Web. Ciò è necessario affinché la riga di comando possa scrivere file nel file system.
cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento
Installare l’applicazione
Per installare Adobe Commerce è necessario utilizzare la riga di comando.
In questo esempio si presuppone che la directory di installazione sia denominata magento2ee
, che db-host
si trovi nello stesso computer (localhost
) e che db-name
, db-user
e db-password
siano tutti magento
:
bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15
--backend-frontname
. Tuttavia, Adobe consiglia di omettere questa opzione e consentire al comando di installazione di generare automaticamente un URI casuale. Un URI casuale è più difficile da sfruttare per gli hacker o per il software dannoso. Al termine dell’installazione, l’URI viene visualizzato nella console.Riepilogo comandi
Per visualizzare un elenco completo dei comandi, immettere:
bin/magento list
Per ottenere informazioni su un comando specifico, immettere:
bin/magento help <command>
Ad esempio:
bin/magento help setup:install
bin/magento help cache:enable
Nella tabella seguente vengono riepilogati i comandi disponibili. I comandi vengono visualizzati solo in forma di riepilogo. Per ulteriori informazioni su un comando, fare clic sul collegamento nella colonna Comando.
magento setup:install
magento setup:uninstall
magento setup:upgrade
magento maintenance:{enable/disable}
magento setup:config:set
magento module:{enable/disable}
magento setup:store-config:set
magento setup:db-schema:upgrade
magento setup:db-data:upgrade
magento setup:db:status
magento admin:user:create
Configurazione della distribuzione
Abilitare almeno i moduli
Magento_User
e Magento_Authorization
Database (il modo più semplice è utilizzare
bin/magento setup:upgrade
)magento list
magento help
Argomenti comuni
I seguenti argomenti sono comuni a tutti i comandi. Questi comandi possono essere eseguiti prima o dopo l'installazione dell'applicazione:
--help
-h
./magento help setup:install
o ./magento help setup:config:set
.--quiet
-q
--no-interaction
-n
--verbose=1,2,3
-v, -vv, -vvv
--verbose=3
o -vvv
, ad esempio, visualizza il livello di dettaglio del debug, ovvero l'output più dettagliato. Il valore predefinito è --verbose=1
o -v
.--version
-V
--ansi
--no-ansi