DocumentazioneCommerceGuida di Commerce sul cloud

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

Variabili amministratore

Last update: Wed Mar 04 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Gli utenti con accesso amministrativo al progetto Adobe Commerce on Cloud Infrastructure possono utilizzare le seguenti variabili di ambiente del progetto per ignorare le impostazioni di configurazione dell’account utente amministratore per accedere all’interfaccia utente amministratore.

Credenziali amministratore

Durante l’installazione di Commerce, è possibile sovrascrivere le credenziali utente amministratore con le variabili ADMIN riportate nella tabella seguente.

Se si desidera modificare i valori dopo l'installazione, connettersi all'ambiente utilizzando SSH e utilizzare il comando Adobe Commerce CLI admin:user per creare o modificare le credenziali utente amministratore.

Variabile
Predefinito
Descrizione
ADMIN_USERNAME
Indirizzo e-mail proprietario licenza
Un nome utente per l’utente amministratore con la possibilità di creare altri utenti, inclusi gli utenti amministratori.
ADMIN_EMAIL
Indirizzo e-mail dell’utente amministratore. Questo indirizzo viene utilizzato per inviare le notifiche di reimpostazione della password.
ADMIN_PASSWORD
Password per l'utente amministratore. Al momento della creazione del progetto, viene generata una password casuale e viene inviata un’e-mail al Proprietario della licenza. Durante la creazione del progetto, il Proprietario della licenza avrebbe dovuto modificare la password. Contattare il proprietario della licenza per ottenere la password aggiornata.
ADMIN_LOCALE
en_US
Impostazioni locali predefinite utilizzate dall'amministratore.

URL amministratore

Utilizza la seguente variabile di ambiente per proteggere l’accesso all’interfaccia utente di amministrazione. Se specificato, questo valore sostituisce l'URL predefinito durante l'installazione. In Adobe Commerce sull'infrastruttura cloud, è necessario impostare o modificare l'URL amministratore utilizzando la variabile ADMIN_URL in (Cloud Console o Cloud CLI). La modifica dell'impostazione da Admin è applicabile solo alle installazioni locali.

ADMIN_URL: l'URL relativo per accedere all'interfaccia utente di amministrazione. URL predefinito: /admin.

Modificare l’URL dell’amministratore

Per impostazione predefinita, l'URL Commerce Admin è impostato su <nome_dominio>/admin. Per motivi di sicurezza, Adobe consiglia di impostarlo su un URL amministratore univoco e personalizzato, difficilmente intuibile.

In Adobe Commerce nell'infrastruttura cloud, è necessario modificare l'URL amministratore utilizzando la variabile di ambiente ADMIN_URL in (Cloud Console o Cloud CLI). La modifica dell'impostazione da Admin è applicabile solo alle installazioni locali. Per le installazioni locali, segui utilizza un URL amministratore personalizzato.

Dopo l’installazione, Adobe consiglia di modificare la variabile a livello di ambiente per l’URL amministratore. Configurare questa impostazione per motivi di sicurezza prima di creare diramazioni dall'ambiente master clonato. Tutti i rami creati dal ramo master ereditano le variabili a livello di ambiente e i relativi valori, a meno che l'ereditarietà non venga impostata su false.

Utilizzare Cloud Console o Cloud CLI per impostare o aggiornare ADMIN_URL.

Opzione A: modificare l'URL amministratore utilizzando Cloud Console

Ambiente di integrazione

Dalla console cloud, aggiungi una nuova variabile con:

Imposta l'URL amministratore in Cloud Console

  1. Accedi alla console cloud.

  2. Selezionare un progetto dall'elenco All projects.

  3. Nella panoramica del progetto, seleziona l’ambiente e fai clic sull’icona di configurazione.

  4. Selezionare la scheda Variables.

  5. Fare clic su Create Variable (o modificare la variabile ADMIN_URL esistente, se presente).

  6. Immetti quanto segue:

    • Nome variabile: ADMIN_URL
    • Valore: Il nuovo percorso amministratore (ad esempio, magento_A8v10).

    Per impostazione predefinita, sono selezionati Available during runtime e Make inheritable. Per evitare che gli ambienti figlio ereditino questo valore, cancellare Make inheritable per questa variabile.

  7. Fare clic su Create variable (o Save) e attendere il completamento della distribuzione. Il pulsante è visibile solo se i campi obbligatori contengono valori.

Quando Gestione temporanea e Produzione non sono disponibili in Cloud Console

Invia un ticket di supporto richiedendo di aggiungere la variabile ADMIN_URL per l'ambiente di staging o produzione. Se l'ambiente di gestione temporanea e l'ambiente di produzione sono accessibili da Cloud Console, aggiungere la variabile come descritto in Ambiente di integrazione.

Opzione B: modificare l'URL amministratore utilizzando Cloud CLI

Utilizzare il comando magento-cloud variable:update per aggiornare la variabile. Il comando variable:set è obsoleto e non è disponibile.

L'esempio seguente aggiorna l'ambiente master ADMIN_URL in newAdmin_A8v10 e impedisce agli ambienti figlio di ereditare il valore:

magento-cloud variable:update ADMIN_URL --value newAdmin_A8v10 -e master --inheritable false
  • Ridistribuzione: La modifica della variabile ADMIN_URL in Cloud CLI attiva una ridistribuzione dell'ambiente.
  • Ereditarietà: Le variabili sono ereditabili per impostazione predefinita. Per evitare che il valore venga ereditato dagli ambienti figlio, utilizzare l'opzione --inheritable false come illustrato. Per ulteriori dettagli, vedi visibilità livello variabile.
NOTE
Il valore ADMIN_URL accetta lettere (a-z, A-Z), numeri (0-9) e il carattere di sottolineatura (_). Gli spazi o altri caratteri non sono accettati.
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938