文档Commerce云基础架构上的 Commerce 指南

使用CLI管理分支

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

创建对象：

  • undefined

要安装magento-cloud CLI，请参阅云CLI引用。 安装magento-cloud CLI并设置SSH密钥以远程访问云基础架构后，可以使用magento-cloud CLI命令管理项目的环境。 有关环境架构的信息，请参阅入门架构或专业架构。

要使用Cloud Console管理分支和环境，请参阅使用 Cloud Console管理分支。

使用CLI命令

magento-cloud CLI命令与Git命令类似。 您可以使用它们连接到您的项目并管理环境。 虽然可以从任何目录运行命令，但建议从项目目录运行这些命令。 从项目目录运行时，可以省略-p <project-ID>参数。 请参阅云CLI引用。

克隆项目

以下说明使用magento-cloud CLI命令和Git命令的组合将项目克隆到本地工作站。 要查看magento-cloud CLI命令的完整列表，请使用magento-cloud list命令。

IMPORTANT
某些Git命令无法在Adobe Commerce中完成云基础架构项目上的操作。 例如，您可以使用Git命令创建分支，但无法创建和激活新环境。 必须使用magento-cloud environment:branch <branch-name>命令创建环境，才能使环境变为​_活动_。 或者，您可以使用Cloud Console创建活动环境。 请参阅云CLI引用。

克隆项目master环境：

  1. 使用文件系统所有者帐户登录到本地工作站。

  2. 更改为Web服务器或虚拟主机​ docroot ​目录。

  3. 使用magento-cloud CLI登录。

    code language-bash 
    magento-cloud login

  4. 列出您的项目。

    code language-bash 
    magento-cloud project:list

  5. 克隆项目。

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

    出现提示时，提供目录名称。

  6. 更改为magento2目录。

  7. 列出项目的可用环境。

    code language-bash 
    magento-cloud environment:list
    note important
    IMPORTANT
    magento-cloud environment:list命令显示环境层次结构，而git branch命令不显示环境层次结构。

  8. 获取远程分支。

    code language-bash 
    git fetch origin

  9. 提取更新的代码。

    code language-bash 
    git pull origin <environment-ID>
TIP
有关在云基础架构上使用基于Git的托管服务与Adobe Commerce的信息，请参阅集成。

创建用于开发的分支

在克隆项目并更新Adobe Commerce管理员帐户配置后，可以分支进行开发。 如前所述，您必须使用magento-cloud environment:branch <branch-name>命令或Cloud Console创建环境，以使环境变为​ 活动。

  • 对于简易版，请考虑为staging创建分支，然后基于staging分支创建开发分支。
  • 对于Pro，根据Integration分支创建开发分支。

要创建开发分支：

  1. 在本地工作站上，转到您的项目目录。

  2. 根据为您的项目工作流推荐的分支创建环境。

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

  3. 更新依赖关系。

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

  4. [可选]​创建环境的备份。

合并分支

完成开发后，将此分支合并到父级：

  1. 提交和推送代码更改：

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

  2. 与父环境合并：

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

删除环境

仅当您确定不再需要某个环境时，才将其删除。 删除环境后无法恢复该环境。

WARNING
您无法删除任何项目的master分支。

您必须是项目管理员、环境管理员或帐户所有者才能执行此任务。 请参阅管理用户对云项目的访问权限。

删除环境时，该环境设置为​ 不活动。 该代码仍可在Git分支中使用，但不再包含服务或数据库。 要完全删除环境，您还必须删除相应的远程Git分支。

要删除环境：

  1. 在本地工作站上，转到您的项目目录。

  2. 从远程服务器获取更新。

    code language-bash 
    git fetch

  3. 删除环境分支。

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

    或者，您也可以通过将多个环境ID添加到delete命令来一次删除多个环境。

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

  4. 响应提示删除本地环境和相应的远程环境。

    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]

    删除环境会使其处于​ 不活动 ​状态。

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

    删除远程Git分支会从项目中删除环境。

  5. 等待环境删除。

    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
要激活非活动环境，请使用magento-cloud environment:activate命令。

与远程环境交互

在您设置SSH密钥后，您可以从本地工作区连接到远程环境，并与项目服务交互并修改设置。

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26