Docs Menu

Docs Home → MongoDB Ops Manager

Configure Kubernetes for Deploying MongoDB Resource

On this page

  • Verify Permissions
  • Overview of MongoDB Resource in Kubernetes
  • Procedures

You can use the MongoDB Enterprise Kubernetes Operator to deploy MongoDB resources such as a replica set, a sharded cluster, or a standalone instance using an object. Ops Manager can generate the YAML files you need to configure your Kubernetes environment for deploying a MongoDB Database resource.

To generate the YAML files:

Verify Permissions

You must have one of the following roles to access the Ops Manager UI for setting up Kubernetes:

Overview of MongoDB Resource in Kubernetes

To create or link your Ops Manager project, the MongoDB Enterprise Kubernetes Operator requires that you configure a Kubernetes ConfigMap. Using the Kubernetes ConfigMap, you can:

  • Connect to a HTTPS-enabled Ops Manager that is using a custom Certificate Authority, or

  • Link to a Ops Manager project that isn't using a custom Certificate Authority.

You can use the Ops Manager Kubernetes Setup page to automatically generate the ConfigMap. The generated YAML file for the ConfigMap looks similar to the following:

To create or update objects in your Ops Manager project, configure your Programmatic API Key as a Kubernetes secret. The secret stores authentication credentials so only Kubernetes can access them.

The following procedures provide the detailed steps.

Procedures

Navigate to the Kubernetes Setup Page in the Ops Manager UI

To access the Kubernetes Setup page in the Ops Manager UI:

1

Log in to Ops Manager and select the organization that contains your project from the Organizations menu in the navigation bar.

2

Select your project from the Project menu in the navigation bar.

3

Click the Add dropdown and select Prepare Kubernetes Configuration to display the Kubernetes Setup page.

If you are a Global Owner or Organization Owner, you can also access the Kubernetes Setup page in the Ops Manager UI by following these steps:

1

Log in to Ops Manager and select your organization from the Organizations menu in the navigation bar.

2

Click Kubernetes Setup in the sidebar or the navigation bar.

Create a Secret, a ConfigMap, and Ops Manager Settings for Kubernetes

To create a secret, a ConfigMap file, and Ops Manager settings for Kubernetes:

1

Create a secret file with your API keys.

Create a YAML file that contains your Programmatic API Key in the /mongodb-ops-manager/ folder.

2

Create a ConfigMap to link to your Ops Manager instance.

Create a YAML file that contains the ConfigMap to connect to your HTTPS-enabled Ops Manager instance in the /mongodb-ops-manager/ folder.

3

Configure the Ops Manager settings for Kubernetes.

In your server's conf-mms.properties file, configure the following settings:

  • kubernetes.templates.credentialsFilePath. Path to the YAML file that contains the ConfigMap to use to link to your Ops Manager project. This file must be in YAML format and must be stored under the /mongodb-ops-manager/ directory. The file corresponds to Kubernetes ConfigMap Setup.

  • kubernetes.templates.projectFilePath. Path to the YAML file that contains your Programmatic API Key as a Kubernetes secret to create or update objects in your Ops Manager project. This file must be in YAML format and must be stored under the /mongodb-ops-manager/ directory. The file corresponds to Kubernetes Secret Setup.

To learn more, see Kubernetes Setup.

Generate the ConfigMap YAML Files

To generate the Kubernetes configuration files for a MongoDB resource:

←  Deploy MongoDB Resources Using KubernetesDeploy a BI Connector →

On this page