Cloud CLI

Met het CLI-hulpprogramma van magento-cloud kunnen ontwikkelaars en systeembeheerders Cloud-projecten en -omgevingen beheren, routines uitvoeren en automatiseringstaken uitvoeren. De CLI van magento-cloud breidt de eigenschappen en de functionaliteit van Cloud Console uit. Nadat u de CLI van magento-cloud op uw lokale werkstation hebt geïnstalleerd, kunt u deze gebruiken om uw Adobe Commerce te beheren in de Starter- en Pro-integratieomgevingen van de cloudinfrastructuur.

om magento-cloud CLI te installeren:

  1. Op uw lokaal werkstation, verandering in de folder waar u van plan bent het project van de Wolk te klonen en waar de eigenaar van het dossiersysteemheeft schrijven toegang.

  2. Installeer de magento-cloud CLI.

    code language-bash
    curl -sS https://accounts.magento.cloud/cli/installer | php
    
  3. Voeg magento-cloud CLI aan het basisprofiel toe.

    code language-bash
    export PATH=$PATH:$HOME/.magento-cloud/bin
    
  4. Laad het bijgewerkte basisprofiel opnieuw.

    code language-bash
    . ~/.bash_profile
    
  5. Als u de CLI wilt starten, roept u magento-cloud aan en voert u de referenties van uw Cloud-account in wanneer u hierom wordt gevraagd.

    code language-bash
    magento-cloud
    
    code language-terminal
    Welcome to Magento Cloud!
    Please log in using your Magento Cloud account.
    Your email address or username:
    
  6. Controleer of de opdracht magento-cloud zich in het pad bevindt. In het volgende voorbeeld worden de beschikbare opdrachten weergegeven.

    code language-bash
    magento-cloud list
    

Algemene opdrachten

Adobe heeft deze opdrachten ontworpen om omgevingen voor cloudintegratie te beheren en raadt u aan de CLI van magento-cloud uit te voeren vanuit een projectmap zodat u de parameter -p <project-ID> kunt weglaten.

De volgende lijst met veelgebruikte magento-cloud CLI-opdrachten bevat alleen de vereiste opties. U kunt de optie --help met elke opdracht gebruiken om meer informatie weer te geven.

Opdracht
Beschrijving
magento-cloud login
Meld u aan bij het project.
magento-cloud list
Maak een lijst van de beschikbare bevelen voor CLI hulpmiddel.
magento-cloud environment:list
Maak een lijst van de milieu's in het huidige project.
magento-cloud environment:checkout
Ontdek een bestaande omgeving.
magento-cloud environment:merge -e
Wijzigingen in deze omgeving samenvoegen met het bovenliggende element.
magento-cloud variables
Variabelen weergeven in deze omgeving.
magento-cloud ssh
Gebruik SSH om verbinding te maken met de externe omgeving.
magento-cloud url
Open de Adobe Commerce storefront in een browser.
magento-cloud web
Open de lus Cloud Console .

Omgeving, opdrachten

De milieu naam is verschillend van milieu identiteitskaart slechts als u ruimten of hoofdbrieven in de milieunaam gebruikt. Een milieu-id bestaat uit alle kleine letters, getallen en toegestane symbolen. Hoofdletters in een omgevingsnaam worden omgezet in kleine letters in de id. Spaties in een omgevingsnaam worden omgezet in streepjes.

Een milieu naam kan geen karakters omvatten die voor uw shell van Linux of voor regelmatige uitdrukkingen worden gereserveerd. De verboden karakters omvatten krullende steunen ({ }), haakjes, asterisk (*), punthaakjes (< >), en het en (&), percenten (%), en andere karakters.

De opdracht magento-cloud environment:list geeft omgevingshiërarchieën weer, maar git branch niet. Als u een geneste omgeving hebt, gebruikt u het volgende:

magento-cloud environment:list

Omgeving opnieuw implementeren

Trigger een herplaatsing zonder een duw te gebruiken. Controleer en bevestig de omgeving die opnieuw moet worden geïmplementeerd. Gebruik geen hergroepering als er een bouwstijl in een hangende staat is.

magento-cloud environment:redeploy

Monsterrespons:

Are you sure you want to redeploy the environment <environment-name>? [Y/n]
WARNING
Het implementatieproces begint wanneer u een samenvoeging, push of synchronisatie van uw omgeving uitvoert of wanneer u een handmatige herimplementatie activeert, waarbij de toepassing van Commerce zich in de onderhoudsmodus bevindt. Voor een productieomgeving raadt de Adobe aan deze werkzaamheden tijdens de werkuren buiten de piekuren af te ronden om onderbreking van de service te voorkomen.

Opdrachten Git

Het kan zijn dat sommige van deze opdrachten lijken op de opdrachten bij Git. De opdrachten van magento-cloud maken rechtstreeks verbinding met het op Git gebaseerde Cloud-project met extra functies. Als u een vertakking maakt zonder de CLI van magento-cloud te gebruiken, wordt deze niet geactiveerd en wordt deze niet automatisch gegenereerd wanneer u wijzigingen in de externe omgeving aanbrengt. De opdracht magento-cloud CLI bevat activering.

Als u een vertakking wilt maken, gebruikt u de opdracht magento-cloud , zodat de vertakking wordt geactiveerd.

magento-cloud environment:branch <new-name> <parent-branch>

Voor de status van een vertakking:

  • Gebruik de opdracht magento-cloud env om een lijst weer te geven met de vertakkingen van de omgeving en hun status: actief of inactief.
  • Gebruik de opdracht magento-cloud environment:activate om een omgevingsvertakking te activeren.

Druk op een lege Git om een implementatie te activeren. Bijvoorbeeld:

git commit --allow-empty -m "redeploy" && git push <branch-name>

Sommige acties, zoals het toevoegen van een gebruiker, resulteren niet in plaatsing.

Een omgevingsvertakking maken

De volgende stappen tonen het gebruiken van CLI en van het Git bevelen onderling verwisselbaar aan om uw lokale milieu te beheren:

  1. Wijzig op uw lokale werkstation de projectmap.

  2. Schakelaar aan de eigenaar van het dossiersysteem.

  3. Meld u aan bij uw project.

    code language-bash
    magento-cloud login
    
  4. Maak een lijst van uw projecten.

    code language-bash
    magento-cloud project:list
    
  5. Maak een lijst van milieu's in het project. Elke omgeving bevat een actieve Git-vertakking die uw code, database, omgevingsvariabelen, configuraties en services bevat.

    code language-bash
    magento-cloud environment:list
    
    note note
    NOTE
    Het is belangrijk dat u de opdracht magento-cloud environment:list gebruikt, omdat deze omgevingshiërarchieën weergeeft, maar de opdracht git branch niet.
  6. Zoek de laatste code naar de vertakkingen van de oorsprong.

    code language-bash
    git fetch origin
    
  7. Uitchecken of overschakelen naar een specifieke vertakking en omgeving.

    code language-bash
    magento-cloud environment:checkout <environment-ID>
    

    Met Git-opdrachten kunt u alleen de Git-vertakking uitchecken. De opdracht magento-cloud checkout checkt de vertakking uit en schakelt over naar de actieve omgeving.

    note tip
    TIP
    U kunt een omgevingsvertakking maken met de opdrachtsyntaxis magento-cloud environment:branch <environment-name> <parent-environment-ID> . Het kan enige extra tijd duren om een omgevingsvertakking te maken en te activeren.
  8. Gebruik de milieu-id om bijgewerkte code aan uw lokale computer te trekken. Dit is niet nodig als de omgevingsvertakking nieuw is.

    code language-bash
    git pull origin <environment-ID>
    
  9. (Facultatieve) creeer a momentopnamevan het milieu als steun.

    code language-bash
    magento-cloud snapshot:create -e <environment-ID>
    

CLI bijwerken

De CLI van magento-cloud controleert op beschikbare updates wanneer u login, maar u kunt op updates controleren gebruikend het self:update bevel. Als er een update beschikbaar is, volg de instructies om CLI bij te werken.

Als uw magento-cloud CLI bijgewerkt is, ziet u de volgende reactie:

magento-cloud update
Checking for Magento Cloud CLI updates (current version: X.XX.X)
No updates found
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26