跳转到主要内容

简介

要在 Square Cloud 上开发和托管 ,遵循一套结构化的配置和前置条件流程至关重要。本技术指南将涵盖整个过程,从初始设置到生产环境部署。

前置条件

  • Square Cloud 账户:通过注册页面使用你的邮箱进行注册。
  • 有效的付费套餐:为你的应用提供专属资源和优化的性能。查看我们可用的套餐,选择最适合你需求的方案。

创建项目

要创建 Django 应用,在按照以下步骤操作之前,你的系统上需要安装 Python 和 pip。

安装库

安装好 Python 和 pip 后,你就可以创建一个新的 Django 项目。首先,使用 pip 安装 Django:
pip install django

开发项目

创建一个新的 Python 文件(例如 app.py),并添加以下代码来创建一个基础的 Django 应用:
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

# Basic Django settings
settings.configure(
    DEBUG=False,                # Disable debug mode
    SECRET_KEY='mysecretkey',   # Define your secret key
    ALLOWED_HOSTS=['*'],        # Allow all hosts for simplicity
    ROOT_URLCONF=__name__,      # Set the root URL configuration to this module
    MIDDLEWARE_CLASSES=(),      # Use an empty tuple to disable middleware
)

# Simple view
def index(request):
    return HttpResponse("Hello world!")  # Return a simple HTTP response

# URL configuration
urlpatterns = [
    path('', index),  # Map the root URL to the index view
]

# WSGI application
application = get_wsgi_application()

# WSGI server
if __name__ == "__main__":
    from wsgiref.simple_server import make_server
    httpd = make_server('', 80, application)  # Serve the application using WSGI server on port 80
    print("Django server running on port 80...")
    httpd.serve_forever()  # Start the server
在上面的代码中,我们创建了一个基础路由,访问时会返回 “Hello, World!”。该应用被配置为在 80 端口上运行,这是 HTTP 流量的默认端口。 接下来,我们需要创建依赖文件。在 Python 中,我们可以使用 requirements.txt 或 pyproject.toml。

选择生产服务器

Django 内置的开发服务器不适合用于生产环境。相反,我们建议使用像 Gunicorn 这样面向生产的 WSGI 服务器。

Gunicorn

Gunicorn 是一个用于 UNIX 的 Python WSGI HTTP 服务器。它采用预派生(pre-fork)工作进程模型,会派生多个工作进程来处理请求。 这使它成为在生产环境中运行 Python Web 应用的绝佳选择。

部署

准备好项目文件后,你现在可以将它们上传到 Square Cloud 并托管你的项目。 为此,请创建一个包含所有项目文件的 ZIP 文件。
如果你的 Django 项目需要应用迁移,请确保在部署到 Square Cloud 之前完成迁移。
你可以在本地环境中运行以下命令来完成:
python manage.py migrate

通过控制面板

1

访问上传页面

访问上传页面并上传你的项目 zip 文件。
2

配置你的环境

上传 zip 后,你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目,请务必选择 “Web Publication” 并为项目设置子域名。
3

部署你的项目

最后,点击 “Deploy” 按钮,即可将项目托管到 Square Cloud。
部署完成后,你可以在控制面板中监控项目的状态和日志。
正在上传应用到 Square Cloud

通过 CLI

要使用此方法,你需要在项目根目录中创建一个名为 squarecloud.app 的配置文件。该文件将包含项目所需的配置。

了解更多:如何为 Square Cloud 创建配置文件。

squarecloud.app 文件是一个配置文件,用于配置你的应用;它将用于定义你的环境。
1

安装 CLI

首先,你的环境中需要已安装 CLI。如果尚未安装,请在终端中运行以下命令:
npm install -g @squarecloud/cli
如果你已经安装,我们建议对其进行更新。为此,请在终端中运行以下命令:
squarecloud update
2

进行身份验证

现在,要进行身份验证并使用其他 CLI 命令,你可以在此处点击 “Request API Key” 找到你的授权密钥。获取授权密钥后,运行以下命令:
squarecloud auth login
3

上传你的项目

最后,要使用 CLI 将应用部署到 Square Cloud,你需要运行以下命令:
squarecloud upload 
或者,如果你手动创建了 zip 文件,可以使用:
squarecloud upload --file <path/to/zip> 

更多资源

有关 Django 及其工具的更多信息,请访问 Django 官方文档。 在那里,你将找到详细的指南、教程和 API 文档,帮助你充分利用 Django。

故障排查

自定义域名

若要使用自定义域名(例如 mysite.com)来代替默认 URL mysite.squareweb.app,你需要 Standard 计划或更高等级。子域名由配置文件中的 SUBDOMAIN 字段定义。

最低内存要求

简单网站/API 的最低要求为 512MB RAM。对于使用框架的站点(Next.JS、React、Vue、Angular 等),我们始终建议至少 1GB RAM。对于更大型的应用,请分配更多 RAM,以防止应用内存耗尽而崩溃。

找不到此站点。

请检查子域名/域名是否与 SUBDOMAIN 字段或自定义域名设置中配置的内容一致。如果你刚上传站点,请等待最多 60 秒,让 Square 启用首次访问

站点响应超时……

请检查你是否在应用中正确配置了端口 80主机 0.0.0.0。我们建议使用 Square 强制注入的环境变量:来自 .env 文件的 PORTHOST

联系我们

如果你仍然遇到技术问题,我们的专业支持团队可以为你提供帮助。联系我们,我们很乐意协助你解决任何问题。