5. Instalação

Este guia irá ajudá-lo a configurar o ambiente MINECRAFT - FGA - 2025/1 em sua máquina local.

5.1. Pré-requisitos

Antes de começar, certifique-se de ter os seguintes softwares instalados:

  • Docker (versão 20.10 ou superior)

  • Docker Compose (versão 2.0 ou superior)

  • Git (para clonar o repositório)

5.2. Instalação do Docker

5.3. Clonando o Repositório

  1. Clone o repositório:

    git clone https://github.com/SBD1/2025.1-Minecraft.git

  2. Acesse o diretório:

    cd 2025.1-Minecraft

5.4. Configuração do Ambiente

  1. Construa e inicie os containers:

    docker-compose up -d –build

  2. Aguarde alguns segundos para que o banco de dados seja inicializado

  3. Verifique se os containers estão rodando:

    docker-compose ps

Você deve ver algo como:

NAME                    COMMAND                  SERVICE             STATUS              PORTS
2025_1_Minecraft        "docker-entrypoint.s…"   db                  Up                  0.0.0.0:5433->5432/tcp
python_mine            "python"                  app                 Up                  0.0.0.0:8000->8000/tcp

5.5. Verificação da Instalação

Para verificar se tudo está funcionando:

  1. Acesse o container da aplicação:

    docker exec -it python_mine bash

  2. Execute o jogo:

    python main.py

  3. Você deve ver a tela inicial do MINECRAFT - FGA - 2025/1

Se tudo estiver funcionando, você verá uma mensagem como:

╔══════════════════════════════════════════════════╗
║         🟩 MINECRAFT - FGA - 2025/1              ║
║              Python Edition                      ║
╚══════════════════════════════════════════════════╝

5.6. Solução de Problemas

5.6.1. Problema: Erro de conexão com banco de dados

Sintomas: Mensagem “Falha na conexão com o banco de dados”

Solução:

  1. Verifique se os containers estão rodando:

    docker-compose ps

  2. Se não estiverem, reinicie:

    docker-compose down docker-compose up -d

  3. Aguarde alguns segundos e tente novamente

5.6.2. Problema: Porta 5433 já em uso

Sintomas: Erro ao subir containers

Solução:

  1. Edite o arquivo docker-compose.yml e mude a porta:

    ports:

    • “5434:5432” # Mude de 5433 para 5434

  2. Reinicie os containers:

    docker-compose down docker-compose up -d

5.6.3. Problema: Permissões no Linux

Sintomas: Erro de permissão ao executar docker

Solução:

  1. Adicione seu usuário ao grupo docker:

    sudo usermod -aG docker $USER

  2. Faça logout e login novamente

  3. Ou execute com sudo (não recomendado):

    sudo docker-compose up -d

5.7. Próximos Passos

Após a instalação bem-sucedida, você pode: