AtlasNetworkContainer
カスタム リソース
AtlasNetworkContainer
カスタムリソースは、Atlasプロジェクトの ネットワークコンテナを定義します。ネットワーク コンテナとアプリケーションをホストしているネットワーク間で VPCピアリング接続を作成します。
重要
カスタム リソースはデフォルトでオブジェクトを削除しなくなりました
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 は、Atlas ネットワークピアリングAPIリソースを使用して次のいずれかのアクションを実行します。
新しいネットワークコンテナを作成します。
既存のネットワークコンテナをアップデートします。
例
次の例は、AtlasNetworkContainer
CRD の構成を示しています。
基本的な例では、親の Atlasプロジェクトを管理するのと同じ Atlas Kubernetes Operatorインスタンスで管理するリソースを定義します。
この 独立性 CRD の例では、 基本的な例と同じネットワークコンテナを構成しますが、ネットワークコンテナの管理に使用する Atlas Kubernetes Operatorインスタンスの外部で管理する Atlasプロジェクト用に構成されています。
基本的な例
以下は、AtlasNetworkContainer
という名前のコンテナのmy-atlas-nc
カスタムリソースを示しており、my-project
プロジェクト内で Atlas と Amazon Web Services の間の VPC ピアリング接続を作成できます。このリソースを、親 Atlasプロジェクトと同じ Atlas Kubernetes Operatorインスタンスで管理するには、externalProjectRef
ではなく projectRef
を使用してプロジェクトを識別する必要があります。
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
独立した CRD の例
次の例は、 基本的な例AtlasNetworkContainer
で有効になっているのと同じパラメータでVPCピアリングを有効にする 独立した CRD を示しています。独立した操作を有効にするには、projectRef
ではなく externalProjectRef
を使用する必要があります。また、このリソースは親プロジェクトからAPI認証情報を継承できないため、connectionSecret
を直接指定する必要があります。
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
型: string
必須
AtlasNetworkContainer
カスタム リソースがこのネットワークコンテナをプロジェクトに追加するために使用する名前。
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.externalProjectRef.id
型: string
条件付き
ネットワークコンテナが属するプロジェクトのID 。既存の Atlas プロジェクト のプロジェクトIDを指定する必要があります。次のいずれかによって管理されるプロジェクトに属するネットワーク コンテナには、このパラメーターを指定する必要があります。
Atlas Kubernetes Operator の別のインスタンス
Atlas Kubernetes Operator 以外のツール
Atlas Kubernetes Operator の同じインスタンスによって管理されるプロジェクトに属する配置の場合は、
spec.projectRef.name
を使用します。これらのパラメーターは相互に排他的です。
spec.projectRef.name
型: string
条件付き
ネットワークコンテナが属するプロジェクトの名前。既存の
AtlasProject
カスタム リソース を指定する必要があります。このパラメーターは、同じインスタンスAtlas Kubernetes Operator によって管理されるプロジェクトに属するネットワーク コンテナにのみ適用されます。によって管理されるプロジェクトに属するネットワーク コンテナの場合、次のいずれかによって管理されます。
Atlas Kubernetes Operator の別のインスタンス
Atlas Kubernetes Operator 以外のツール
spec.externalProjectRef.id
を使用するこれらのパラメーターは相互に排他的です。
spec.projectRef.namespace
型: string
条件付き
で指定された
AtlasProject
カスタムspec.projectRef.name
リソースが存在する名前空間。次のいずれかによって管理されるプロジェクトに属する配置では、このパラメーターを設定しないでください。
Atlas Kubernetes Operator の別のインスタンス
Atlas Kubernetes Operator 以外のツール