The AtlasProject custom resource configures the project in
Atlas. When you create the AtlasProject custom resource,
Atlas Kubernetes Operator tries to create a new project in Atlas.
Important
Custom Resources No Longer Delete Objects by Default
Atlas Kubernetes Operator uses custom resource configuration files to manage your Atlas configuration, but as of Atlas Kubernetes Operator 2.0, custom resources you delete in Kubernetes are no longer (by default) deleted in Atlas. Instead, Atlas Kubernetes Operator simply stops managing those resources in Atlas. For example, if you delete an
AtlasProjectCustom Resource in Kubernetes, by default the Atlas Kubernetes Operator no longer automatically deletes the corresponding project from Atlas. This change in behavior is intended to help prevent accidental or unexpected deletions. To learn more, including how to revert this behavior to the default used prior to Atlas Kubernetes Operator 2.0, see New Default: Deletion Protection in Atlas Kubernetes Operator 2.0.Similarly, Atlas Kubernetes Operator does not delete teams from Atlas if you remove them from an Atlas project in Kubernetes with the Atlas Kubernetes Operator.
Explicitly define your desired configuration details in order to avoid implicitly using default Atlas configuration values. In some cases, inheriting Atlas defaults may result in a reconciliation loop which can prevent your custom resource from achieving a
READYstate. For example, explicitly defining your desired autoscaling behavior in yourAtlasDeploymentcustom resource, as shown in the included example, ensures that a static instance size in your custom resource is not being repeatedly applied to an Atlas deployment which has autoscaling enabled.autoScaling: diskGB: enabled: true compute: enabled: true scaleDownEnabled: true minInstanceSize: M30 maxInstanceSize: M40
Atlas Kubernetes Operator does one of the following actions:
Creates a new project in the organization that the connection secret configures.
Reuses an existing project. In this case, Atlas Kubernetes Operator verifies whether a project with
spec.nameexists. If the project exists, Atlas Kubernetes Operator skips creation. After the reconciliation, Atlas Kubernetes Operator updates thestatus.idfield with the id of the project.
You can use the spec.connectionSecretRef.name parameter
to set the connection secret for the AtlasProject custom
resource. This parameter overrides the default global connection
secret.
By default, Atlas Kubernetes Operator keeps connection secrets in the same namespace
as the AtlasProject Custom Resource. To store
secrets in another namespace, specify the
spec.connectionSecretRef.namespace parameter.
To connect to the Atlas Administration API, Atlas Kubernetes Operator reads the organization ID and API keys from Atlas Kubernetes Operator secrets.
You can also edit the AtlasProject custom resource specification to
configure the following options:
An IP access list with the spec.projectIpAccessList parameter. This IP access list grants network access to Atlas clusters in the project.
Teams with the spec.teams parameter. A team lets you grant an access role to an entire group of Atlas users for a particular project.
The maintenance window with the spec.maintenanceWindow parameter. The maintenance window sets the hour and day that Atlas starts weekly maintenance on your database deployments.
Network peering with the spec.networkPeers parameter. Network peering allows you to connect securely to your AWS, Azure, or Google Cloud VPC.
Encryption at rest using customer-managed keys with the spec.encryptionAtRest parameter. Encryption at rest using customer-managed keys allows you to add an additional layer of security by using your cloud provider's KMS together with the MongoDB encrypted storage engine.
Private endpoints with the spec.privateEndpoints parameter.
X.509 authentication with the spec.x509CertRef.name parameter.
Project settings with the spec.settings parameter, including settings to enable and disable the following:
Collection of database statistics in cluster metrics
Project alerts configurations with the spec.alertConfigurationSyncEnabled and spec.alertConfigurations parameters.
For information on how these settings interact, see the Considerations.
If you remove the AtlasProject resource from your Kubernetes cluster,
Atlas Kubernetes Operator removes the project from Atlas. You must remove all the
clusters in the project beforehand. Otherwise, Atlas rejects the
delete request.
Example
The following example shows an AtlasProject custom resource
specification:
apiVersion: atlas.mongodb.com/v1 kind: AtlasProject metadata: name: my-project spec: name: Test project connectionSecretRef: name: my-atlas-key projectIpAccessList: - cidrBlock: "203.0.113.0/24" comment: "CIDR block for Application Server B - D"
Prometheus Example
The following example shows an AtlasProject custom resource
specification that integrates with Prometheus:
apiVersion: atlas.mongodb.com/v1 kind: AtlasProject metadata: name: my-project spec: name: TestPrometheusIntegration connectionSecretRef: name: my-atlas-key projectIpAccessList: - cidrBlock: "0.0.0.0/1" comment: "Everyone has access. For test purposes only." - cidrBlock: "128.0.0.0/1" comment: "Everyone has access. For test purposes only." integrations: - type: "PROMETHEUS" enabled: "true" username: "prometheus-user" passwordRef: name: "password-name" namespace: "password-namespace" scheme: "http" serviceDiscovery: "http"
To learn more, see Integrate with Third-Party Services.
Note
Atlas Kubernetes Operator offers a sample Grafana dashboard that you can import into Grafana.
Teams Example
The following example shows an AtlasProject custom resource
specification that gives the green-leaf-team the Organization Owner
role for this project. The team members are defined in the
AtlasTeam custom resource.
apiVersion: atlas.mongodb.com/v1 kind: AtlasProject metadata: name: my-project spec: name: Test project teams: - teamRef: name: green-leaf-team roles: - ORGANIZATION_OWNER
To learn more, see Configure Teams.
Maintenance Window Example
The following example shows an AtlasProject custom resource
specification that sets the maintenance window to 5:00 AM every Tuesday with automatic deferral disabled:
apiVersion: atlas.mongodb.com/v1 kind: AtlasProject metadata: name: my-project spec: name: Test project projectIpAccessList: - ipAddress: "192.0.2.15" comment: "IP address for Application Server A" maintenanceWindow: dayOfWeek: 3 hourOfDay: 5 autoDefer: false
Project Settings Example
The following example shows an AtlasProject custom resource
specification that disables the collection of database statistics in
cluster metrics,
data explorer, Performance Advisor, Realtime Performance Panel, and Schema Advisor.
apiVersion: atlas.mongodb.com/v1 kind: AtlasProject metadata: name: my-project spec: name: Test project projectIpAccessList: - ipAddress: "192.0.2.15" comment: "IP address for Application Server A" settings: isCollectDatabaseSpecificsStatisticsEnabled: false isDataExplorerEnabled: false isExtendedStorageSizesEnabled: false isPerformanceAdvisorEnabled: false isRealtimePerformancePanelEnabled: false isSchemaAdvisorEnabled: false
Alert Configuration Example
The following example shows an AtlasProject custom resource
specification that configures an alert that triggers if the oplog
window reaches less than one hour:
apiVersion: atlas.mongodb.com/v1 kind: AtlasProject metadata: name: my-project spec: name: Test Atlas Operator Project connectionSecretRef: name: my-atlas-key alertConfigurations: - eventTypeName: "REPLICATION_OPLOG_WINDOW_RUNNING_OUT", enabled: true, notifications: - delayMin: 0 emailEnabled: true intervalMin: 60 roles: [ "GROUP_OWNER" ] smsEnabled: false typeName: "GROUP" threshold: operator: "LESS_THAN", threshold: "1", units: "HOURS" alertConfigurationSyncEnabled: true withDefaultAlertsSettings: false
Third-Party Alert Configuration Example
The following example shows an AtlasProject custom resource
specification that configures an alert that sends notifications through
Slack:
apiVersion: atlas.mongodb.com/v1 kind: AtlasProject metadata: name: my-project spec: name: Test Atlas Operator Project connectionSecretRef: name: my-atlas-key alertConfigurations: - eventTypeName: "REPLICATION_OPLOG_WINDOW_RUNNING_OUT" enabled: true notifications: - delayMin: 0 emailEnabled: true intervalMin: 60 roles: [ "GROUP_OWNER" ] smsEnabled: false - typeName: "SLACK" apiTokenRef: name: key-name namespace: key-namespace threshold: operator: "LESS_THAN" threshold: "1" units: "HOURS" alertConfigurationSyncEnabled: true withDefaultAlertsSettings: false
Parameters
AtlasProject
AtlasProject is the Schema for the atlasprojects API
Name | Type | Description | Required |
|---|---|---|---|
| string | atlas.mongodb.com/v1 | true |
| string |
| true |
| object | Refer to the Kubernetes | true |
| object |
| false |
| object |
| false |
AtlasProject.spec
AtlasProjectSpec defines the target state of Project in Atlas
Name | Type | Description | Required |
|---|---|---|---|
| string | Name is the
| true |
| boolean |
| false |
| []object |
| false |
| object | Auditing represents | false |
| object |
| false |
| []object |
| false |
| []object |
| false |
| object |
| false |
| []object |
| false |
| object |
| false |
| []object | Integrations is a list of | false |
| object |
| false |
| []object |
| false |
| []object |
| false |
| []object |
| false |
| enum |
| false |
| object | Settings allows the configuration of the Project Settings. | false |
| []object | Teams enable you to grant project access roles to multiple users. | false |
| boolean | Flag that indicates whether Atlas Kubernetes Operator creates a project with the default alert configurations. If you use this setting, you must also set spec.``alertConfigurationSyncEnabled`` to true for Atlas Kubernetes Operator to modify project alert configurations. If you set this parameter to false when you create a project, Atlas doesn't add the default alert configurations to your project. This setting has no effect on existing projects. Default: true | false |
| object | X509CertRef is a reference to the Kubernetes Secret which contains | false |
AtlasProject.spec.alertConfigurations
Name | Type | Description | Required |
|---|---|---|---|
| boolean | If omitted, the configuration is disabled. | false |
| string | The type of event that will trigger an alert. | false |
| []object | You can filter using the | false |
| object |
| false |
| []object | Notifications are sending when an alert condition is detected. | false |
| enum |
| false |
| object | Threshold causes an alert to be triggered. | false |
AtlasProject.spec.alertConfigurations.matchers
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the field in the target object to match on. | false |
| string | The | false |
| string | Value to test with the specified operator. | false |
AtlasProject.spec.alertConfigurations.metricThreshold
MetricThreshold causes an alert to be triggered.
Name | Type | Description | Required |
|---|---|---|---|
| string | Threshold value outside which an alert will be triggered. | true |
| string | Name of the metric to check. | false |
| string | This must be set to | false |
| string | Operator to apply when checking the current metric value against the threshold value. | false |
| string | The | false |
AtlasProject.spec.alertConfigurations.notifications
Name | Type | Description | Required |
|---|---|---|---|
| object | Secret containing a Slack | false |
| string | Slack channel name. Populated for the | false |
| object | Secret containing a Datadog | false |
| string | Region that indicates which | false |
| integer | Number of minutes to wait after an alert condition is detected before sending out the first notification. | false |
| string | Email address to which alert notifications are sent. Populated for the | false |
| boolean | Flag indicating if email notifications should be sent. Populated for | false |
| string | Flowdock flow name in lower-case letters. | false |
| object | The Flowdock personal | false |
| integer | Number of minutes to wait between successive notifications for unacknowledged alerts that are not resolved. | false |
| string | Mobile number to which alert notifications are sent. Populated for the | false |
| object |
| false |
| string | Region that indicates which | false |
| string | Flowdock organization name in lower-case letters. This is the name that appears after www.flowdock.com/app/ in the | false |
| []string | The following | false |
| object |
| false |
| boolean | Flag indicating if text message notifications should be sent. Populated for | false |
| string | Unique identifier of a team. | false |
| string | Label for the team that receives this notification. | false |
| string | Type of alert notification. | false |
| string | Name of the Atlas user to which to send notifications. Only a user in the project that owns the alert configuration is allowed here. Populated for the | false |
| object | Secret containing a | false |
AtlasProject.spec.alertConfigurations.notifications.apiTokenRef
Secret containing a Slack API token or Bot token. Populated for the SLACK notifications type. If the token later becomes invalid, Atlas sends an email to the project owner and eventually removes the token.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.alertConfigurations.notifications.datadogAPIKeyRef
Secret containing a Datadog API Key. Found in the Datadog dashboard. Populated for the DATADOG notifications type.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.alertConfigurations.notifications.flowdockApiTokenRef
The Flowdock personal API token. Populated for the FLOWDOCK notifications type. If the token later becomes invalid, Atlas sends an email to the project owner and eventually removes the token.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.alertConfigurations.notifications.opsGenieApiKeyRef
OpsGenie API Key. Populated for the OPS_GENIE notifications type. If the key later becomes invalid, Atlas sends an email to the project owner and eventually removes the token.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.alertConfigurations.notifications.serviceKeyRef
PagerDuty service key. Populated for the PAGER_DUTY notifications type. If the key later becomes invalid, Atlas sends an email to the project owner and eventually removes the key.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.alertConfigurations.notifications.victorOpsSecretRef
Secret containing a VictorOps API key and Routing key. Populated for the VICTOR_OPS notifications type. If the key later becomes invalid, Atlas sends an email to the project owner and eventually removes the key.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.alertConfigurations.threshold
Threshold causes an alert to be triggered.
Name | Type | Description | Required |
|---|---|---|---|
| string | Operator to apply when checking the current metric value against the threshold value.
It accepts the following values: | false |
| string | Threshold value outside which an alert will be triggered. | false |
| string | The | false |
AtlasProject.spec.auditing
Auditing represents MongoDB Maintenance Windows.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Indicates whether the auditing system captures successful authentication attempts for audit filters using the "atype" : " | false |
| string |
| false |
| boolean | Denotes whether the project associated with the { | false |
AtlasProject.spec.backupCompliancePolicyRef
BackupCompliancePolicyRef is a reference to the backup compliance custom resource.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.cloudProviderAccessRoles
CloudProviderAccessRole define an integration to a cloud provider DEPRECATED: This type is deprecated in favor of CloudProviderIntegration
Name | Type | Description | Required |
|---|---|---|---|
| string |
| true |
| string |
| false |
AtlasProject.spec.cloudProviderIntegrations
CloudProviderIntegration define an integration to a cloud provider
Name | Type | Description | Required |
|---|---|---|---|
| string |
| true |
| string |
| false |
AtlasProject.spec.connectionSecretRef
ConnectionSecret is the name of the Kubernetes Secret which contains the information about the way to connect to Atlas (organization ID, API keys). The default Operator connection configuration will be used if not provided.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.customRoles
CustomRole lets you create and change a custom role in your cluster. Use custom roles to specify custom sets of actions that the Atlas built-in roles can't describe. Deprecated: Migrate to the AtlasCustomRoles custom resource in accordance with the migration guide at https://www.mongodb.com/docs/atlas/operator/current/migrate-parameter-to-resource/#std-label-ak8so-migrate-ptr
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label that identifies the role. This | true |
| []object | List of the individual privilege | false |
| []object | List of the built-in roles that this custom role inherits. | false |
AtlasProject.spec.customRoles.actions
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label that identifies the privilege action. | true |
| []object | List of | true |
AtlasProject.spec.customRoles.actions.resources
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Flag that indicates whether to grant the action on the | false |
| string | Human-readable label that identifies the | false |
| string | Human-readable label that identifies the | false |
AtlasProject.spec.customRoles.inheritedRoles
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label that identifies the | true |
| string | Human-readable label that identifies the role inherited. | true |
AtlasProject.spec.encryptionAtRest
EncryptionAtRest allows to set encryption for AWS, Azure and GCP providers.
Name | Type | Description | Required |
|---|---|---|---|
| object |
| false |
| object |
| false |
| object |
| false |
AtlasProject.spec.encryptionAtRest.awsKms
AwsKms specifies AWS KMS configuration details and whether Encryption at Rest is enabled for an Atlas project.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Specifies whether Encryption at Rest is | false |
| string | The | false |
| object | A reference to as Secret containing the | false |
| boolean | Specifies whether the encryption key set for the provider is | false |
AtlasProject.spec.encryptionAtRest.awsKms.secretRef
A reference to as Secret containing the AccessKeyID, SecretAccessKey, CustomerMasterKeyID and RoleID fields
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.encryptionAtRest.azureKeyVault
AzureKeyVault specifies Azure Key Vault configuration details and whether Encryption at Rest is enabled for an Atlas project.
Name | Type | Description | Required |
|---|---|---|---|
| string | The Azure environment where the Azure account credentials reside. Valid values are the following: | false |
| string | The Client | false |
| boolean | Specifies whether Encryption at Rest is | false |
| string | The name of the Azure Resource group that contains an Azure Key Vault. | false |
| object | A reference to as Secret containing the | false |
| string | The unique identifier for an Azure | false |
AtlasProject.spec.encryptionAtRest.azureKeyVault.secretRef
A reference to as Secret containing the SubscriptionID, KeyVaultName, KeyIdentifier, Secret fields
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.encryptionAtRest.googleCloudKms
GoogleCloudKms specifies GCP KMS configuration details and whether Encryption at Rest is enabled for an Atlas project.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Specifies whether Encryption at Rest is | false |
| object | A reference to as Secret containing the | false |
AtlasProject.spec.encryptionAtRest.googleCloudKms.secretRef
A reference to as Secret containing the ServiceAccountKey, KeyVersionResourceID fields
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations
Integration for the project between Atlas and a third party service. Deprecated: Migrate to the AtlasThirdPartyIntegration custom resource in accordance with the migration guide at https://www.mongodb.com/docs/atlas/operator/current/migrate-parameter-to-resource/#std-label-ak8so-migrate-ptr
Name | Type | Description | Required |
|---|---|---|---|
| string | Unique 40-hexadecimal digit string that identifies your New Relic account. | false |
| object | Reference to a Kubernetes Secret containing your | false |
| object | Reference to a Kubernetes Secret containing the Key that allows Atlas to access your Slack account. | false |
| string | Name of the Slack channel to which Atlas sends alert notifications. | false |
| boolean | Flag that indicates whether someone has activated the Prometheus integration. | false |
| string |
| false |
| object | Reference to a Kubernetes Secret containing your Unique 40-hexadecimal digit string that identifies your New Relic license. | false |
| string | Endpoint web address of the Microsoft Teams webhook to which Atlas sends notifications. | false |
| string | false | |
| string |
| false |
| object | Reference to a Kubernetes Secret containing the password to allow Atlas to access your Prometheus account. | false |
| object | Reference to a Kubernetes Secret containing the query key associated with your New Relic account. | false |
| string | Region code indicating which regional | false |
| object | Reference to a Kubernetes Secret containing the Routing key associated with your Splunk On-Call account. Used for Victor Ops. | false |
| string | false | |
| object | Reference to a Kubernetes Secret containing the secret for your Webhook. | false |
| string | Desired method to discover the Prometheus service. | false |
| object | Reference to a Kubernetes Secret containing the service key associated with your | false |
| string | Human-readable label that identifies your Slack team. | false |
| enum | Third Party Integration | false |
| string | Endpoint web address to which Atlas sends notifications. Used for Webhooks. | false |
| string | Human-readable label that identifies your Prometheus incoming webhook. | false |
| object | Reference to a Kubernetes Secret containing the insert key associated with your New Relic account. | false |
AtlasProject.spec.integrations.apiKeyRef
Reference to a Kubernetes Secret containing your API Key for Datadog, OpsGenie or Victor Ops.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations.apiTokenRef
Reference to a Kubernetes Secret containing the Key that allows Atlas to access your Slack account.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations.licenseKeyRef
Reference to a Kubernetes Secret containing your Unique 40-hexadecimal digit string that identifies your New Relic license.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations.passwordRef
Reference to a Kubernetes Secret containing the password to allow Atlas to access your Prometheus account.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations.readTokenRef
Reference to a Kubernetes Secret containing the query key associated with your New Relic account.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations.routingKeyRef
Reference to a Kubernetes Secret containing the Routing key associated with your Splunk On-Call account. Used for Victor Ops.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations.secretRef
Reference to a Kubernetes Secret containing the secret for your Webhook.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations.serviceKeyRef
Reference to a Kubernetes Secret containing the service key associated with your PagerDuty account.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.integrations.writeTokenRef
Reference to a Kubernetes Secret containing the insert key associated with your New Relic account.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.maintenanceWindow
MaintenanceWindow allows to specify a preferred time in the week to run maintenance operations. See more information at https://www.mongodb.com/docs/atlas/reference/api/maintenance-windows/
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Flag indicating whether any scheduled project maintenance should be deferred automatically for one week. | false |
| integer | Day of the week when you would like the maintenance window to start as a 1-based integer. Sunday 1, Monday 2, Tuesday 3, Wednesday 4, Thursday 5, Friday 6, Saturday 7. Minimum: 1 Maximum: 7 | false |
| boolean | Flag indicating whether the next scheduled project maintenance should be deferred for one week.
Cannot be specified if | false |
| integer | Hour of the day when you would like the maintenance window to start. This parameter uses the 24-hour clock, where midnight is 0, noon is 12. Minimum: 0 Maximum: 23 | false |
| boolean | Flag indicating whether project maintenance has been directed to start immediately. Cannot be specified if defer is true | false |
AtlasProject.spec.networkPeers
NetworkPeer configured for the current Project. Deprecated: Migrate to the AtlasNetworkPeering and AtlasNetworkContainer custom resources in accordance with the migration guide at https://www.mongodb.com/docs/atlas/operator/current/migrate-parameter-to-resource/#std-label-ak8so-migrate-ptr
Name | Type | Description | Required |
|---|---|---|---|
| string |
| false |
| string | Atlas | false |
| string |
| false |
| string |
| false |
| string |
| false |
| string |
| false |
| string |
| false |
| string | User | false |
| string |
| false |
| string |
| false |
| string |
| false |
| string | User | false |
| string | VNetName is name of your Azure VNet. Its applicable only for Azure. | false |
| string |
| false |
AtlasProject.spec.privateEndpoints
PrivateEndpoint is a list of Private Endpoints configured for the current Project. Deprecated: Migrate to the AtlasPrivateEndpoint Custom Resource in accordance with the migration guide at https://www.mongodb.com/docs/atlas/operator/current/migrate-parameter-to-resource/#std-label-ak8so-migrate-ptr
Name | Type | Description | Required |
|---|---|---|---|
| enum | Cloud | true |
| string | Cloud provider | true |
| string | Unique identifier of the endpoint group. The endpoint group encompasses all the endpoints that you created in Google Cloud. | false |
| []object | Collection of individual private | false |
| string | Unique identifier of the Google Cloud project in which you created your endpoints. | false |
| string | Unique identifier of the private endpoint you created in your | false |
| string | Private | false |
AtlasProject.spec.privateEndpoints.endpoints
Name | Type | Description | Required |
|---|---|---|---|
| string | Forwarding rule that corresponds to the endpoint you created in Google Cloud. | false |
| string | Private | false |
AtlasProject.spec.projectIpAccessList
IPAccessList allows the use of the IP Access List for a Project. See more information at https://docs.atlas.mongodb.com/reference/api/ip-access-list/add-entries-to-access-list/ Deprecated: Migrate to the AtlasIPAccessList Custom Resource in accordance with the migration guide at https://www.mongodb.com/docs/atlas/operator/current/migrate-parameter-to-resource/#std-label-ak8so-migrate-ptr
Name | Type | Description | Required |
|---|---|---|---|
| string | Unique identifier of | false |
| string | Range of | false |
| string | Comment associated with this access list entry. | false |
| string | Timestamp in | false |
| string | Entry using an | false |
AtlasProject.spec.settings
Settings allows the configuration of the Project Settings.
Name | Type | Description | Required |
|---|---|---|---|
| boolean | Flag that indicates whether to collect database-specific metrics for the specified project. | false |
| boolean | Flag that indicates whether to enable the Data Explorer for the specified project. | false |
| boolean | Flag that indicates whether to enable extended storage sizes for the specified project. | false |
| boolean | Flag that indicates whether to enable the Performance Advisor and Profiler for the specified project. | false |
| boolean | Flag that indicates whether to enable the Real Time Performance Panel for the specified project. | false |
| boolean | Flag that indicates whether to enable the Schema Advisor for the specified project. | false |
AtlasProject.spec.teams
Name | Type | Description | Required |
|---|---|---|---|
| []enum | Roles the users in the team has within the project.
Enum: | true |
| object | Reference to the | true |
AtlasProject.spec.teams.teamRef
Reference to the AtlasTeam custom resource which will be assigned to the project.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.spec.x509CertRef
X509CertRef is a reference to the Kubernetes Secret which contains PEM-encoded CA certificate. Atlas Kubernetes Operator watches secrets only with the label atlas.mongodb.com/type=credentials to avoid watching unnecessary secrets.
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |
AtlasProject.status
AtlasProjectStatus defines the observed state of AtlasProject
Name | Type | Description | Required |
|---|---|---|---|
| []object | Conditions is the list of statuses showing the current state of the Atlas Custom Resource | true |
| []object |
| false |
| []string |
| false |
| []object |
| false |
| []object |
| false |
| []object | The list of | false |
| string | The | false |
| []object | The list of network peers that are configured for current project | false |
| integer |
| false |
| []object | The list of private endpoints configured for current project | false |
| object | Prometheus contains the status for Prometheus integration
including the | false |
| []object | Teams contains a list of | false |
AtlasProject.status.conditions
Condition describes the state of an Atlas Custom Resource at a certain point.
Name | Type | Description | Required |
|---|---|---|---|
| string | Status of the condition; one of True, False, Unknown. | true |
| string | Type of Atlas Custom Resource condition. | true |
| string | Last time the condition transitioned from one status to another.
Represented in | false |
| string | A | false |
| string | The | false |
AtlasProject.status.alertConfigurations
Name | Type | Description | Required |
|---|---|---|---|
| string | The date through which the alert has been acknowledged. Will not be present if the alert has never been acknowledged. | false |
| string | The comment left by the user who acknowledged the alert. Will not be present if the alert has never been acknowledged. | false |
| string | The username of the user who acknowledged the alert. Will not be present if the alert has never been acknowledged. | false |
| string |
| false |
| string | The | false |
| string | The name the cluster to which this alert applies. Only present for alerts of type | false |
| string | Timestamp in | false |
| object |
| false |
| boolean | If omitted, the configuration is disabled. | false |
| string |
| false |
| string | The type of event that will trigger an alert. | false |
| string | Unique identifier of the project that owns this alert configuration. | false |
| string |
| false |
| string | The hostname and port of each host to which the alert applies. Only present for alerts of type | false |
| string | Unique identifier. | false |
| string | When the last notification was sent for this alert. Only present if notifications have been sent. | false |
| []object | You can filter using the | false |
| string | The name of the measurement whose value went outside the threshold. Only present if | false |
| object |
| false |
| []object | Notifications are sending when an alert condition is detected. | false |
| string | Name of the replica set. Only present for alerts of type | false |
| string | When the alert was closed. Only present if the status is | false |
| string | Severity of the alert. | false |
| string | For alerts of the type | false |
| string | The current state of the alert. Possible values are: | false |
| object | Threshold causes an alert to be triggered. | false |
| string | Timestamp in | false |
AtlasProject.status.alertConfigurations.currentValue
CurrentValue represents current value of the metric that triggered the alert. Only present for alerts of type HOST_METRIC.
Name | Type | Description | Required |
|---|---|---|---|
| string | The value of the metric. | false |
| string | The | false |
AtlasProject.status.alertConfigurations.matchers
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the field in the target object to match on. | false |
| string | The | false |
| string | Value to test with the specified operator. | false |
AtlasProject.status.alertConfigurations.metricThreshold
MetricThreshold causes an alert to be triggered.
Name | Type | Description | Required |
|---|---|---|---|
| string | Threshold value outside which an alert will be triggered. | true |
| string | Name of the metric to check. | false |
| string | This must be set to | false |
| string | Operator to apply when checking the current metric value against the threshold value. | false |
| string | The | false |
AtlasProject.status.alertConfigurations.notifications
Name | Type | Description | Required |
|---|---|---|---|
| string | Slack | false |
| string | Slack channel name. Populated for the | false |
| string | Datadog | false |
| string | Region that indicates which | false |
| integer | Number of minutes to wait after an alert condition is detected before sending out the first notification. | false |
| string | Email address to which alert notifications are sent. Populated for the | false |
| boolean | Flag indicating if email notifications should be sent. Populated for | false |
| string | Flowdock flow namse in lower-case letters. | false |
| string | The Flowdock personal | false |
| integer | Number of minutes to wait between successive notifications for unacknowledged alerts that are not resolved. | false |
| string | Mobile number to which alert notifications are sent. Populated for the | false |
| string | Opsgenie | false |
| string | Region that indicates which | false |
| string | Flowdock organization name in lower-case letters. This is the name that appears after www.flowdock.com/app/ in the | false |
| []string | The following | false |
| string |
| false |
| boolean | Flag indicating if text message notifications should be sent. Populated for | false |
| string | Unique identifier of a team. | false |
| string | Label for the team that receives this notification. | false |
| string | Type of alert notification. | false |
| string | Name of the Atlas user to which to send notifications. Only a user in the project that owns the alert configuration is allowed here. Populated for the | false |
| string |
| false |
| string |
| false |
AtlasProject.status.alertConfigurations.threshold
Threshold causes an alert to be triggered.
Name | Type | Description | Required |
|---|---|---|---|
| string | Operator to apply when checking the current metric value against the threshold value. it accepts the following values: | false |
| string | Threshold value outside which an alert will be triggered. | false |
| string | The | false |
AtlasProject.status.cloudProviderIntegrations
Name | Type | Description | Required |
|---|---|---|---|
| string | Unique external | true |
| string | Human-readable label that identifies the cloud provider of the role. | true |
| string | Amazon Resource Name that identifies the Amazon Web Services user account that | false |
| string | Date and time when someone authorized this role for the specified cloud service provider. This parameter expresses its value in the | false |
| string | Date and time when someone created this role for the specified cloud service provider. This parameter expresses its value in the | false |
| string | Application error message returned. | false |
| []object | List that contains application features associated with this Amazon Web Services Identity and Access Management role. | false |
| string | Amazon Resource Name that identifies the Amazon Web Services Identity and Access Management role that | false |
| string | Unique 24-hexadecimal digit string that identifies the role. | false |
| string | Provision | false |
AtlasProject.status.cloudProviderIntegrations.featureUsages
Name | Type | Description | Required |
|---|---|---|---|
| string | Identifying characteristics about the data lake linked to this Amazon Web Services Identity and Access Management role. | false |
| string | Human-readable label that describes one | false |
AtlasProject.status.customRoles
Name | Type | Description | Required |
|---|---|---|---|
| string | Role | true |
| string | The | true |
| string | The message when the custom role is in the | false |
AtlasProject.status.expiredIpAccessList
IPAccessList allows the use of the IP Access List for a Project. See more information at https://docs.atlas.mongodb.com/reference/api/ip-access-list/add-entries-to-access-list/ Deprecated: Migrate to the AtlasIPAccessList Custom Resource in accordance with the migration guide at https://www.mongodb.com/docs/atlas/operator/current/migrate-parameter-to-resource/#std-label-ak8so-migrate-ptr
Name | Type | Description | Required |
|---|---|---|---|
| string | Unique identifier of | false |
| string | Range of | false |
| string | Comment associated with this access list entry. | false |
| string | Timestamp in | false |
| string | Entry using an | false |
AtlasProject.status.networkPeers
Name | Type | Description | Required |
|---|---|---|---|
| string | Unique identifier for | true |
| string | Cloud provider for which you want to retrieve a network peer. | true |
| string | Region for which you want to create the network peer. It isn't needed for | true |
| string |
| false |
| string | Atlas Network Name. Applicable only for | false |
| string | Unique identifier of the network peer connection. Applicable only for | false |
| string |
| false |
| string | Error state of the network peer. Applicable only for | false |
| string | Error state of the network peer. Applicable only for Azure. | false |
| string | Error state of the network peer. Applicable only for | false |
| string |
| false |
| string | Status of the network peer. Applicable only for | false |
| string | Status of the network peer. Applicable only for | false |
| string |
| false |
AtlasProject.status.privateEndpoints
Name | Type | Description | Required |
|---|---|---|---|
| string | Cloud | true |
| string | Cloud provider | true |
| []object | Collection of individual | false |
| string | Unique identifier for | false |
| string | Unique identifier of the | false |
| []string | Unique alphanumeric and special character strings that identify the service attachments associated with the | false |
| string | Name of the | false |
| string | Unique identifier of the Azure Private Link Service (for | false |
AtlasProject.status.privateEndpoints.endpoints
Name | Type | Description | Required |
|---|---|---|---|
| string | Human-readable label that identifies the Google Cloud consumer forwarding rule that you created. | true |
| string | One Private Internet Protocol version 4 (IPv4) address to which this Google Cloud consumer forwarding rule resolves. | true |
| string | State of the | true |
AtlasProject.status.prometheus
Prometheus contains the status for Prometheus integration including the prometheusDiscoveryURL
Name | Type | Description | Required |
|---|---|---|---|
| string |
| false |
| string | Protocol | false |
AtlasProject.status.teams
Name | Type | Description | Required |
|---|---|---|---|
| object |
| true |
| string | false |
AtlasProject.status.teams.teamRef
ResourceRefNamespaced is a reference to a Kubernetes Resource that allows to configure the namespace
Name | Type | Description | Required |
|---|---|---|---|
| string | Name of the Kubernetes Resource | true |
| string | Namespace of the Kubernetes Resource | false |