对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

AtlasNetworkContainer 自定义资源

重要

旧版子资源自相应的 CRD发布以来已被弃用。如果您的配置当前依赖于此资源定义的子资源形式,迁移到 CRD。

AtlasNetworkContainer 自定义资源定义了Atlas项目的网络容器。您可以在网络容器和托管应用程序的网络之间创建VPC对等互连。

重要

自定义资源不再默认删除对象

  • Atlas Kubernetes Operator使用自定义资源配置文件来管理Atlas配置,但从Atlas Kubernetes Operator2.0 开始,您在Kubernetes中删除的自定义资源不再(默认)在Atlas中删除。相反, Atlas Kubernetes Operator只是停止管理Atlas中的这些资源。 AtlasProject示例,如果您在Kubernetes中删除 自定义资源,默认默认, Atlas Kubernetes Operator不再自动从Atlas中删除相应的项目。这种行为更改旨在帮助防止意外删除。 要学习;了解详情,包括如何将此行为恢复为在Atlas Kubernetes Operator.2 0之前使用的默认,请参阅新默认值: Atlas Kubernetes2 Operator.0 中的删除保护。

    同样,如果您使用Atlas Kubernetes Operator从Kubernetes中的Atlas项目中删除团队,则Atlas Kubernetes Operator不会从Atlas中删除团队。

  • 显式定义所需的配置详细信息,以避免隐式使用默认Atlas配置值。 在某些情况下,继承Atlas默认值可能会导致协调循环,从而阻止自定义资源实现 READY 状态。 示例,在 AtlasDeployment 自定义资源中显式定义所需的自动伸缩行为(如所包含的示例所示)可确保自定义资源中的静态实例大小不会重复应用于已启用自动伸缩的Atlas部署。

    autoScaling:
    diskGB:
    enabled: true
    compute:
    enabled: true
    scaleDownEnabled: true
    minInstanceSize: M30
    maxInstanceSize: M40

Atlas Kubernetes Operator does one of the following actions using the Atlas Network Peering API Resource:

  • 创建新的网络容器。

  • 更新现有网络容器。

以下示例说明了 AtlasNetworkContainer CRD 的配置。

  • 基本示例配置定义了一个资源,您可以使用管理其父Atlas项目的同一Atlas Kubernetes Operator实例来管理该资源。

  • 独立 CRD示例配置与基本示例相同的网络容器,但适用于您在管理网络容器的Atlas Kubernetes Operator实例外部管理的Atlas项目。

以下显示了名为AtlasNetworkContainer 的容器的 自定义资源,其允许您在my-atlas-nc Atlas 与 Amazon my-projectWeb Services 之间创建 VPC 对等互连连接,并将其放置在 项目中。要在与其父 Atlas 项目相同的 Atlas Kubernetes Operator 实例中管理此资源,您必须使用 projectRef 而不是 externalProjectRef 来标识该项目。

apiVersion: atlas.mongodb.com/v1
kind: AtlasNetworkContainer
metadata:
name: my-atlas-nc
spec:
projectRef:
name: my-project
namespace: my-operator-namespace
provider: AWS
id: 66e2f2b7e69a89b66b621571
cidrBlock: 10.11.0.0/16
region: US_EAST_1

The following example shows an AtlasNetworkContainer independent CRD that enables VPC peering under the same parameters enabled by the Basic Example. To enable independent operation, you must use an externalProjectRef instead of a projectRef, and you must supply a connectionSecret directly since this resource can't inherit API credentials from its parent project.

apiVersion: atlas.mongodb.com/v1
kind: AtlasNetworkContainer
metadata:
name: my-atlas-nc
spec:
externalProjectRef:
projectId: 66e2f2b621571b7e69a89b66
connectionSecret:
name: atlas-connection-secret
provider: AWS
id: 66e2f2b7e69a89b66b621571
cidrBlock: 10.11.0.0/16
region: US_EAST_1

本部分介绍此自定义资源定义中可用的 AtlasNetworkContainer 参数。

metadata.name

类型:字符串

必需

Name that the AtlasNetworkContainer Custom Resource uses to add this network container to a project.

metadata.namespace

类型:字符串

Optional

要包含 atlasNetworkContainer 自定义资源的命名空间。如果未指定, Atlas Kubernetes Operator将使用 kubectl设立的当前命名空间。

spec.connectionSecret.name

类型:字符串

可选的

不透明密钥的名称,其中包含Atlas Kubernetes Operator用于连接到Atlas 的组织ID和API密钥。如果未指定, Atlas Kubernetes Operator默认为以下选项之一:

  • 父级 atlasProject 的 spec.connectionSecretRef.name 参数

  • 默认的global 密钥(如果您尚未为父项 atlasProject 定义 spec.connectionSecretRef.name)

对于独立的 CRD,此参数是必需的。

Atlas Kubernetes Operator 仅监视带有标签 atlas.mongodb.com/type=credentials 的密钥,以避免监视不必要的密钥。

以下示例标记了密钥:

kubectl label secret the-user-password atlas.mongodb.com/type=credentials
spec.externalProjectRef.id

类型:字符串

可选的

网络容器所属项目的ID 。您必须指定现有Atlas项目的项目ID 。您必须为属于以下任一机构托管的项目的网络容器指定此参数:

  • Atlas Kubernetes Operator的不同实例

  • Atlas Kubernetes Operator以外的工具

对于属于同一Atlas Kubernetes Operator实例托管的项目的部署,请使用 spec.projectRef.name。这些参数是互斥的。

spec.projectRef.name

类型:字符串

可选的

网络容器所属项目的名称。您必须指定现有的 AtlasProject 自定义资源。此参数仅适用于属于由同一实例Atlas Kubernetes Operator托管的项目的网络容器。

对于属于以下任一机构托管的项目的网络容器:

  • Atlas Kubernetes Operator的不同实例

  • Atlas Kubernetes Operator以外的工具

使用 spec.externalProjectRef.id。这些参数是互斥的。

spec.projectRef.namespace

类型:字符串

可选的

AtlasProject中指定的spec.projectRef.name 自定义资源所在的命名空间。

请勿为属于以下任一机构托管的项目的部署设立此参数:

  • Atlas Kubernetes Operator的不同实例

  • Atlas Kubernetes Operator以外的工具

spec.provider

类型:字符串

必需

支持VPC对等连接的云提供商。必须是以下之一:

  • AWS

  • Azure

  • GCP

spec.id

类型:字符串

可选的

Atlas中现有网络容器的唯一标识符。对于Atlas Kubernetes Operator管理预先存在的网络对等互连容器的场景,此参数是必需的,且仅限于此。

spec.cidrBlock

类型:字符串

必需

Atlas网络容器的 CIDR区块。

spec.region

类型:字符串

可选的

用于托管网络容器的Atlas地区。必须符合托管区域的Atlas格式。对于Amazon Web Services和Azure网络容器,此参数是必需的且仅限于此。