Passo a passo: Como instalar e configurar o Dokku no seu servidor

O Dokku é uma ferramenta poderosa para simplificar o deploy de aplicações, permitindo que você utilize seu próprio servidor para hospedar aplicações de forma eficiente e com controle total. Este guia prático mostra como instalar e configurar o Dokku em um servidor Ubuntu, além de explicar como criar aplicações e configurar domínios.

Requisitos

Antes de começar, verifique se você possui:

1. Um servidor rodando Ubuntu (20.04/22.04/24.04) ou Debian 11+ x64.
2. Acesso root ou a um usuário com permissões de sudo.
3. Um domínio configurado (opcional, mas recomendado para produção).

1. Atualizando o servidor

Antes de instalar o Dokku, é importante garantir que seu sistema esteja atualizado:

sudo apt update && sudo apt upgrade -y

2. Instalando o Dokku

Adicionando o repositório oficial

Dokku pode ser instalado através do script oficial. Execute o comando abaixo:

wget -NP . https://dokku.com/install/v0.35.12/bootstrap.sh
sudo DOKKU_TAG=v0.35.12 bash bootstrap.sh

Substitua v0.35.12 pela versão mais recente, caso necessário.

Configurando o hostname (opcional)

Durante a instalação, você será solicitado a configurar o hostname do servidor. Utilize o domínio que você configurou ou o IP do servidor.

Configurando chaves SSH

Você também será solicitado a adicionar chaves SSH para autenticação. Isso permite que você envie código para o Dokku via git push.

cat ~/.ssh/authorized_keys | dokku ssh-keys:add admin

dokku domains:set-global seu-servidor.com.br

3. Criando sua primeira aplicação

Com o Dokku instalado, criar uma aplicação é simples:

Criando a aplicação no servidor:

dokku apps:create minha-aplicacao

Adicionando o repositório remoto ao seu projeto

No diretório do seu projeto local, execute:

git remote add dokku [email protected]:minha-aplicacao

Fazendo o deploy da aplicação:

git push dokku main

O Dokku automaticamente detecta a linguagem, instala dependências e inicia sua aplicação.

4. Configurando um banco de dados (opcional)

Se sua aplicação precisar de um banco de dados, você pode adicioná-lo com plugins do Dokku. Por exemplo, para PostgreSQL:

Instalando o plugin

sudo dokku plugin:install https://github.com/dokku/dokku-postgres.git

Criando um banco de dados

dokku postgres:create minha-base

Vinculando o banco à aplicação

dokku postgres:link minha-base minha-aplicacao

5. Configurando um domínio

Para acessar sua aplicação com um domínio personalizado:

Configurando o domínio na aplicação

dokku domains:add minha-aplicacao www.meudominio.com

Configurando o DNS

No painel do seu provedor de domínio, aponte um registro A ou CNAME para o IP do seu servidor.

Habilitando SSL com Let’s Encrypt

Instale o plugin Let’s Encrypt e configure SSL para sua aplicação.

sudo dokku plugin:install https://github.com/dokku/dokku-letsencrypt.git

dokku letsencrypt minha-aplicacao

dokku letsencrypt:cron-job --add

6. Testando sua aplicação

Acesse seu domínio ou IP configurado para verificar se sua aplicação está funcionando corretamente. Se tudo foi configurado como descrito, sua aplicação estará online e pronta para uso.

Conclusão

Instalar e configurar o Dokku é um processo direto que oferece grande controle e flexibilidade para deploys de aplicações. Com poucos passos, você transforma seu servidor em uma plataforma poderosa e eficiente para hospedar seus projetos. Experimente o Dokku e simplifique sua infraestrutura de deploy! Caso tenha dúvidas ou precise de suporte, entre em contato conosco.