Início rápido para o operador Kubernetes
Nesta página
- Pré-requisitos
- Procedimento
- Adicione o repositório MongoDB Helm Charts for Kubernetes ao Helm.
- Instale o MongoDB Enterprise Kubernetes Operator
- Configure o
kubectl
como padrão para seu namespace. - Configurar o operador Kubernetes
- Copie e salve o ConfigMap.
- Copie e salve o segredo.
- Aplique o ConfigMap e Secreto.
- Implemente o recurso conjunto de réplicas MongoDB .
- Crie um segredo com sua senha de usuário do banco de dados
- Criar um utilizador de banco de dados.
- Opcional: visualize o usuário recém-criado no Cloud Manager ou no Ops Manager.
- Conecte-se ao conjunto de réplicas do MongoDB.
Importante
Esta seção é somente para sistemas de cluster Kubernetes únicos. Para sistemas do MongoDB de cluster multi-Kubernetes, consulte Início Rápido de Cluster Multi-Kubernetes.
O MongoDB Enterprise Kubernetes Operator usa a API e as ferramentas do Kubernetes para gerenciar clusters MongoDB em execução dentro do seu cluster Kubernetes. O Kubernetes Operator trabalha junto com o MongoDB Cloud Manager ou Ops Manager. Este tutorial demonstra como implantar e se conectar ao seu primeiro conjunto de réplicas do MongoDB no MongoDB Cloud Manager com o Kubernetes Operator. Você pode usar o Kind para configurar rapidamente um cluster. Para saber mais, consulte Tipo.
Pré-requisitos
Este tutorial requer:
Um cluster do MongoDB Cloud Manager em execução.
Um cluster Kubernetes em execução.
Nós do Kubernetes em execução em arquiteturas de hardware compatíveis.
O MongoDB Shell instalado em sua máquina local.
Procedimento
Adicione o repositório MongoDB Helm Charts for Kubernetes ao Helm.
helm repo add mongodb https://mongodb.github.io/helm-charts
Instale o MongoDB Enterprise Kubernetes Operator
Para instalar o Operador Kubernetes com Helm, consulte as instruções no repositório.
Exemplo
O seguinte comando instala o MongoDB Enterprise Kubernetes Operator no namespace do mongodb
com a opção opcional do --create-namespace
. Por padrão, o Kubernetes Operator utiliza o namespace default
.
helm install enterprise-operator mongodb/enterprise-operator --namespace mongodb --create-namespace
Configurar o operador Kubernetes
Acesse a página de configuração do Kubernetes na interface do usuário do Cloud Manager.
Clique em Create New API Keys ou Use Existing API Keys.
Preencha o formulário. Para saber mais, consulte Acesso programático ao Cloud Manager.
Clique em Generate Key and YAML.
Copie e salve o ConfigMap.
Copie e salve o arquivo config-map.yaml
gerado.
Exemplo:
apiVersion: v1 kind: ConfigMap metadata: name: my-project namespace: mongodb data: baseUrl: https://cloud.mongodb.com projectName: my-project # this is an optional parameter orgId: 5ecd252f8c1a75033c74106c # this is a required parameter
Para saber mais, consulte as descrições do parâmetro.
Implemente o recurso conjunto de réplicas MongoDB .
Copie e salve o seguinte arquivo YAML:
apiVersion: mongodb.com/v1 kind: MongoDB metadata: name: demo-mongodb-cluster-1 namespace: mongodb spec: members: 3 version: 4.4.5-ent type: ReplicaSet security: authentication: enabled: true modes: ["SCRAM"] cloudManager: configMapRef: name: my-project credentials: organization-secret persistent: true podSpec: podTemplate: spec: containers: - name: mongodb-enterprise-database resources: limits: cpu: 2 memory: 1.5G requests: cpu: 1 memory: 1G persistence: single: storage: 10Gi Execute o seguinte comando:
kubectl apply -f <replica-set-conf>.yaml
Crie um segredo com sua senha de usuário do banco de dados
Você pode optar por usar uma senha de texto simples ou uma senha codificada em Base64. As senhas de texto simples usam stringData.password
e as senhas codificadas em Base64 usam data.password
.
Observação
Forneça seus valores para os seguintes parâmetros. Para saber mais, consulte as descrições do parâmetro.
Para obter uma senha de texto não criptografado, crie e salve o seguinte arquivo YAML:
apiVersion: v1 kind: Secret metadata: name: mms-user-1-password # corresponds to user.spec.passwordSecretKeyRef.name type: Opaque stringData: password: <my-plain-text-password> # corresponds to user.spec.passwordSecretKeyRef.key
Para obter uma senha codificada em Base64, crie e salve o seguinte arquivo YAML:
apiVersion: v1 kind: Secret metadata: name: mms-user-1-password # corresponds to user.spec.passwordSecretKeyRef.name type: Opaque data: password: <base-64-encoded-password> # corresponds to user.spec.passwordSecretKeyRef.key
Criar um utilizador de banco de dados.
Copie e salve o seguinte arquivo de Especificação de recursos do usuário do MongoDB:
apiVersion: mongodb.com/v1 kind: MongoDBUser metadata: name: mms-scram-user-1 spec: passwordSecretKeyRef: name: mms-user-1-password # Match to metadata.name of the User Secret key: password username: "mms-scram-user-1" db: "admin" # mongodbResourceRef: name: "demo-mongodb-cluster-1" # Match to MongoDB resource using authenticaiton roles: - db: "admin" name: "clusterAdmin" - db: "admin" name: "userAdminAnyDatabase" - db: "admin" name: "readWrite" - db: "admin" name: "userAdminAnyDatabase" Execute o seguinte comando:
kubectl apply -f <database-user-conf>.yaml
Conecte-se ao conjunto de réplicas do MongoDB.
Execute as seguintes etapas no aplicativo Cloud Manager:
Clique em Deployment na navegação à esquerda.
Clique em para o sistema ao qual você deseja se conectar.
Clique em Connect to this instance.
Execute o comando de conexão em um terminal para se conectar ao sistema.