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: 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

Por fim, clique no botão "Deploy" para hospedar seu projeto no Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no painel.

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