Pular para o conteúdo principal

Introdução

Para desenvolver e hospedar um aplicativo no Square Cloud, é essencial seguir uma sequência estruturada de configurações e pré-requisitos. Este guia técnico abordará todo o processo, desde a configuração inicial até a implantação em produção.

Pré-requisitos

  • Conta Square Cloud: Plataforma de hospedagem para seu aplicativo. Cadastre-se através da página de cadastro usando seu e-mail.
  • Plano Pago Ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.
Está se perguntando quanta RAM e CPU seu plano precisa para hospedar aplicações Django?
Não se preocupe, estamos aqui para ajudar. Nosso plano Standard oferece 4GB de RAM e 4vCPU, o que deve ser suficiente para a maioria dos aplicações Django. No entanto, se você estiver trabalhando em um projeto maior e precisar de mais estabilidade, recomendamos considerar nosso plano Pro. Com recursos adicionais, você pode manter a estabilidade mesmo durante picos de demanda. Para comprar, basta clicar aqui.

Criando o projeto

Para criar uma aplicação Django, você precisa ter o Python e o pip instalados no seu sistema antes de seguir os passos.

Instalando a biblioteca

Com o Python e o pip instalados, você pode criar um novo projeto Django. Primeiro, instale o Django usando o pip:
pip install django

Developing project

Em seguida, crie um novo arquivo Python (ex.: app.py) e adicione o seguinte código para criar uma aplicação Django básica:
app.py
from django.conf import settings
from django.http import HttpResponse
from django.urls import path
from django.core.wsgi import get_wsgi_application

# Configurações básicas do Django
settings.configure(
    DEBUG=False,                # Desabilitar modo de debug
    SECRET_KEY='mysecretkey',   # Definir sua chave secreta
    ALLOWED_HOSTS=['*'],        # Permitir todos os hosts para simplificar
    ROOT_URLCONF=__name__,      # Definir a configuração raiz de URL para este módulo
    MIDDLEWARE_CLASSES=(),      # Usar uma tupla vazia para desabilitar middleware
)

# View simples
def index(request):
    return HttpResponse("Hello world!")  # Retornar uma resposta HTTP simples

# Configuração de URL
urlpatterns = [
    path('', index),  # Mapear a URL raiz para a view index
]

# Aplicação WSGI
application = get_wsgi_application()

# Servidor WSGI
if __name__ == "__main__":
    from wsgiref.simple_server import make_server
    httpd = make_server('', 80, application)  # Servir a aplicação usando o servidor WSGI na porta 80
    print("Servidor Django executando na porta 80...")
    httpd.serve_forever()  # Iniciar o servidor
No código acima, criamos uma rota básica que retorna “Hello, World!” quando acessada. A aplicação está configurada para executar na porta 80, que é a porta padrão para tráfego HTTP. Em seguida, precisamos criar nosso arquivo de dependências. Em Python, temos o requirements.txt ou o pyproject.toml.

requirements.txt

Arquivo padrão usado em projetos Python para listar todas as bibliotecas externas e dependências necessárias para o seu projeto. Cada linha neste arquivo especifica um pacote a ser instalado usando o pip, o gerenciador de pacotes do Python.

pyproject.toml

Um arquivo de configuração moderno para projetos Python que permite especificar requisitos do sistema de compilação e metadados do projeto. É utilizado por ferramentas como o Poetry para gerenciar dependências e empacotamento.

Escolhendo um servidor de produção

O servidor de desenvolvimento integrado do Django não é adequado para uso em produção. Em vez disso, recomendamos o uso de um servidor WSGI pronto para produção, como o Gunicorn.

Deploying

Após preparar os arquivos do seu projeto, você pode enviá-los para o Square Cloud e hospedar seu projeto. Para isso, crie um arquivo ZIP contendo todos os arquivos do seu projeto.
Se você tiver um projeto Django que precise de migrações, certifique-se de aplicá-las antes de implantá-lo no Square Cloud. Você pode fazer isso executando o seguinte comando no seu ambiente local:
python manage.py migrate

Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.
2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar "Publicação na Web" e definir um subdomínio para o seu projeto.
3

Faça o deploy do projeto

Finally, click on the "Deploy" button to host your project on Square Cloud.
After deployment, you can monitor your project's status and logs from the dashboard.

Via CLI

Para usar esse método, você precisa criar um arquivo de configuração chamado squarecloud.app no diretório raiz do seu projeto. Esse arquivo conterá a configuração necessária para o seu projeto.

Saiba mais sobre: Como criar arquivo de configuração da Square Cloud.

O arquivo squarecloud.app é um arquivo de configuração que será usado para configurar seu aplicativo; ele será usado para definir seu ambiente.
1

Primeiro Passo

Primeiro, você precisa ter a CLI instalada em seu ambiente. Se você ainda não a possui, execute o seguinte comando em seu terminal:
npm install -g @squarecloud/cli
Se você já a possui, recomendamos atualizá-la. Para fazer isso, execute o seguinte comando em seu terminal:
squarecloud update
2

Segundo Passo

Agora, para autenticar e usar outros comandos da CLI, você encontrará sua chave de autorização aqui clicando em "Solicitar Chave da API". Após obter sua chave de autorização, execute o seguinte comando:
squarecloud auth login
3

Terceiro Passo

Finalmente, para fazer o deploy da sua aplicação para a Square Cloud usando a CLI, você precisa executar o seguinte comando:
squarecloud upload
Ou se já possui o zip criado:
squarecloud upload --file <caminho/para/zip>

Recursos Adicionais

Para mais informações sobre Django e suas ferramentas, visite a documentação oficial do Django. Lá, você encontrará guias detalhados, tutoriais e documentação da API para ajudá-lo a aproveitar ao máximo o Django.

Solução de Problemas

Domínio Personalizado

Para usar domínio personalizado (ex: meusite.com) ao invés da URL padrão https://meusite.squareweb.app/, você precisa do plano Standard ou superior. O subdomínio é definido pelo campo SUBDOMAIN no arquivo de configuração. Veja: Como configurar seu domínio personalizado.

Requisitos Mínimos de RAM

Mínimo: 512MB de RAM para websites/APIs simples. Para sites com frameworks (Next.JS, React, Vue, Angular, etc.), sugerimos sempre pelo menos 1GB de RAM. Para aplicações maiores, use mais RAM para evitar erro LACK_OF_RAM e garantir performance.

Não foi possível encontrar esse site.

Verifique se o subdomínio/domínio corresponde ao configurado no campo SUBDOMAIN ou nas configurações de domínio personalizado. Se você acabou de enviar o site, aguarde até 60 segundos para a Square liberar o primeiro acesso.

Site demorou demais para responder...

Verifique se configurou corretamente a porta 80 e host 0.0.0.0 na aplicação. Recomendamos usar as variáveis de ambiente forçadas da Square: PORT e HOST do arquivo .env.

Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão.