サーバーレスインスタンスのプライベートエンドポイントの管理

Atlas Kubernetes Operator は、次のプラットフォーム上のサーバーレスインスタンスのプライベートエンドポイントの管理をサポートしています。

AWS PrivateLink 機能を使用するAmazon Web Services
Azure は Azure Private Link 機能を使用しています。

注意

サーバーレスインスタンスは Private Service Connect をサポートしていません。 Private Service Connect を設定する必要がある場合は、専有クラスターを使用してください。

MongoDB は、サーバーレスインスタンスでサポートされる構成と機能を徐々に増やしていく予定です。MongoDB が将来、サーバーレスインスタンスでサポートする予定の機能については、「サーバーレスインスタンスの制限（非推奨）」を参照してください。

開始する前に、プライベートエンドポイントの管理を参照してください。

手順

クライアントがプライベートエンドポイントを使用して Atlas サーバーレスインスタンスに接続できるようにするには、次の手順に従います。

`spec.serverlessSpec.privateEndpoints`パラメータを指定します。

spec.serverlessSpec.privateEndpointsAtlasDeploymentカスタムリソースのパラメータを指定します。spec.serverlessSpec.privateEndpoints.nameフィールドに、プライベートエンドポイントを識別するための一意のラベルを指定し、次のコマンドを実行します。

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: atlas-deployment-serverless
spec:
  projectRef:
    name: my-project
  serverlessSpec:
    name: serverless-instance
    tags:
    - key: "environment"
      value: "production"
    providerSettings:
      providerName: SERVERLESS
      backingProviderName: AWS
      regionName: US_EAST_1
    privateEndpoints:
    - name: "{unique-private-endpoint-label}"
EOF

Atlas はVPCリソースを作成します。これが完了するまでに数分かかる場合があります。

プライベートエンドポイントのサービス名を見つけます。

次のコマンドを実行します:
```
kubectl get atlasdeployment atlas-deployment-serverless -o yaml
```
AtlasDeploymentカスタムリソースの stringフィールド内の各プライベートエンドポイントのサービス名のに注目してください。status.serverlessPrivateEndpoints.EndpointServiceName

Amazon Web Services CLIを使用して、各プライベートエンドポイントを設定します。

アプリケーションVPCインターフェイスエンドポイントを作成するには、次の手順に従います。

次のコマンドをコピーします。
```
aws ec2 create-vpc-endpoint --vpc-id {your-application-vpc-id} --region {aws-region} --service-name {service-name-string} --vpc-endpoint-type Interface --subnet-ids {your-application-subnet-ids}
```

次のプレースホルダーをAmazon Web Services VPCの詳細に置き換えます。

`your-application-vpc-id`	ピア AWS VPCを識別する一意の文字列。この値は、AWS アカウントの VPC ダッシュボードで確認できます。
`aws-region`	プライベートエンドポイントのAmazon Web Servicesリージョンを識別するラベル。
`service-name-string`	プライベートエンドポイントのサービス名を識別する一意のstring 。この値は、 `AtlasDeployment`カスタムリソースの`status.serverlessPrivateEndpoints.EndpointServiceName`フィールド内で見つけます。
`your-application-subnet-ids`	Amazon Web Services VPCが使用するサブネットを識別する一意の文字列。各サブネットはスペースで区切ります。これらの値は、アカウントの {4Subnet Amazon Web Servicesダッシュボードで確認できます。重要:少なくとも 1 つのサブネットを指定する必要があります。そうしないと、Amazon Web Services はにVPC インターフェイスエンドポイントをプロビジョニングしません。VPC内のクライアントがプライベートエンドポイントにトラフィックを送信するには、インターフェイスエンドポイントが必要です。

Amazon Web Services CLI でコマンドを実行します。

出力のVpcEndpointId値に注目してください。

例

"VpcEndpoint": {
         "VpcEndpointId": "vpce-XXXXXX",
         "VpcEndpointType": "Interface",
         "VpcId": "vpc-XXXXX",
         "ServiceName": "com.amazonaws.vpce.{aws-region}.vpce-svc-XXXX",
         "State": "pendingAcceptance",

詳細については、 Amazon Web Servicesドキュメントの「インターフェイスエンドポイントの作成」を参照してください。

`spec.serverlessSpec.privateEndpoints`パラメータを更新します。

spec.serverlessSpec.privateEndpointsAtlasDeploymentカスタムリソースのパラメータを更新します。プライベートエンドポイントのvpce-idをVpcEndpointIdの値に置き換え、次のコマンドを実行します。

注意

ピアの一意の識別子は、Amazon Web ServicesVPC アカウントのVPC Amazon Web Servicesダッシュボードで確認できます。

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: atlas-deployment-serverless
spec:
  projectRef:
    name: my-project
  serverlessSpec:
    name: serverless-instance
    tags:
    - key: "environment"
      value: "production"
    providerSettings:
      providerName: SERVERLESS
      backingProviderName: AWS
      regionName: US_EAST_1
    privateEndpoints:
    - name: "{unique-private-endpoint-label}"
      cloudProviderEndpointID: "{vpce-id}"
EOF

Atlas Kubernetes Operator を使用してプライベートエンドポイントのステータスを確認します。

次のコマンドを実行します:

kubectl get atlasdeployment atlas-deployment-serverless -o yaml

Atlas Kubernetes Operator がクラスターに接続するために作成したシークレットを取得します。

次のコマンドをコピーします。
重要
次のコマンドにはjq 1.6 以上が必要です。
```
kubectl get secret {my-project}-{my-atlas-cluster}-{my-database-user} -o json | jq -r '.data | with_entries(.value |= @base64d)';
```

次のプレースホルダーをカスタムリソースの詳細に置き換えます。

`my-project`	`AtlasProject`カスタムリソースの`metadata`フィールドの値を指定します。
`my-atlas-cluster`	`AtlasDeployment`カスタムリソースの`metadata`フィールドの値を指定します。
`my-database-user`	`AtlasDatabaseUser`カスタムリソースの`metadata`フィールドの値を指定します。

コマンドを実行します。

注意

接続文字列は次の例とは異なります。複数のプライベートエンドポイントがある場合、シークレットには適切な数値サフィックスを持つ複数のconnectionStringPrivate フィールドとconnectionStringPrivateSvr フィールドが含まれます（例:connectionStringPrivate1 、connectionStringPrivate2 など）。

{
  "connectionStringPrivate": "mongodb://pl-0-eastus2.uzgh6.mongodb.net:1024,pl-0-eastus2.uzgh6.mongodb.net:1025,pl-0-eastus2.uzgh6.mongodb.net:1026/?ssl=truereplicaSet=atlas-18bndf-shard-0",
  "connectionStringPrivateSrv": "mongodb+srv://cluster0-pl-0.uzgh6.mongodb.net",
  "password": "P@@sword%",
  "username": "theuser"
 }

このシークレットはアプリケーションで使用できます。

containers:
  - name: test-app
    env:
    - name: "CONNECTION_STRING"
      valueFrom:
        secretKeyRef:
          name: my-project-my-atlas-cluster-my-database-user
          key: connectionStringPrivate

`spec.serverlessSpec.privateEndpoints`パラメータを指定します。

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: atlas-deployment-serverless
spec:
  projectRef:
    name: my-project
  serverlessSpec:
    name: serverless-instance
    tags:
    - key: "environment"
      value: "production"
    providerSettings:
      providerName: SERVERLESS
      backingProviderName: AWS
      regionName: US_EAST_1
    privateEndpoints:
    - name: "{unique-private-endpoint-label}"
EOF

Atlas は VNET リソースを作成します。これが完了するまでに数分かかる場合があります。

プライベートエンドポイントネットワークポリシーを無効にします。

Atlas はプライベートエンドポイントのネットワークポリシーをサポートしていません。

次のコマンドをコピーします。
```
az network vnet subnet update --resource-group {resource-group-name} --vnet-name {vnet-name} --name {subnet-name} --disable-private-endpoint-network-policies true
```

次のプレースホルダーをAzure VNet の詳細で置き換えます。

`resource-group-name`	Atlas への接続に使用する VNet を含むリソースグループの、人間が判読可能なラベル。この値は、 AzureダッシュボードのResource Group Propertiesページで確認できます。
`vnet-name`	Atlas への接続に使用する VNet を識別する、人間が判読可能なラベル。この値は、 AzureダッシュボードのVirtual Networkページで確認できます。
`subnet-name`	Azure VNet 内のサブネットを識別する、人間が判読できるラベル。この値は、 AzureダッシュボードのVirtual Network Subnetsページで確認できます。

Azure CLI でコマンドを実行します。

詳細については、 Azure ドキュメントのプライベートエンドポイントのネットワークポリシーの管理を参照してください。

プライベートエンドポイントのサービス ID と名前を見つけます。

次のコマンドを実行します:
```
kubectl get atlasdeployment atlas-deployment-serverless -o yaml
```
カスタムAtlasDeployment リソースのフィールドとフィールド内の各プライベートエンドポイントのサービスリソース ID とサービス名をメモします。status.serverlessPrivateEndpoints.PrivateLinkServiceResourceIdstatus.serverlessPrivateEndpoints.EndpointServiceName

Azure CLI を使用して、各プライベートエンドポイントを構成します。

プライベートエンドポイントを作成するには、次の手順に従います。

次のコマンドをコピーします。

az network private-endpoint create --resource-group {resource-group-name} --name {endpoint-name} --vnet-name {vnet-name} --subnet {subnet-name} --private-connection-resource-id {serviceResourceId} --connection-name {serviceName} --manual-request true

次のプレースホルダーをAzure VNet の詳細で置き換えます。

`resource-group-name`	Atlas への接続に使用する VNet を含むリソースグループの、人間が判読可能なラベル。この値は、 AzureダッシュボードのResource Group Propertiesページで確認できます。
`endpoint-name`	プライベートエンドポイントを識別する、人間が判読可能なラベル。これをここで指定します。
`vnet-name`	Atlas への接続に使用する VNet を識別する、人間が判読可能なラベル。この値は、 AzureダッシュボードのVirtual Networkページで確認できます。
`subnet-name`	Azure VNet 内のサブネットを識別する、人間が判読できるラベル。この値は、 AzureダッシュボードのVirtual Network Subnetsページで確認できます。
`serviceResourceId`	プライベートエンドポイントのサービスリソースを識別する一意のstring 。この値は、 `AtlasDeployment`カスタムリソースの`status.serverlessPrivateEndpoints.PrivateLinkServiceResourceId`フィールド内で見つけます。
`serviceName`	プライベートエンドポイントのサービス名を識別する一意のstring 。この値は、 `AtlasDeployment`カスタムリソースの`status.serverlessPrivateEndpoints.EndpointServiceName`フィールド内で見つけます。

Azure CLI でコマンドを実行します。

`spec.serverlessPrivateEndpoints`パラメータを更新します。

spec.serverlessSpec.privateEndpointsAtlasDeploymentカスタムリソースのパラメータを更新します。プライベートエンドポイントのリソース ID と IP アドレス情報を指定し、次のコマンドを実行します。

注意

AzureダッシュボードのPropertiesページには、 Resource IDフィールドで作成したプライベートエンドポイントの一意の識別子が表示されます。

AzureダッシュボードのOverviewページには、 Private IPフィールドに作成したプライベートエンドポイントネットワークインターフェイスのプライベート IP アドレスが表示されます。

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: atlas-deployment-serverless
spec:
  projectRef:
    name: my-project
  serverlessSpec:
    name: serverless-instance
    tags:
    - key: "environment"
      value: "production"
    providerSettings:
      providerName: SERVERLESS
      backingProviderName: AWS
      regionName: US_EAST_1
    privateEndpoints:
    - name: "{unique-private-endpoint-label}"
      cloudProviderEndpointID: "{resource-id}"
      privateEndpointIpAddress: "{private-ip}"
EOF

Atlas Kubernetes Operator を使用してプライベートエンドポイントのステータスを確認します。

次のコマンドを実行します:

kubectl get atlasdeployment atlas-deployment-serverless -o yaml

Atlas Kubernetes Operator がクラスターに接続するために作成したシークレットを取得します。

次のコマンドをコピーします。
重要
次のコマンドにはjq 1.6 以上が必要です。
```
kubectl get secret {my-project}-{my-atlas-cluster}-{my-database-user} -o json | jq -r '.data | with_entries(.value |= @base64d)';
```

次のプレースホルダーをカスタムリソースの詳細に置き換えます。

`my-project`	`AtlasProject`カスタムリソースの`metadata`フィールドの値を指定します。
`my-atlas-cluster`	`AtlasDeployment`カスタムリソースの`metadata`フィールドの値を指定します。
`my-database-user`	`AtlasDatabaseUser`カスタムリソースの`metadata`フィールドの値を指定します。

コマンドを実行します。

注意

{
  "connectionStringPrivate": "mongodb://pl-0-eastus2.uzgh6.mongodb.net:1024,pl-0-eastus2.uzgh6.mongodb.net:1025,pl-0-eastus2.uzgh6.mongodb.net:1026/?ssl=truereplicaSet=atlas-18bndf-shard-0",
  "connectionStringPrivateSrv": "mongodb+srv://cluster0-pl-0.uzgh6.mongodb.net",
  "password": "P@@sword%",
  "username": "theuser"
 }

このシークレットはアプリケーションで使用できます。

containers:
  - name: test-app
    env:
    - name: "CONNECTION_STRING"
      valueFrom:
        secretKeyRef:
          name: my-project-my-atlas-cluster-my-database-user
          key: connectionStringPrivate

戻る

専用

フェデレーティッド

注意

手順

プライベートエンドポイントのサービス名を見つけます。

Amazon Web Services CLIを使用して、各プライベートエンドポイントを設定します。

spec.serverlessSpec.privateEndpointsパラメータを更新します。

注意

Atlas Kubernetes Operator を使用してプライベートエンドポイントのステータスを確認します。

Atlas Kubernetes Operator がクラスターに接続するために作成したシークレットを取得します。

重要

注意

spec.serverlessSpec.privateEndpointsパラメータを指定します。

プライベートエンドポイント ネットワーク ポリシーを無効にします。

プライベートエンドポイントのサービス ID と名前を見つけます。

Azure CLI を使用して、各プライベートエンドポイントを構成します。

spec.serverlessPrivateEndpointsパラメータを更新します。

注意

Atlas Kubernetes Operator を使用してプライベートエンドポイントのステータスを確認します。

Atlas Kubernetes Operator がクラスターに接続するために作成したシークレットを取得します。

重要

注意

`spec.serverlessSpec.privateEndpoints`パラメータを更新します。

`spec.serverlessSpec.privateEndpoints`パラメータを指定します。

プライベートエンドポイントネットワークポリシーを無効にします。

`spec.serverlessPrivateEndpoints`パラメータを更新します。