DocumentationGuide de Commerce sur Cloud

Gestion des branches avec l’interface de ligne de commande

Last update: Fri Jan 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Développeur

Pour installer l’interface de ligne de commande magento-cloud, reportez-vous à la référence de l’interface de ligne de commande Cloud. Après avoir installé l’interface de ligne de commande magento-cloud et configuré les clés SSH pour l’accès à distance à votre infrastructure cloud, vous pouvez utiliser magento-cloud commandes d’interface de ligne de commande pour gérer les environnements de vos projets. Pour plus d’informations sur l’architecture de l’environnement, voir Architecture de démarrage ou Architecture Pro.

Pour gérer les branches et les environnements avec le Cloud Console, voir Gérer les branches avec le Cloud Console.

Utilisation des commandes de l’interface de ligne de commande

Les commandes de l’interface de ligne de commande magento-cloud sont similaires aux commandes Git. Vous pouvez les utiliser pour vous connecter à votre projet et gérer vos environnements. Bien que vous puissiez exécuter les commandes à partir de n’importe quel répertoire, il est recommandé de les exécuter à partir d’un répertoire de projet. Lors de l’exécution à partir d’un répertoire de projet, vous pouvez omettre le paramètre -p <project-ID> . Voir la référence de l’interface de ligne de commande Cloud.

Cloner le projet

Les instructions suivantes utilisent une combinaison de commandes d’interface de ligne de commande magento-cloud et de commandes Git pour cloner votre projet sur votre station de travail locale. Pour afficher la liste complète des commandes de l’interface de ligne de commande magento-cloud, utilisez la commande magento-cloud list.

IMPORTANT
Certaines commandes Git ne peuvent pas effectuer une action dans votre projet d’infrastructure cloud Adobe Commerce. Par exemple, vous pouvez créer une branche à l’aide d’une commande Git, mais vous ne pouvez pas créer ni activer un nouvel environnement. Vous devez créer un environnement à l’aide de la commande magento-cloud environment:branch <branch-name> pour que l’environnement devienne actif. Vous pouvez également utiliser l’Cloud Console pour créer des environnements actifs. Voir Référence de l’interface de ligne de commande Cloud.

Pour cloner un projet master un environnement :

  1. Connectez-vous à votre station de travail locale avec un compte propriétaire du système de fichiers.

  2. Accédez au serveur web ou à l’hôte virtuel répertoire docroot.

  3. Connectez-vous à l’aide de l’interface de ligne de commande magento-cloud.

    code language-bash 
    magento-cloud login

  4. Répertoriez vos projets.

    code language-bash 
    magento-cloud project:list

  5. Clonez un projet.

    code language-bash 
    magento-cloud project:get <project-ID>

    Lorsque vous y êtes invité, indiquez un nom de répertoire.

  6. Accédez au répertoire magento2.

  7. Liste des environnements disponibles pour le projet.

    code language-bash 
    magento-cloud environment:list
    note important
    IMPORTANT
    La commande magento-cloud environment:list affiche les hiérarchies d’environnement, contrairement à la commande git branch .

  8. Récupérez les branches distantes.

    code language-bash 
    git fetch origin

  9. Extrayez le code mis à jour.

    code language-bash 
    git pull origin <environment-ID>
TIP
Consultez Intégrations pour plus d’informations sur l’utilisation des services d’hébergement basés sur Git avec Adobe Commerce sur les infrastructures cloud.

Créer une branche pour le développement

Après avoir cloné votre projet et mis à jour la configuration du compte administrateur Adobe Commerce, vous pouvez créer une branche pour le développement. Comme indiqué précédemment, vous devez créer un environnement à l’aide de la commande magento-cloud environment:branch <branch-name> ou de la Cloud Console pour que l’environnement devienne actif.

  • Pour Starter, pensez à créer une branche pour staging, puis à créer une branche de développement basée sur la branche staging.
  • Pour Pro, créez des branches de développement basées sur la branche Integration.

Pour créer une branche de développement :

  1. Sur votre station de travail locale, accédez au répertoire du projet.

  2. Créez un environnement basé sur la branche recommandée pour le workflow de votre projet.

    code language-bash 
    magento-cloud branch <new-environment-name> integration

  3. Mettez à jour les dépendances.

    code language-bash 
    composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader

  4. [facultatif] Créez une sauvegarde de l’environnement.

Fusion d’une branche

Une fois le développement terminé, fusionnez cette branche avec le parent :

  1. Modifications du code de validation et de notification push :

    code language-bash 
    git add -A && git commit -m "Add message here"
    code language-bash 
    git push origin <branch-name>

  2. Fusionner avec l’environnement parent :

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

Suppression d’un environnement

Ne supprimez un environnement que si vous êtes certain de n’en plus avoir besoin. Vous ne pouvez pas récupérer un environnement après l’avoir supprimé.

WARNING
Vous ne pouvez pas supprimer la branche master d’un projet.

Pour effectuer cette tâche, vous devez être un administrateur de projet, un administrateur d’environnement ou un propriétaire de compte. Voir Gérer l’accès des utilisateurs aux projets cloud.

Lorsque vous supprimez un environnement, celui-ci est défini sur inactif. Le code est toujours disponible dans la branche Git, mais ne contient plus les services ni la base de données. Pour supprimer complètement l’environnement, vous devez également supprimer la branche Git distante correspondante.

Pour supprimer un environnement :

  1. Sur votre station de travail locale, accédez au répertoire du projet.

  2. Récupérez les mises à jour à partir du serveur distant.

    code language-bash 
    git fetch

  3. Supprimez la branche d’environnement.

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

    Vous pouvez éventuellement supprimer plusieurs environnements à la fois en ajoutant plusieurs identifiants d’environnement à la commande de suppression.

    code language-bash 
    magento-cloud environment:delete <environment-1-ID> <environment-2-ID>

  4. Répondez aux invites pour supprimer l'environnement local et l'environnement distant correspondant.

    code language-none 
    The environment <environment-ID> is currently active: deleting it will delete all associated data.
Are you sure you want to delete the environment <environment-ID>? [Y/n]

    La suppression de l’environnement le place dans un état inactif.

    code language-none 
    Delete the remote Git branch too? [Y/n]

    La suppression de la branche Git distante supprime l’environnement du projet.

  5. Attendez que l’environnement soit supprimé.

    code language-none 
    Deleting environment <environment-ID>
Waiting for the activity...
  Deleting environment <project-id>-<environment-ID>-xxxxxx

  [============================]  1 min (complete)
Activity ID succeeded
Deleted remote Git branch <environment-ID>
Run git fetch --prune to remove deleted branches from your local cache.
TIP
Pour activer un environnement inactif, utilisez la commande magento-cloud environment:activate.

Interaction avec des environnements distants

Après avoir configuré les clés SSH, vous pouvez vous connecter de votre espace de travail local à un environnement distant interagir avec les services de votre projet et modifier les paramètres.

recommendation-more-help