独立したカスタムリソース定義

You can use Atlas Kubernetes Operator to manage resources in an Atlas project without using Atlas Kubernetes Operator to manage the project itself. In this independent custom resource definition ("independent CRD") model, you associate resources such as AtlasDeployment Custom Resource and AtlasDatabaseUser Custom Resource with an Atlas project directly by its Atlas ID.

独立した CRD を使用すると、プロジェクトにさまざまなプログラムによるインフラストラクチャ管理システムを使用できますが、Atlas Kubernetes Operator を使用して、データベースユーザーや個別の配置など、より頻繁に変更されるリソースを管理できます。

独立した CRD によって、Atlasプロジェクトのマネジメントをユーザーや配置などのサブリソースのマネジメントから分離することで、ニーズに合わせて組織内の別の担当者やチームにこれらの権限を割り当てることができます。

Considerations

Atlas Kubernetes Operator を使用してプロジェクトを管理する場合、リソースのパラメータを使用して Atlas Administration API認証を構成するか、このパラメータを未設定のままにしてspec.connectionSecretRef.name atlasProjectグローバル Atlas 認証情報をデフォルトに設定できます。独立した CRD を使用する場合は、各リソースに対して spec.connectionSecret.name を指定できます。このパラメータを設定すると、spec.connectionSecretRef.name またはグローバル Atlas 認証情報よりも優先されます。

Setting this parameter is required for any resource whose parent resource is referenced using an Atlas project ID, and optional otherwise.

例

atlasProjectspec.name パラメータではなく、Atlas IDで親プロジェクトを参照する atlasDeployment CRD を定義します。次のように、 atlasDeploymentリソースの spec.connectSecret.name を定義する必要があります。

apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: test-cluster-name
  namespace: mongodb-atlas-system
spec:
  externalProjectRef:
    id: 671998971c8520583f24f411
  connectionSecret:
    name: my-atlas-key
  deploymentSpec:
    clusterType: REPLICASET
    name: service-name
    tags:
    - key: "environment"
      value: "production"
    backupEnabled: true
    replicationSpecs:
      - zoneName: US-Zone
        numShards: 3
        regionConfigs:
          - regionName: CENTRAL_US
            providerName: GCP
            backingProviderName: GCP
            priority: 7
            electableSpecs:
              instanceSize: M10
              nodeCount: 3

独立した CRD への移行

既存の CRD を atlasProject レベルのマネジメントから独立したマネジメントに移行するには、次の手順に従います。

プロジェクト調整を無効にし、サブリソース参照を編集する

親リソースの metadata に mongodb.com/atlas-reconciliation-policy: "skip" アノテーションを追加します。これにより、Atlas Kubernetes Operator が親リソースとそのサブリソースの調整を試みるのを防止します。次の点を考慮してください。

apiVersion: atlas.mongodb.com/v1
kind: AtlasProject
metadata:
 name: my-project
 annotations:
   mongodb.com/atlas-reconciliation-policy: "skip"
spec:
 name: Test project
 connectionSecretRef:
   name: my-atlas-key
 projectIpAccessList:
   - cidrBlock: "203.0.113.0/24"
     comment: "CIDR block for Application Server B - D"

警告

この注釈を適用しない場合、他のリソースを変更する際に、Atlas Kubernetes Operator は引き続き調整を試行します。新しいデフォルト: Atlas Kubernetes OperatorAtlas Kubernetes Operator2.0 の削除保護が無効になっているユーザーの場合、これにより、Atlas Kubernetes Operator リソースを削除するとAtlas atlasProjectAtlas Kubernetes Operator が Atlasプロジェクトを削除するか、アクティブなサブリソースを持つプロジェクトを削除しようとするとブロック状態になる可能性があります。データベースユーザーや配置など。

Modify the project reference to point to an Atlas project ID instead of an atlasProject name.

例、atlasDatabaseUserリソースを減算するには次のようにします。

apiVersion: atlas.mongodb.com/v1
kind: AtlasDatabaseUser
metadata:
 name: my-database-user
spec:
 roles:
   - roleName: readWriteAnyDatabase
     databaseName: admin
 externalProjectRef:
   id: 671998971c8520583f24f411
 username: theuser
 passwordSecretRef:
   name: the-user-password

Atlas Kubernetes Operator が新しいリソースステータスを同期するまで待ちます。

（条件付き）`atlasProject` CRD を削除します。

Atlas Kubernetes Operator によるプロジェクト管理を停止するには、atlasProject CRD を削除できるようになりました。Atlas Kubernetes Operator を使用してプロジェクトと接続されたサブリソースを引き続き管理する場合は、次の手順に進みます。

（条件付き）調整ポリシーの注釈を削除します

Atlas Kubernetes Operator を使用してプロジェクトを管理し続ける場合は、atlasProject 配下リソースがまだ存在する場合など、atlasProject CRD から調整ポリシー注釈を削除して調整を再度有効化します。

戻る

政府向け Atlas

互換性