Studio CLI

Cos'è Studio CLI?

Studio CLI è un'utilità da riga di comando globale per interagire con le funzionalità di WordPress Studio dal tuo terminale. È progettata per funzionare anche quando l'app desktop Studio è chiusa e serve a gestire siti locali Studio e ambienti di preview ospitati su WordPress.com.

La CLI può essere installata con Studio (è inclusa) o usata come modulo npm standalone chiamato wp-studio. Il suo scopo principale è consentirti di controllare attività relative a Studio — come creazione, aggiornamento e autenticazione di siti preview — da script e passaggi di build.

Funzionalità Principali

• Comando terminale globale (studio): Esegui azioni relative a Studio da qualsiasi posizione senza dover tenere Studio aperto.
• Sintassi di comando strutturata (studio <area> <command> [options]): Applica pattern prevedibili per workflow di siti e preview.
• Targeting per percorso (--path): Punta i comandi a una directory specifica di un sito Studio invece di affidarti alla directory di lavoro corrente.
• Gestione autenticazione WordPress.com: Usa studio auth login, studio auth logout e studio auth status per collegare le azioni CLI a un account WordPress.com autenticato quando richiesto.
• Operazioni sui siti preview: Crea, elenca, aggiorna ed elimina siti preview temporanei e condivisibili su WordPress.com con comandi come studio preview create, studio preview list, studio preview update e studio preview delete.
• Comandi per gestione siti locali: Gestisci siti locali Studio (stato, crea, elenca, avvia, ferma, elimina e configura) dal terminale usando i comandi studio site ....

Come Usare Studio CLI

1. Abilita Studio CLI nell'app Studio (raccomandato se usi già Studio):

   • Apri l'applicazione “WordPress Studio”.
   • Nel menu principale, apri la modale Settings (o clicca sull'icona dell'ingranaggio).
   • Abilita “Studio CLI” e clicca Save.
   • Su macOS, potresti essere invitato a inserire la password del tuo account per consentire l'installazione.

2. Apri un terminale e verifica la disponibilità:

   • Usa studio --help per visualizzare una panoramica di alto livello.

3. Autentica per attività che richiedono accesso a WordPress.com (es. siti preview):

   • Esegui studio auth login.
   • Il comando apre un flusso basato su browser; riceverai un token di autenticazione da incollare nel terminale.
   • Conferma con studio auth status.

4. Crea e condividi un sito preview dal tuo sito locale Studio:

   • Dalla root del tuo sito locale Studio, esegui:

     cd /path/to/your/studio-site
     studio preview create
     

   • La CLI costruisce e carica il tuo sito locale in un ambiente di preview e restituisce un URL di preview da condividere.

5. Aggiorna o elimina preview usando il nome host del preview:

   • Elenca i preview con studio preview list per ottenere l'identificatore host.
   • Aggiorna:

     studio preview update <host>
     

   • Elimina:

     studio preview delete <host>
     

6. Punta a una directory di sito diversa quando necessario:

   • Aggiungi --path /path/to/site ai comandi invece di cambiare directory:

     studio preview create --path /path/to/your/studio-site
     

Casi d'Uso

• Gestisci siti locali Studio senza lasciare il terminale: Usa studio site status, studio site start, studio site stop e studio site list per controllare ambienti locali in un workflow ricco di script.

• Crea ambienti di preview da condividere con team o stakeholder: Esegui studio preview create dalla root del tuo sito locale Studio per generare un URL di preview temporaneo e condivisibile ospitato su WordPress.com.

• Itera su un preview man mano che arrivano i cambiamenti: Dopo la creazione iniziale del preview, usa studio preview update <host> per ricostruire e ridistribuire i cambiamenti dal sito locale all'ambiente preview esistente.

• Pulisci ambienti di preview: Usa studio preview delete <host> per rimuovere permanentemente un sito preview quando non è più necessario.

• Automatizza workflow Studio nei passaggi di build: Usa comandi studio da script per integrare attività come creazione/aggiornamento preview e gestione siti nella tua pipeline di sviluppo.

FAQ

Devo tenere aperta l'app desktop Studio per usare Studio CLI? No. Studio CLI è progettata per interagire con le funzionalità Studio dal tuo terminale indipendentemente dal fatto che Studio sia aperta.

Come punto un comando a una directory specifica di un sito Studio? La maggior parte dei comandi presume che li esegui dalla root di un sito gestito da Studio. Se non è così, usa l'opzione --path (ad esempio, studio preview create --path /path/to/site).

Cosa succede se eseguo un comando preview mentre sono disconnesso? I comandi che richiedono autenticazione (come studio preview create) restituiscono un errore e ti guidano al login.

Come trovo il nome host del preview da usare per aggiornamento/eliminazione? Esegui studio preview list per visualizzare i preview associati e i loro valori host. Usa quel host con studio preview update <host> o studio preview delete <host>.

Da dove proviene l'informazione di autenticazione per studio auth login? Il comando di login avvia un flusso basato su browser per collegare la CLI al tuo account WordPress.com, quindi fornisce un token di autenticazione da incollare nel terminale per completare il processo.

Alternative

• Flusso di lavoro manuale con l'interfaccia Studio: Se non hai bisogno di automazione da terminale, l'uso diretto dell'applicazione Studio può coprire la creazione di preview e il controllo dei siti locali senza integrazione CLI.
• Strumenti generici da riga di comando per WordPress (es. WP-CLI + scripting personalizzato): Dove non sono richiesti ambienti preview specifici di Studio, puoi combinare strumenti WordPress da riga di comando con script propri per gestire i task dei siti, anche se l'hosting di preview e le funzionalità specifiche di Studio potrebbero non essere coperte.
• Altri approcci di orchestrazione locale per WordPress: Invece dei comandi di gestione siti di Studio, puoi usare configurazioni locali WordPress diverse (containerizzate o scriptate) e gestire le preview tramite passaggi di deployment separati, a scapito della perdita del flusso di lavoro unificato di Studio CLI per preview/creazione/aggiornamento/eliminazione e siti gestiti da Studio.