Databases

O Strapi oferece a opção de escolher o database mais apropriado para o seu projeto. Atualmente, ele suporta PostgreSQL, MongoDB, SQLite, MySQL e MariaDB. A documentação a seguir aborda como instalar esses databases no local (para fins de desenvolvimento) e em várias soluções de servidores, hospedados ou em nuvem (para fins de preparação ou produção).

   DICA

A implantação do Strapi em si é abordado no Deployment Guide.

Instalação do SQLite

SQLite e o database padrão (Quick Start) e recomendado para criar rapidamente um app em local.

Instalar o SQLite no local

Simplesmente use um dos comandos a seguir

Fio

Npx

Isso criará um novo projeto e o lançará no navegador.

DICA

O Quick Start Guide é um tutorial completo passo a passo

Instalação do MongoDB

Instalar o MongoDB no local  

1. Instale MongoDB no seu ambiente de desenvolvimento

Se você já tem o MongoDB instalado no local e rodando como um serviço em segundo plano, você pode pular para Instalar Strapi no local com MongoDB. (se você tem perguntas adicionais, por favor veja a pagina oficial do MongoDB documentation)

Por favor complete os passos de instalação apropriados para o seu sistema operacional.

Windows 10

Instalar MongoDB no Windows 10

Siga estes passos para instalar o MongoDB no seu Windows 10 Environment (o subsistema do Windows para Linux (WSL) não é suportado pelo MongoDB):

1. Baixe o MongoDB Community Edition Server para windows aqui. Selecione MongoDB Community Server e verifique as opções que mais combinam com seu computador. Então Baixe o pacote e siga as instruções de instalação para completar o processo.

2. Depois de instalar o MongoDB com sucesso, o serviço dele sera inicializado. Para começar a usar o MongoDB, conecte o mongo.exe shell para a instância MongoDB em execução.

Você pode sair do MongoDB shell apertando CTRL + C.

Você agora instalou MongoDB para Windows 10. Você agora esta pronto(a) para  Instalar Strapi no local com MongoDB

Mac O/S

Siga estas etapas para instalar o MongoDB no seu Mac developer environment:

Mac OS

1. Use o brew para tocar no repositório oficial de fórmulas do MongoDB e adicioná-lo à lista de fórmulas:

2. Agora instale o MongoDB

3. Execute o processo mongod para conectar e usar o MongoDB:

Agora você instalou o MongoDB para Mac. Agora você está pronto para instalar o Strapi com o MongoDB no local

Ubuntu 18.04

Instalar MongoDB no Ubuntu

Siga estes passos para instalar o MongoDB no seu Ubuntu Environment

1. Importe uma chave publica para garantir que seu MongoDB e autentico:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 –recv 9DA31620334BD75D9DCB49F368818C72E52529D4

2. Em seguida, adicione o repositório para 18.04. Repositórios para outras versões do Ubuntu são encontrados aqui

echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list

3. Recarregue o database do pacote local:

4. Instale o pacote MongoDB de versão estável

5. Execute o processo mongod para conectar e usar o MongoDB:

6. Confirme o status do MongoDB:

7. O ultimo passo e habilitar automaticamente para o MongoDB abrir quando seu computador e inicializado:

Você agora instalou MongoDB para Linux. Você agora esta pronto(a) para  Instalar Strapi no local com MongoDB

2. Instalar o Strapi no local com MongoDB

Siga estas etapas para criar um projeto Strapi no local usando o database do MongoDB.

DICA

O MongoDB já deve estar em execução em segundo plano.

1. Crie um noivo projeto no Strapi

atalho: ./

npx

Use a tecla de seta para baixo, selecione Personalizado (configurações manuais) e pressione Enter:

Selecione MongoDB e pressione enter:

Pressione Enter para selecionar as opções padrão restantes. Vai parecer algo assim:

Você instalou com sucesso o Strapi com o MongoDB no seu development environment local. Agora você está pronto para criar seu primeiro usuário.

Instalar no Atlas: MongoDB Atlas

Siga estas etapas para configurar um projeto local do Strapi para usar uma conta de 512 MB grátis do MongoDB Atlas na produção. (Consulte a documentação do MongoDB Atlas se você tiver alguma dúvida.)

-Você já deve ter criado seu projeto Strapi usando o MongoDB.

-Você já deve ter criado uma conta gratuita do MongoDB Atlas.

1.Faça login na sua conta para criar um projeto e um Cluster

-Primeiro você precisa criar um novo projeto.

-Em seguida, clique em Criar um cluster, na página de opções:

-Escolha a AWS como seu Cloud Provider & Region

-Selecione uma Region. (Nota: algumas Regions não têm um nível gratuito.)

-Na Cluster Tier, selecione Shared Sandbox, Tier MO.

-Em Cluster Name, nomeie seu cluster.

-Clique no botão verde Criar Cluster. Você receberá uma mensagem dizendo: "Seu cluster está sendo criado...”

2. Em seguida, clique em Database Access no manu esquerdo (Em Overview: 

-Clique no botão verde + ADD NEW USER:

-Digite um nome de usuário.

-Insira uma senha.

-Em User Privileges, verifique se a opção Read and write to any database está selecionada. Em seguida, clique em add user para salvar.

3.Em seguida, de WhiteList à seu endereço IP. Clique em Network Acces, em Security, no menu esquerdo:

-Clique no botão verde + ADD IP ADDRESS

-Clique ADD CURRENT IP ADDRESS ou digite manualmente um endereço IP para a WhiteList

-Deixe um comentário para rotular esse endereço IP. Por exemplo. Escritório.

-Clique no botão verde “Confirm”

-Exclua a configuração 0.0.0.0/0 após testar a conexão.

DICA

Se, por qualquer motivo, você precisar testar a configuração ou outro aspecto da sua conexão com o database, convém reativar o Allow Access from Anywhere. Siga estes passos:

-Clique no botão verde + ADD IP ADDRESS

-Depois adicione 0.0.0.0/0 na WhiteList Entry. (Nota: Em projetos permanentes, você configuraria isso com os endereços IP apropriados.)

-Deixe um comentário para rotular esse endereço IP. Por exemplo. Qualquer lugar

-Clique em Confirm. Aguarde até que o status mude de Pending to Active.

DICA

Se você estiver atendendo seu projeto Strapi a partir de um Endereço IP conhecido, siga as etapas a seguir para permitir o Acesso à Network.

Insira manualmente um endereço IP para a Whitelist, no servidor Strapi.

Deixe um comentário para rotular esse endereço IP. Por exemplo. Heroku Server

Em seguida, clique no botão verde Confirmar.

4. Recuperar credenciais do database

O MongoDB Atlas expõe automaticamente as credenciais do database em uma única variável de ambiente acessível pelo seu aplicativo. Para localizá-lo, siga estas etapas:

Em Atlas, no lado esquerdo, clique em Clusters. Isso deve levar você ao seu cluster. Em seguida, clique em CONNECT e, em seguida, Conect your application.

Em 1. Choose your driver version, selecione DRIVER como Node.js e VERSION como 2.2.12 ou posterior.

Isso deve mostrar uma Connection String Only semelhante a esta:

mongodb://paulbocuse:<password>@strapi-heroku-shard-00-00-oxxxo.mongodb.net:27017,strapi-heroku-shard-00-01-oxxxo.mongodb.net:27017,strapi-heroku-shard-00-02-oxxxo.mongodb.net:27017/test?ssl=true&replicaSet=Strapi-Heroku-shard-0&authSource=admin&retryWrites=true&w=majority

ATENÇÃO

Observe a <Password> após o seu nome de usuário. Neste exemplo, após mongodb: // paulbocuse :. Você precisará substituir a <Password> pela senha que você criou anteriormente para este usuário em sua conta do MongoDB Atlas.

5. Atualize e substitua o arquivo de configuração /database.json existente para o environmentapropriado (desenvolvimento | produção).

Substitua o conteúdo de /database.json pelo seguinte e substitua <password> pela senha do usuário do seu database que você criou anteriormente:

atalho: /config/environments/(development|production)/database.json.

{

  "defaultConnection": "default",

  "connections": {

    "default": {

      "connector": "mongoose",

      "settings": {

        "uri": "mongodb://paulbocuse:<password>@strapidatabase-shard-00-00-fxxx6c.mongodb.net:27017,strapidatabase-shard-00-01-fxxxc.mongodb.net:27017,strapidatabase-shard-00-02-fxxxc.mongodb.net:27017/test?ssl=true&replicaSet=strapidatabase-shard-0&authSource=admin&retryWrites=true&w=majority"

      },

      "options": {

        "ssl": true

      }

    }

  }

}

NOTA

A configuração acima criará um database chamado strapi, o database padrão que o Strapi define para qualquer database MongoDB. Se você quiser nomear outra database, adicione a seguinte Key:value pair em suas "configurações": localizada no seu arquivo database.json.

"database": "my-database-name"

ATENÇÃO

Recomendamos a substituição de informações confidenciais (por exemplo, "URI string" acima) nos arquivos database.json antes de enviar o projeto para um repositório público como o GitHub. Para obter mais informações sobre o uso de variáveis de environment, leia configurações dinâmicas.

Agora você está pronto para usar o Strapi localmente ou para implantar seu projeto em um provedor de hospedagem externo e usar o MongoDB Atlas como servidor de database.