使用Cloud Console管理分支
您可以使用Cloud Console或magento-cloud
CLI管理环境。 您的项目文件存储在Git存储库中。 您可以使用Git命令来管理代码,但magento-cloud
CLI设计用于与平台功能交互,而Git命令则不然。 请参阅云CLI主题中的Git命令。
本主题讨论如何使用Cloud Console来:
- 添加或删除环境
- 从父环境同步(
git pull
) - 将(
git push
)合并到父环境
master
分支中分支。创建环境
分支策略使用通用的Git工作流,您可以在其中开发代码并在开发分支中添加扩展。 查看Starter和Pro架构概述。
- 首先,从
master
分支创建staging
分支,然后从staging
分支进行开发。 - 对于Pro,从
Integration
环境创建一个开发分支。
您的帐户支持有限数量的 {width="32"} (active) and an unlimited number of {width="32"} (非活动)开发分支。 通过仅使用Cloud Console或Cloud CLI添加或删除分支来管理活动和不活动分支。 在删除分支之前,请先取消激活该分支,它仍保留在 环境 列表中,作为 不活动。 您可以稍后重新激活分支,也可以在环境设置中或使用云CLI删除分支。
如果需要其他活动环境进行开发,请提交支持票证。
添加分支:
-
登录到Cloud Console。
-
从 所有项目 列表中选择一个项目。
-
选择环境。
note tip TIP 您的新分支是从此环境中克隆的。 选择与要创建的环境类似的父环境。 -
单击 Branch。
{width="150"}
-
在 分支自…… 表单中,输入分支名称。
只有在环境名称中使用空格或大写字母时,环境 name 才会与环境 ID 不同。 环境ID由所有小写字母、数字和允许的符号组成。 环境名称中的大写字母在ID中转换为小写;环境名称中的空格转换为破折号。
环境名称 不能 包含为Linux shell或正则表达式保留的字符。 禁止使用的字符包括大括号(
{ }
)、圆括号、星号(*
)、尖括号(>
)、&符号(&
)、% (%
),以及其他字符。 -
选择 Environment type。
-
单击 Create Branch。
-
正在部署环境,请稍候。
在部署期间,环境状态为 正在进行。 成功部署后,状态将更改为 success 的绿色复选标记。
创建非活动分支
您无法从Adobe Commerce Cloud控制台或CLI创建非活动分支。 如果要创建非活动分支,请在Git存储库中创建它,并使用命令上的environment.Parent
选项进行推送。
git push -o "environment.Parent=<parent branch>" <origin> <branch>
删除环境
在删除环境之前,必须取消激活该环境。 环境处于非活动状态后,您可以将其删除。
要停用环境:
-
登录到Cloud Console。
-
从 所有项目 列表中选择一个项目。
-
从导航栏 环境 列表中选择环境。
-
单击顶部导航栏右侧的配置图标,打开环境设置。
-
在 General 选项卡上,向下滚动到 Deactivate environment 部分,然后单击 Deactivate environment and delete data 并按照说明操作。
同步环境
同步环境(或分支)与git pull origin <parent>
相同。 您可以从父环境中同步更新的代码。 您可以通过Cloud Console将此功能用于所有入门和专业环境。
对于Pro计划,您可以从暂存和生产同步到master
分支。 此同步仅提取和推送代码,而不提取数据。 要同步数据,请转储数据库数据并将其推送到另一个环境的数据库。 请参阅迁移和部署静态文件和数据。
同步环境:
-
登录到Cloud Console。
-
从 所有项目 列表中选择一个项目。
-
在环境列表中,单击要同步的分支的名称。
-
单击(同步)。
{width="150"}
-
选择要同步的项目。
- 替换数据 — (数据和文件)同步父分支中数据库和内容文件的更改。
- 合并 — (代码)同步来自父分支的已更新代码。
这还会生成一个CLI命令供您复制和使用。
-
单击 同步。
与父环境合并
合并环境(或分支)与git push origin
相同。 您可以合并以将更新后的代码从环境推送到其父环境。 您可以将此代码合并到master
。 您可以使用merge
命令部署到暂存和生产环境。
要与父环境合并:
-
登录到Cloud Console。
-
从 所有项目 列表中选择一个项目。
-
在环境列表中,单击要合并的分支的名称。
-
单击(合并)。
{width="150"}
-
单击 合并 并确认操作。
查看日志
通过Cloud Console,您可以查看环境的各种日志,包括生成、部署和部署历史记录。
对于 Starter,您可以查看生成和部署日志以及部署历史记录。 这些环境包括master
(生产)分支以及从中创建的所有分支。
对于 Pro,您可以在每个环境中查看以下日志:
- 集成 — 构建、部署和部署历史记录
- 暂存 — 构建日志和部署历史记录。 使用SSH登录到服务器以查看部署日志。
- 生产 — 构建日志和部署历史记录。 使用SSH登录到服务器以查看部署日志。
要在Cloud Console 中查看日志:
-
登录到Cloud Console。
-
从 所有项目 列表中选择一个项目。
-
选择环境。
环境视图提供了活动列表,该列表显示 最近 个事件,每个尝试的操作有一个条目,包括同步、合并、分支、备份等。 单击 全部 查看完整的部署历史记录。
-
要查看生成日志,请选择帐户上每个部署记录的成功或失败链接。
从专用Git存储库中提取代码
您在云基础架构上的Adobe Commerce项目可以包含来自私有Git存储库的代码。 例如,您可能拥有专用存储库中自定义模块或主题的代码。 为此,您必须将项目的公共SSH密钥添加到私有Git存储库并更新项目composer.json
文件。
要向专用GitHub存储库添加部署密钥,您必须是该存储库的管理员。 GitHub允许您仅对一个存储库使用部署密钥。
如果您希望项目访问多个存储库,则可以将SSH密钥附加到自动用户帐户。 由于此帐户不是由用户使用,因此它称为计算机用户。 将计算机帐户添加为协作者,或者将计算机用户添加到具有存储库访问权限的团队。
要查找您的SSH公钥:
-
登录到Cloud Console。
-
从 所有项目 列表中选择一个项目。
-
单击顶部导航栏右侧的配置图标。
-
在 项目设置 中,单击 Deploy Key。
-
将部署密钥复制到剪贴板,以供在以下基于Git的方法之一中使用:
输入您的GitHub部署密钥
在GitHub上,部署密钥默认为只读。
要输入项目公钥作为GitHub部署密钥,请执行以下操作:
-
以管理员身份登录到您的GitHub存储库。
-
单击存储库 Settings 选项卡。
note note NOTE 如果没有看到此选项,则表示您不是以存储库管理员的身份登录,并且无法完成此任务。 请咨询GitHub存储库管理员以执行此操作。 -
在左侧导航栏的 设置 选项卡上,单击 Deploy Keys。
-
单击 Add deploy key。
-
按照提示操作。
在composer.json
中,使用<user>@<host>:<.git</code>
格式,如果使用非标准端口,则使用ssh://<user>@<host>:<port>/<path>.git
。
输入您的Bitbucket部署密钥
要输入项目公钥作为Bitbucket部署密钥,请执行以下操作:
-
以管理员身份登录到您的Bitbucket存储库。
-
在左侧导航中,单击 Settings。
-
单击“常规”>Deployment Keys。
-
单击 Add Key。
-
按照提示操作。
输入您的GitLab部署密钥
要添加项目的公共SSH密钥作为GitLab部署密钥:
-
以所有者身份登录到您的GitLab存储库。
-
验证是否已为您的项目启用 管道 选项:
- 在项目设置中,展开 Visibility, project, features, permissions 部分。
- 如有必要,请单击 Pipelines 以启用该选项。
-
将公共SSH密钥添加到CI/CD设置。
- 在左侧导航中,单击设置> CI / CD。
- 单击部署密钥 展开 以配置密钥。
- 在 部署密钥 表单中,将部署密钥名称添加到 Title 字段,并将您的公共SSH密钥粘贴到 Key 字段。
- 单击 Add Key 保存配置。
保护环境和分支机构的安全
您可以使用Cloud Console通过Web浏览器从任何位置访问您的项目和环境。 您可能已为生产环境、商店和站点设置了安全性。 本节将帮助您确保集成和暂存环境的安全,严格限制为开发人员、DBA等的安全。
保护环境:
-
登录到Cloud Console。
-
从 所有项目 列表中选择一个项目。
-
选择环境并单击导航栏上的配置图标。
-
在环境设置 常规 选项卡上,单击 HTTP access control enabled 的 开启 以启用安全访问。 您可以在凭据或IP地址之间进行选择以筛选访问权限。
-
要按凭据筛选,请单击 Add Login,输入用户名和密码,然后单击 Add Login 进行添加。
-
要按IP地址过滤,请在包含
deny
或allow
的列表中输入IP地址。 例如:code language-text 123.456.789.111/29 allow 123.456.789.112/29 allow 234.123.567.111/29 allow 0.0.0.0/0 deny
-
单击 Save。 这将重新部署环境以更新安全和设置。 Adobe建议在完成安全设置后测试环境。