Cloud CLI

De magento-cloud Met het CLI-hulpprogramma kunnen ontwikkelaars en systeembeheerders Cloud-projecten en -omgevingen beheren, routines uitvoeren en automatiseringstaken uitvoeren. De magento-cloud CLI breidt de eigenschappen en de functionaliteit van uit Cloud Console. Nadat u de magento-cloud CLI op uw lokale werkstation, kunt u het gebruiken om uw Adobe Commerce op de milieu's van de Aanzet en van de integratie van de wolkeninfrastructuur te beheren Pro.

Als u het dialoogvenster magento-cloud CLI:

  1. Wijzig op uw lokale werkstation de directory waarin u het Cloud-project wilt klonen en waar de eigenaar van bestandssysteem heeft schrijven toegang.

  2. Installeer de magento-cloud CLI.

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

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

    code language-bash
    . ~/.bash_profile
    
  5. Om CLI in werking te stellen, roep magento-cloud en voer uw aanmeldingsgegevens voor uw Cloud-account in wanneer 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 de magento-cloud bevindt zich in uw pad. 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 magento-cloud CLI van een projectfolder zodat kunt u weglaten -p <project-ID> parameter.

De volgende lijst met veelgebruikte magento-cloud CLI-opdrachten bevatten alleen de vereiste opties. U kunt de --help optie met om het even welk bevel om meer informatie te zien.

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 Cloud Console.

Omgeving, opdrachten

Het milieu name verschilt van het milieu ID alleen als u spaties of hoofdletters in de omgevingsnaam 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 omgevingsnaam kan include-tekens die zijn gereserveerd voor uw Linux-shell of voor reguliere expressies. Verboden tekens bevatten accolades ({ }), ronde haakjes, asterisk (*), punthaken (< >), ampersand (&), percentage (%) en andere tekens.

De magento-cloud environment:list bevel toont omgevingshiërarchieën, terwijl 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 plaatsingsproces begint wanneer u een fusie, duw, of synchronisatie van uw milieu uitvoert, of wanneer u een handherplaatsing teweegbrengt, waarin Commerce de toepassing bevindt zich in de onderhoudsmodus. 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 magento-cloud maakt rechtstreeks verbinding met het op Git gebaseerde Cloud-project met extra functies. Als u een vertakking maakt zonder de opdracht magento-cloud CLI, wordt het niet "geactiveerd"en bouwt niet automatisch wanneer u veranderingen in het verre milieu duwt. De magento-cloud CLI-opdracht omvat activering.

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

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

Voor de status van een vertakking:

  • Gebruik de magento-cloud env gebruiken om een lijst weer te geven van de vertakkingen van de omgeving en hun status: actief of inactief.
  • Gebruik de magento-cloud environment:activate gebruiken 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. Schakel over naar de eigenaar van bestandssysteem.

  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 om de magento-cloud environment:list gebruiken omdat er omgevingshiërarchieën worden weergegeven, terwijl de git branch niet wordt uitgevoerd.
  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 magento-cloud checkout het bevel controleert de tak en schakelaars aan het actieve milieu.

    note tip
    TIP
    U kunt een omgevingsvertakking maken met de opdracht magento-cloud environment:branch <environment-name> <parent-environment-ID> opdrachtsyntaxis. 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. (Optioneel) Maak een opname van de omgeving als back-up.

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

CLI bijwerken

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

Als uw magento-cloud CLI is bijgewerkt, 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