托管无服务器实例的私有端点

Atlas Kubernetes Operator支持管理以下平台上无服务器实例的私有端点：

AWS 使用 AWS PrivateLink 功能。
Azure使用Azure Private Link功能。

注意

无服务器实例不支持“私有服务连接”。如果需要设置“私有服务连接”，请使用专用集群。

MongoDB计划逐步增加对无服务器实例的更多配置和功能的支持。要学习；了解MongoDB计划在未来支持无服务器实例的哪些功能，请参阅无服务器实例的限制（已弃用）。

开始之前，请参阅管理私有端点。

步骤

要使客户端能够使用私有端点连接到Atlas Serverless 实例，启用以下操作：

指定`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自定义资源的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`	标识私有端点服务名称的唯一字符串。在`AtlasDeployment`自定义资源的`status.serverlessPrivateEndpoints.EndpointServiceName`字段中找到此值。
`your-application-subnet-ids`	标识AWS VPC使用的子网的唯一字符串。用空格分隔每个子网。在您的Amazon Web Services帐户的 Subnet仪表盘上找到这些值。重要提示：您必须至少指定一个子网。否则，Amazon Web Services 将不会在您的中预配VPC 接口端点。VPC中的客户端需要接口端点才能向私有端点发送流量。

使用 AWS CLI运行命令。

请注意输出中的VpcEndpointId值。

例子

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

要学习；了解更多信息，请参阅 AWS 文档中的创建接口端点。

更新`spec.serverlessSpec.privateEndpoints` 参数。

更新spec.serverlessSpec.privateEndpoints AtlasDeployment自定义资源的参数。将vpce-id替换为私有端点的VpcEndpointId值，然后运行以下命令：

注意

您可以在 Amazon Web Services 账户的 VPC 仪表盘上找到对等互连 Amazon Web Services VPC 的唯一标识符。

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`字段的值。

运行命令。

注意

您的连接字符串将与以下示例不同。如果您有多个私有端点，则密钥包含多个带有相应数字后缀（例如connectionStringPrivate1 、 connectionStringPrivate2等）的connectionStringPrivate和connectionStringPrivateSvr字段。

{
  "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 自定义资源的status.serverlessPrivateEndpoints.PrivateLinkServiceResourceId和status.serverlessPrivateEndpoints.EndpointServiceName字段中每个私有端点的服务资源ID和服务名称。

使用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`	标识私有端点服务名称的唯一字符串。在`AtlasDeployment`自定义资源的`status.serverlessPrivateEndpoints.EndpointServiceName`字段中找到此值。

使用Azure CLI运行命令。

更新`spec.serverlessPrivateEndpoints` 参数。

更新spec.serverlessSpec.privateEndpoints AtlasDeployment自定义资源的参数。指定私有端点的资源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` 参数。