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

配置服务

Last update: Thu Sep 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
  • 开发人员

services.yaml文件定义Adobe Commerce在云基础架构上支持和使用的服务，例如MySQL、Redis和Elasticsearch或OpenSearch。 您无需订阅外部服务提供商。

NOTE
.magento/services.yaml文件是在项目的.magento目录中本地管理的。 在构建过程中仅访问配置以在集成环境中定义所需的服务版本，并在部署完成后删除，这样在服务器上就找不到它们。

部署脚本使用.magento目录中的配置文件为环境配置配置的服务。 如果某个服务包含在.magento.app.yaml文件的relationships属性中，则该服务对您的应用程序可用。 services.yaml文件包含​ 类型 ​和​ 磁盘 ​值。 服务类型定义服务​ name ​和​ version。

更改服务配置会导致部署为环境提供更新的服务，这会对以下环境造成影响：

  • 所有入门环境，包括生产master
  • 专业集成环境
TIP
对于Pro项目，您必须提交Adobe Commerce支持票证才能仅在Staging和Production环境中安装或更新服务。
指示所需的服务更改，包括更新的.magento.app.yaml和services.yaml文件，并在票证中声明PHP版本。 有关对PHP版本、扩展或环境设置的自助更改，请参阅​_应用程序配置_​中的PHP设置。
对实时生产环境的更改（仅限​ Pro），至少需要48小时的通知。 这使云基础架构团队有充足的时间来调配资源并进行安全升级。 当基础架构团队确认请求并计划升级（不包括周末）时，通知期即开始。 例如，要在星期一完成服务升级，必须在星期三之前收到计划升级的确认。 在需求高峰期，处理您的请求可能需要更多时间。

默认服务和支持的服务

云基础架构支持和部署以下服务：

您可以在当前默认services.yaml文件中查看默认版本和磁盘值。 以下示例显示了services.yaml配置文件中定义的mysql、redis、opensearch或elasticsearch以及rabbitmq服务：

mysql:
    type: mysql:10.4
    disk: 5120

redis:
    type: redis:6.2

opensearch:
    type: opensearch:2  # minor version not required; uses latest
    disk: 1024

rabbitmq:
    type: rabbitmq:3.9
    disk: 1024

服务值

您必须提供服务ID和服务类型配置type: <name>:<version>。 如果服务使用永久存储，则必须提供磁盘值。

使用以下格式：

<service-id>:
    type: <name>:<version>
    disk: <value-MB>

service-id

service-id值标识项目中的服务。 您只能使用小写字母数字字符：a到z和0到9，如redis。

此​ service-id ​值在.magento.app.yaml配置文件的relationships属性中使用：

relationships:
    redis: "<name>:redis"

您可以命名每种服务类型的多个实例。 例如，您可以使用多个Redis实例 — 一个用于会话，一个用于缓存。

redis:
    type: redis:<version>

redis2:
    type: redis:<version>

重命名services.yaml文件​ 中的服务将永久删除 ​以下内容：

  • 使用您指定的新名称创建服务之前的现有服务。
  • 服务的所有现有数据都会被删除。 Adobe强烈建议您在更改现有服务的名称之前备份您的入门环境。

type

type值指定服务名称和版本。 例如：

mysql:
    type: mysql:10.4

disk

disk值指定要分配给服务的永久磁盘存储的大小（以MB为单位）。 使用永久存储的服务（如MySQL）必须提供磁盘值。 使用内存而不是永久存储的服务（如Redis ）不需要磁盘值。

mysql:
    type: mysql:10.4
    disk: 5120

每个项目的当前默认存储量为5 GB，即512 0 MB。 您可以在应用程序及其各项服务之间分配此金额。

服务关系

在云基础架构项目上的Adobe Commerce中，在.magento.app.yaml文件中配置的服务关系决定了应用程序可用的服务。

您可以从$MAGENTO_CLOUD_RELATIONSHIPS环境变量检索所有服务关系的配置数据。 配置数据包括服务名称、类型和版本，以及任何所需的连接详细信息，如端口号和登录凭据。

验证本地环境中的关系：

  1. 在本地环境中，显示活动环境的关系。

    code language-bash 
    magento-cloud relationships

  2. 确认响应中的service和type。 响应提供连接信息，如IP地址和端口号。

    缩写示例响应

    code language-yaml 
    redis:
    -
...
        type: 'redis:7.0'
        port: 6379
elasticsearch:
    -
...
        type: 'opensearch:2'
        port: 9200
database:
    -
...
        type: 'mysql:10.6'
        port: 3306

验证远程环境中的关系：

  1. 使用SSH登录到远程环境。

  2. 列出环境中配置的所有服务的关系配置数据。

    code language-bash 
    echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 -d | json_pp

    或者，使用以下ece-tools命令查看关系：

    code language-bash 
    php ./vendor/bin/ece-tools env:config:show services

  3. 确认响应中的service和type。 响应提供连接信息，如IP地址和端口号以及任何所需的用户名和密码凭据。

服务版本

云基础架构上Adobe Commerce的服务版本和兼容性支持取决于在云基础架构上部署和测试的版本，有时与Adobe Commerce内部部署支持的版本不同。 有关Adobe已使用特定Adobe Commerce和Magento Open Source版本测试的第三方软件依赖项的列表，请参阅​ 安装 ​指南中的系统要求。

软件EOL检查

在部署过程中，ece-tools包会根据每个服务的生命周期结束(EOL)日期检查已安装的服务版本。

  • 如果服务版本在EOL日期后的三个月内，则部署日志中会显示通知。
  • 如果EOL日期是过去的时间，则会显示警告通知。

为维护存储安全性，请在已安装的软件版本达到EOL之前更新这些版本。 您可以在ece-tools' eol.yaml文件中查看EOL日期。

迁移到OpenSearch

WARNING
云基础架构上的Adobe Commerce不支持Elasticsearch7.11及更高版本。 Adobe Commerce版本2.3.7-p3、2.4.3-p2、2.4.4及更高版本支持OpenSearch服务。 内部部署安装继续支持Elasticsearch。

对于Adobe Commerce版本2.4.4及更高版本，请参阅设置OpenSearch服务。

更改服务版本

您可以升级已安装的服务版本，以便与云环境中部署的Adobe Commerce版本兼容。

不能直接降级已安装服务的服务版本。 但是，您可以使用所需的版本创建服务。 请参阅降级服务版本。

升级已安装的服务版本

您可以通过更新services.yaml文件中的服务配置来升级已安装的服务版本。

  1. 更改.magento/services.yaml文件中服务的type值：

    原始服务定义

    code language-yaml 
    mysql:
    type: mysql:10.3
    disk: 2048

    更新了服务定义

    code language-yaml 
    mysql:
    type: mysql:10.4
    disk: 5120

  2. 添加、提交和推送代码更改。

    code language-bash 
    git add .magento/services.yaml
    code language-bash 
    git commit -m "Upgrade MySQL from MariaDB 10.3 to 10.4."
    code language-bash 
    git push origin <branch-name>

降级版本

不能直接降级已安装的服务。 您有两个选项：

  1. 使用新版本重命名现有服务，这将删除现有服务和数据，并添加新服务和数据。

  2. 创建服务并从现有服务中保存数据。

更改服务版本时，必须更新services.yaml文件中的服务配置，并更新.magento.app.yaml文件中的关系。

要通过重命名现有服务来降级服务版本，请执行以下操作：

  1. 重命名.magento/services.yaml文件中的现有服务并更改版本。

    note warning
    WARNING
    重命名现有服务会替换现有服务并删除所有数据。 如果需要保留数据，请创建一个服务，而不是重命名现有服务。

    例如，要将​ mysql ​服务的MariaDB版本从版本10.4降级到10.3，请更改现有的​ service-id ​和​ type ​配置。

    原始services.yaml定义

    code language-yaml 
    mysql:
    type: mysql:10.4
    disk: 5120

    新services.yaml定义

    code language-yaml 
    mysql2:
     type: mysql:10.3
     disk: 5120

  2. 更新.magento.app.yaml文件中的关系。

    原始.magento.app.yaml配置

    code language-yaml 
    relationships:
    database: "mysql:mysql"

    已更新.magento.app.yaml配置

    code language-yaml 
    relationships:
    database: "mysql2:mysql"

  3. 添加、提交和推送代码更改。

要通过创建服务来降级服务，请执行以下操作：

  1. 将服务定义添加到具有降级版本规范的项目的services.yaml文件中。 请参阅以下示例中的​ mysql2：

    services.yaml

    code language-yaml 
    mysql:
    type: mysql:10.4
    disk: 5120
mysql2:
    type: mysql:10.3
    disk: 5120

  2. 更改.magento.app.yaml文件中的关系配置以使用新服务。

    原始.magento.app.yaml配置

    code language-yaml 
    relationships:
    database: "mysql:mysql"

    新.magento.app.yaml配置

    code language-yaml 
    relationships:
    database: "mysql2:mysql"

  3. 添加、提交和推送代码更改。

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