DocumentationCommerceGuide de Commerce sur les infrastructures cloud

Gestion des branches à l’aide de l’interface de ligne de commande

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Développeur

Pour installer l’interface de ligne de commande magento-cloud, consultez 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é des clés SSH pour l’accès à distance à votre infrastructure cloud, vous pouvez utiliser les commandes de l’interface de ligne de commande magento-cloud 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 Cloud Console, voir Gestion des 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. Lorsqu’il est exécuté à partir d’un répertoire de projet, vous pouvez omettre le paramètre -p <project-ID> . Voir la référence d’interface en ligne de commande Cloud.

Cloner le projet

Les instructions suivantes combinent des commandes d’interface de ligne de commande magento-cloud et des commandes Git pour cloner votre projet sur votre poste de travail local. 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 d’action dans votre projet Adobe Commerce sur l’infrastructure cloud. 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 le 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 environnement :

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

  2. Modifiez le répertoire du serveur web ou de l’hôte virtuel docroot .

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

    code language-bash 
    magento-cloud login

  4. Liste de vos projets.

    code language-bash 
    magento-cloud project:list

  5. Cloner 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 des 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
Voir Intégrations pour plus d’informations sur l’utilisation des services d’hébergement Git avec Adobe Commerce sur l’infrastructure cloud.

Création d’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 Cloud Console pour que l’environnement devienne actif.

  • Pour Starter, envisagez de créer une branche pour staging, puis de 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 poste de travail local, modifiez le répertoire de votre projet.

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

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

  3. Mise à jour des 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. Validation et modification du code 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>

Supprimer un environnement

Supprimez un environnement uniquement si vous êtes certain que vous n’en avez plus besoin. Une fois supprimé, vous ne pouvez pas récupérer un environnement.

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

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

Lorsque vous supprimez un environnement, celui-ci est défini sur inactive. 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 poste de travail local, modifiez le répertoire de votre 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 ID 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 les 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
05f2f56e-ac5d-4931-8cdb-764e60e16f26