Início rápido do OpenShift

Clone o repositório do MongoDB Enterprise Kubernetes Operator.

git clone https://github.com/mongodb/mongodb-enterprise-kubernetes.git

Criar um namespace para seu sistema do Kubernetes.

Por padrão, o Kubernetes Operator usa o namespace mongodb. Para simplificar a instalação, considere a criação de um namespace rotulado como mongodb usando o seguinte comando kubectl:

kubectl create namespace mongodb

Configure kubectl como padrão para seu namespace.

Se você ainda não tiver feito isso, execute o seguinte comando para executar todos os comandos kubectl no namespace que você criou:

kubectl config set-context $(kubectl config current-context) --namespace=mongodb

Criar um segredo que contém credenciais autorizadas a extrair imagens do registry.connect.redhat.com repositório .

Se você usar o Kubernetes Operator para implantar recursos do MongoDB em vários namespaces ou com um escopo que abranja todo o cluster, crie o segredo somente no namespace em que você pretende implantar o Kubernetes Operator. O Kubernetes Operator sincroniza o secret em todos os namespaces assistidos.

1. Se ainda não o fez, obtenha uma assinatura do Red Hat.

2. Crie uma Conta de serviço de registro.

3. Clique na sua conta de serviço de registro e, em seguida, clique na aba Docker Configuration.

4. Baixe o arquivo <account-name>-auth.json e abra-o em um editor de texto.

5. Copie o objeto registry.redhat.io e cole outra instância deste objeto no arquivo. Lembre-se de adicionar uma vírgula após o primeiro objeto. Renomeie o segundo objeto registry.connect.redhat.com e salve o arquivo:

   {
     "auths": {
       "registry.redhat.io": {
         "auth": "<encoded-string>"
       },
       "registry.connect.redhat.com": {
         "auth": "<encoded-string>"
       }
     }
   }

6. Crie um arquivo openshift-pull-secret.yaml e adicione o conteúdo do arquivo de <account-name>-auth.json modificado como stringData .dockerconfigjson nomeado ao arquivo secreto openshift-pull-secret.yaml.

   apiVersion: v1
   kind: Secret
   metadata:
     name: openshift-pull-secret
   stringData:
     .dockerconfigjson: |
         {
           "auths": {
             "registry.redhat.io": {
               "auth": "<encoded-string>"
             },
             "registry.connect.redhat.com": {
               "auth": "<encoded-string>"
             }
           }
         }
   type: kubernetes.io/dockerconfigjson

   O valor fornecido no campo metadata.name contém o nome secreto. Forneça este valor quando solicitado para o <openshift-pull-secret>.

7. Crie um segredo a partir do arquivo openshift-pull-secret.yaml no mesmo namespace em que você implantará o Kubernetes Operator.

   oc apply -f openshift-pull-secret.yaml -n <metadata.namespace>

Instale o MongoDB Enterprise Kubernetes Operator

1. Invoque o seguinte comando oc para instalar o CustomResourceDefinitions para sistemas do MongoDB:

   oc apply -f crds.yaml

2. Adicione seu <openshift-pull-secret> às definições do ServiceAccount no arquivo MongoDB Enterprise Kubernetes Operator YAML.

   ---
   # Source: mongodb-enterprise-operator/templates/serviceaccount.yaml
   ---
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: enterprise-operator
     namespace: mongodb
   imagePullSecrets:
    - name: <openshift-pull-secret>
   ---
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: mongodb-enterprise-appdb
     namespace: mongodb
   imagePullSecrets:
    - name: <openshift-pull-secret>
   ---
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: mongodb-enterprise-database-pods
     namespace: mongodb
   imagePullSecrets:
    - name: <openshift-pull-secret>

3. Invocar o seguinte comando oc para instalar o Kubernetes Operator:

   oc apply -f mongodb-enterprise-openshift.yaml

Crie credenciais e armazene-as como um segredo.

Execute o seguinte comando:

kubectl -n mongodb \
  create secret generic ops-manager-admin-key \
  --from-literal="publicKey=<publicKey>" \
  --from-literal="privateKey=<privateKey>"

Invoke the following command to create a ConfigMap.

cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: ConfigMap
metadata:
  name: my-project
  namespace: mongodb
data:
  projectName: myProjectName # this is an optional parameter; when omitted, the Operator creates a project with the resource name
  orgId: 5b890e0feacf0b76ff3e7183 # this is a required parameter
  baseUrl: https://ops.example.com:8443
EOF

Implemente o recurso conjunto de réplicas .

1. 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

2. 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.

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.

1. 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"

2. Execute o seguinte comando:

   kubectl apply -f <database-user-conf>.yaml

Opcional: visualize o usuário recém-criado no Cloud Manager ou no Ops Manager.

Você pode visualizar o usuário recém-criado no Cloud Manager ou Ops Manager:

1. Na visualização Deployment do projeto, clique na guia Security.

2. Clique no separador MongoDB Users aninhado.

Conecte-se ao conjunto de réplicas.

Execute as seguintes etapas no aplicativo Cloud Manager:

1. Clique em Deployment na navegação à esquerda.

2. Clique em para o sistema ao qual você deseja se conectar.

3. Clique em Connect to this instance.

4. Execute o comando de conexão em um terminal para se conectar ao sistema.