[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}
使用CLI管理分支
要安装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命令。
magento-cloud environment:branch <branch-name>命令创建环境,才能使环境变为_活动_。 或者,您可以使用Cloud Console创建活动环境。 请参阅云CLI引用。克隆项目master环境:
-
使用文件系统所有者帐户登录到本地工作站。
-
更改为Web服务器或虚拟主机 docroot 目录。
-
使用
magento-cloudCLI登录。code language-bash magento-cloud login -
列出您的项目。
code language-bash magento-cloud project:list -
克隆项目。
code language-bash magento-cloud project:get <project-ID>出现提示时,提供目录名称。
-
更改为
magento2目录。 -
列出项目的可用环境。
code language-bash magento-cloud environment:listnote important IMPORTANT magento-cloud environment:list命令显示环境层次结构,而git branch命令不显示环境层次结构。 -
获取远程分支。
code language-bash git fetch origin -
提取更新的代码。
code language-bash git pull origin <environment-ID>
创建用于开发的分支
在克隆项目并更新Adobe Commerce管理员帐户配置后,可以分支进行开发。 如前所述,您必须使用magento-cloud environment:branch <branch-name>命令或Cloud Console创建环境,以使环境变为 活动。
要创建开发分支:
-
在本地工作站上,转到您的项目目录。
-
根据为您的项目工作流推荐的分支创建环境。
code language-bash magento-cloud branch <new-environment-name> integration -
更新依赖关系。
code language-bash composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader -
[可选]创建环境的备份。
合并分支
完成开发后,将此分支合并到父级:
-
提交和推送代码更改:
code language-bash git add -A && git commit -m "Add message here"code language-bash git push origin <branch-name> -
与父环境合并:
code language-bash magento-cloud environment:merge <environment-ID>
删除环境
仅当您确定不再需要某个环境时,才将其删除。 删除环境后无法恢复该环境。
master分支。您必须是项目管理员、环境管理员或帐户所有者才能执行此任务。 请参阅管理用户对云项目的访问权限。
删除环境时,该环境设置为 不活动。 该代码仍可在Git分支中使用,但不再包含服务或数据库。 要完全删除环境,您还必须删除相应的远程Git分支。
要删除环境:
-
在本地工作站上,转到您的项目目录。
-
从远程服务器获取更新。
code language-bash git fetch -
删除环境分支。
code language-bash magento-cloud environment:delete <environment-ID>或者,您也可以通过将多个环境ID添加到delete命令来一次删除多个环境。
code language-bash magento-cloud environment:delete <environment-1-ID> <environment-2-ID> -
响应提示删除本地环境和相应的远程环境。
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分支会从项目中删除环境。
-
等待环境删除。
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.
magento-cloud environment:activate命令。