重要
レガシー サブリソースは、対応する CRD のリリース時点で非推奨となります。構成が現在、このリソース定義のサブリソース形式に依存している場合は、CRD に移行します。
AtlasNetworkPeeringカスタムリソースは、 Atlasプロジェクトのネットワークピアリング接続を定義します。ネットワーク ピアリング接続は、セキュリティを強化するためにパブリック ネットワークのトラフィックを分離します。
重要
カスタム リソースはデフォルトでオブジェクトを削除しなくなりました
Atlas Kubernetes Operator はカスタムリソース構成ファイルを使用して Atlas 構成を管理しますが、Atlas Kubernetes Operator2.0 以降、 Kubernetesで削除したカスタム リソースは Atlas で削除されなくなりました(デフォルトでは )。代わりに、Atlas Kubernetes Operator は Atlas 内のそれらのリソースの管理を停止します。 例、 Kubernetesで カスタム リソースを削除すると、デフォルトでは、Atlas Kubernetes Operator は Atlas
AtlasProjectから対応するプロジェクトを自動的に削除しなくなります。この動作の変更は、誤ってまたは予期せずに削除されるのを防ぐことを目的としています。 この動作を Atlas Kubernetes Operator. 以前に使用されていたデフォルトに戻す方法などの詳細については、「2 0新しいデフォルト: Atlas Kubernetes Operator. の削除保護2 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:
新しいネットワークピアリング接続を作成します。
既存のネットワークピアリング接続を更新します。
注意
ネットワークピアリング接続は1 つのプロジェクトにのみ属することができます。複数のプロジェクトで同じネットワークピアリング接続を定義するには、プロジェクトごとにカスタムリソース定義 を作成します。
例
次の例は、AtlasNetworkPeering CRD の構成を示しています。
基本的な例では、親の Atlasプロジェクトを管理するのと同じ Atlas Kubernetes Operatorインスタンスで管理するリソースを定義します。
Independent CRD 例では、基本的な例と同じ `VPC` ピアリング接続を設定します。ただし、これは `VPC` ピアリング接続を管理する Atlas Kubernetes Operator インスタンスの外部で管理する Atlas プロジェクトが対象となります。
基本的な例
次の例は、my-project プロジェクトの VPC とお客様の Amazon Web Services VPC 間の green-leaf-peering 接続を定義する AtlasNetworkPeering カスタム リソースを示しています。親プロジェクトと同じ Atlas Kubernetes Operator インスタンス内でこのリソースを管理するには、プロジェクトを externalProjectRef ではなく projectRef を使用して識別する必要があります。
apiVersion: atlas.mongodb.com/v1 kind: AtlasNetworkPeering metadata: name: green-leaf-peering spec: projectRef: name: my-project namespace: my-operator-namespace containerRef: id: 72a6d2a69388ba121943ae27 id: 72a6d2a69388ba121943ae27 provider: AWS awsConfiguration: accepterRegionName: us-east-1 awsAccountId: 389226183042 routeTableCiderBlock: 10.0.0.0/21 vpcId: vpc-abc
独立した CRD の例
The following example shows an AtlasNetworkPeering independent CRD that configures the same VPC peering connection defined by the Basic Example. To enable resource management independent of the parent project, 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: AtlasNetworkPeering metadata: name: green-leaf-peering spec: externalProjectRef: projectId: 66e2f2b621571b7e69a89b66 connectionSecret: name: atlas-connection-secret containerRef: id: 72a6d2a69388ba121943ae27 id: 72a6d2a69388ba121943ae27 provider: AWS awsConfiguration: accepterRegionName: us-east-1 awsAccountId: 389226183042 routeTableCiderBlock: 10.0.0.0/21 vpcId: vpc-abc
パラメーター
このセクションでは、このカスタムリソース定義で使用できる AtlasNetworkPeering パラメータについて説明します。
metadata.name型: string
必須
Name that the
AtlasNetworkPeeringCustom Resource uses to add this network peering connection to a project.
metadata.namespace型: string
任意
atlasNetworkPeeringカスタムリソースを含める名前空間。指定されていない場合、Atlas Kubernetes Operator はkubectlによって設定された現在の名前空間を使用します。
spec.connectionSecret.name型: string
条件付き
Atlas Kubernetes Operator が Atlas に接続するために使用する組織IDとAPIキーを含む opaque secret の名前。指定しない場合、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.containerRef.id型: string
条件付き
このリソースが新しいネットワークピアリング接続を表す場合は、このパラメーターを省略します。
既存のネットワーク ピアリングコンテナのID 。このリソースをAtlas Kubernetes Operator 内で既存のネットワークピアリング接続を管理する場合にのみ、このフィールドを指定します。このリソースでKubernetesローカルリソースの管理を開始する場合は、
spec.containerRef.nameパラメータを使用します。
spec.containerRef.name型: string
条件付き
プロジェクトの名前空間内でKubernetesローカルリソースを使用して管理する既存のネットワーク ピアリングコンテナの名前。このリソースをKubernetesローカルリソースを管理する場合にのみ、このフィールドを指定します。Atlas Kubernetes Operator によってすでに管理されているネットワークピアリング接続のこのリソースの管理を開始する場合は、
spec.containerRef.idパラメータを使用します。このリソースが新しいネットワークピアリング接続を表す場合は、このフィールドを省略します。
spec.externalProjectRef.id型: string
条件付き
ネットワークピアリング接続が属するプロジェクトのID 。既存の Atlas プロジェクト のプロジェクトIDを指定する必要があります。このパラメーターは、次のいずれかによって管理されるプロジェクトに属するネットワークピアリング接続に指定する必要があります。
Atlas Kubernetes Operator の別のインスタンス
Atlas Kubernetes Operator 以外のツール
Atlas Kubernetes Operator の同じインスタンスによって管理されるプロジェクトに属する配置の場合は、
spec.projectRef.nameを使用します。これらのパラメーターは相互に排他的です。ネットワークピアリング接続は1 つのプロジェクトにのみ属することができます。複数のプロジェクトで同じネットワークピアリング接続を定義するには、プロジェクトごとにカスタムリソース定義 を作成します。
spec.projectRef.name型: string
条件付き
ネットワークピアリング接続が属するプロジェクトの名前。既存の
AtlasProjectカスタム リソース を指定する必要があります。このパラメーターは、同じインスタンスAtlas Kubernetes Operator によって管理されるプロジェクトに属するネットワークピアリング接続にのみ適用されます。次のいずれかによって管理されるプロジェクトに属する配置の場合、次のいずれかによって管理されます。
Atlas Kubernetes Operator の別のインスタンス
Atlas Kubernetes Operator 以外のツール
spec.externalProjectRef.idを使用するこれらのパラメーターは相互に排他的です。ネットワークピアリング接続は1 つのプロジェクトにのみ属することができます。複数のプロジェクトで同じネットワークピアリング接続を定義するには、プロジェクトごとにカスタムリソース定義 を作成します。
spec.projectRef.namespace型: string
条件付き
で指定された
AtlasProjectカスタムspec.projectRef.nameリソースが存在する名前空間。次のいずれかによって管理されるプロジェクトに属する配置では、このパラメーターを設定しないでください。
Atlas Kubernetes Operator の別のインスタンス
Atlas Kubernetes Operator 以外のツール
spec.id型: string
条件付き
Atlas 内の既存のネットワークピアリング接続の一意の識別子です。このパラメータは、Atlas Kubernetes Operator が 既存のネットワークピアリング接続の管理を想定するシナリオに必要であり、これらに限定されます。
spec.awsConfiguration.accepterRegionName型: string
条件付き
VPCピアリング接続を確立するAmazon Web Services のリージョン。に必要であり、Amazon Web Services接続に限定されます。
spec.awsConfiguration.awsAccountId型: string
条件付き
接続が属するAmazon Web Servicesアカウントの一意の識別子です。に必要であり、Amazon Web Services接続に限定されます。
spec.awsConfiguration.routeTableCidrBlock型: string
条件付き
Amazon Web Services VPCの CIDR ブロック。に必要であり、Amazon Web Services接続に限定されます。
spec.awsConfiguration.vpcId型: string
条件付き
Amazon Web Services VPCの一意の識別子です。に必要であり、Amazon Web Services接続に限定されます。
spec.azureConfiguration.azureDirectoryId型: string
条件付き
Azureディレクトリの一意な識別子です。Azure 接続に必要であり、 Azure接続に限定されます。
spec.azureConfiguration.azureSubscriptionId型: string
条件付き
Azureサブスクライブの一意の識別子です。Azure 接続に必要であり、 Azure接続に限定されます。
spec.azureConfiguration.resourceGroupName型: string
条件付き
接続が属するAzureリソース グループの名前。Azure 接続に必要であり、 Azure接続に限定されます。
spec.azureConfiguration.vNetName型: string
条件付き
Azure Virtual Network の名前です。Azure 接続に必要であり、 Azure接続に限定されます。