/ /

`AtlasIPAccessList` 自定义资源

重要

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

The AtlasIPAccessList custom resource configures an IP access list for an Atlas project. An IP access list allows you to secure your project using a minimum-access policy. Each Atlas project supports at most one AtlasIPAccessList resource. If you define multiple AtlasIPAccessList resources for the same project, they conflict with one another.

重要

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

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使用Atlas项目IP访问列表API资源执行以下操作之一：

创建新的IP访问列表。
替换现有的IP访问列表。

示例

基本示例

以下示例显示了一个 AtlasIPAccessList 自定义资源，该资源允许从以下来源访问权限my-project项目：

cidrBlock 192.168.1.0/24
IP 地址 10.0.0.1
awsSecurityGroup

10.0.0.1 的访问权限将在 2025 3 月 31 日后过期。

apiVersion: atlas.mongodb.com/v1
kind: AtlasIPAccessList
metadata:
  name: atlasipaccesslist-sample
spec:
  projectRef:
    name: my-project
    namespace: my-operator-namespace
  entries:
    - cidrBlock: 192.168.1.0/24
    - ipAddress: 10.0.0.1
      deleteAfterDate: 2025-03-31T23:59:59+02:00
    - awsSecurityGroup: sg-1234
      comment: "AWS Access to my network peering"

独立 CRD 示例

The following example shows an AtlasIPAccessList independent CRD that permits access from the same CIDR block and IP address permitted by the Basic Example. This custom resource definition allows you to create an IP access list in a project you manage outside the instance of Atlas Kubernetes Operator with which you define this resource. 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: AtlasIPAccessList
metadata:
  name: atlasipaccesslist-sample
spec:
  externalProjectRef:
    projectId: 66e2f2b621571b7e69a89b66
  connectionSecret:
    name: atlas-connection-secret
  entries:
    - cidrBlock: 192.168.1.0/24
    - ipAddress: 10.0.0.1
      deleteAfterDate: 2025-03-31T23:59:59+02:00
    - awsSecurityGroup: sg-1234
      comment: "AWS Access to my network peering"

参数

AtlasIPAccessList

AtlasIPAccessList 是 atlasipaccesslists API的模式。

`Name`	类型	说明	必需
`apiVersion`	字符串	atlas.mongodb.com/v1	true
`kind`	字符串	`AtlasIPAccessList`	true
`metadata`	对象	有关 `metadata` 字段的字段，请参阅 Kubernetes `API` 文档。	true
`spec`	对象	`AtlasIPAccessListSpec` 定义了 `AtlasIPAccessList` 的目标状态。验证: (has(self.``externalProjectRef``)&& !has(self.``projectRef``))\|\| (!has(self.``externalProjectRef``)&& has(self.``projectRef``)):只能通过 `externalProjectRef` 或 `projectRef` 定义一个项目引用 (has(self.``externalProjectRef``)&& has(self.``connectionSecret``))\|\| !has(self.``externalProjectRef``):引用外部项目时必须定义本地连接密钥	false
`status`	对象	`AtlasIPAccessListStatus` 是 `AtlasIPAccessList`集群中最近观察到的 `status`。只读。	false

AtlasIPAccessList.spec

AtlasIPAccessListSpec 定义 AtlasIPAccessList 的目标省/市/自治区。

`Name`	类型	说明	必需
`entries`	[]对象	Entries 是要托管的`IP` Access（访问权限）列表。	true
`connectionSecret`	对象	包含Atlas `API` 私钥和公钥的密钥名称。	false
`externalProjectRef`	对象	`externalProjectRef` 包含父Atlas项目`ID`。与“`projectRef`”字段互斥。	false
`projectRef`	对象	`projectRef` 是对父 `AtlasProject`资源的引用。与“`externalProjectRef`”字段互斥。	false

AtlasIPAccessList.spec.entries

`Name`	类型	说明	必需
`awsSecurityGroup`	字符串	此访问权限列表条目中 `AWS` 安全群组的唯一标识符。	false
`cidrBlock`	字符串	此访问权限列表条目中采用 `CIDR` 表示法的 `IP` 地址范围。	false
`comment`	字符串	与此访问权限列表条目关联的注释。	false
`deleteAfterDate`	字符串	Atlas删除临时访问权限列表条目的日期和时间。格式：日期-时间	false
`ipAddress`	字符串	在此访问权限列表条目中使用 `IP`解决的条目。	false

AtlasIPAccessList.spec.connectionSecret

包含Atlas API私钥和公钥的密钥名称。

`Name`	类型	说明	必需
`name`	字符串	所引用资源的名称更多信息：https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasIPAccessList.spec.externalProjectRef

externalProjectRef 保存父Atlas群组 ID（group ID）。与 "projectRef"字段互斥。

`Name`	类型	说明	必需
`id`	字符串	`ID` 是Atlas项目`ID`。	true

AtlasIPAccessList.spec.projectRef

projectRef 是对父 AtlasProject资源的引用。与 "externalProjectRef"字段互斥。

`Name`	类型	说明	必需
`name`	字符串	Kubernetes资源名称	true
`namespace`	字符串	Kubernetes资源的命名空间	false

AtlasIPAccessList.status

AtlasIPAccessListStatus 是最近观察到的 AtlasIPAccessList集群状态。只读。

`Name`	类型	说明	必需
`conditions`	[]对象	条件是显示Atlas自定义资源当前省/市/自治区的列表	true
`entries`	[]对象	Status 是 IP访问列表的省/市/自治区	false
`observedGeneration`	整型	`ObservedGeneration` 表示 Atlas 操作符感知的资源规范的生成。Atlas Operator 将此字段更新为“元数据.Generation ”的值一旦开始资源协调。格式：int64	false

AtlasIPAccessList.status.conditions

条件描述了Atlas自定义资源在某一点的省/市/自治区。

`Name`	类型	说明	必需
`status`	字符串	条件的状态； True、False、未知之一。	true
`type`	字符串	Atlas自定义资源条件的类型。	true
`lastTransitionTime`	字符串	上次条件从一种状态转换为另一种状态的时间。以 `ISO` 8601 格式表示。格式：日期-时间	false
`message`	字符串	提供有关转换的详细信息的 `message`。	false
`reason`	字符串	条件的最后一次转换的 `reason`。	false