🚀 Einführung
- Stelle vor dem Start sicher, dass Python auf deinem System installiert ist. Falls du es noch nicht hast, kannst du es von der offiziellen Python-Website herunterladen.
- Anschließend musst du ein Konto bei Square Cloud erstellen, was über die Anmeldeseite möglich ist. Du kannst dein Konto per E-Mail, GitHub oder beidem erstellen.
- Schließlich benötigst du einen aktiven kostenpflichtigen Plan in deinem Konto. Du kannst unsere Pläne ansehen und je nach Bedarf einen hier kaufen.
⚙️ Konfiguration der squarecloud.app-Datei
Wenn du deine Anwendung über die Square Cloud Website hochlädst, kannst du diesen Abschnitt ignorieren. Die Website erstellt die
squarecloud.app Konfigurationsdatei automatisch für dich.Mehr erfahren: So erstellst du die Konfigurationsdatei für Square Cloud.
Die squarecloud.app Datei ist eine Konfigurationsdatei, die zur
Konfiguration deiner Anwendung verwendet wird; sie dient dazu, den Namen, die
Beschreibung, die Version, die Hauptdatei und weiteres zu definieren.
📄 Erforderliche Dateien
-
Wenn das Feld
STARTin der Konfigurationsdatei nicht definiert ist, führt Square Cloudpython MAINaus, um die inMAINangegebene Python-Datei auszuführen. Ist das FeldSTARTin der Konfigurationsdatei definiert, wird der darin enthaltene Wert direkt ausgeführt. Weitere Informationen zu den Parametern der Konfigurationsdatei findest du unter Konfigurationsparameter. -
Square Cloud verwendet
pip install, um alle inrequirements.txtaufgeführten Abhängigkeiten zu installieren.
🖥️ Vorbereitung des Projekts
📁 Wesentliche Konfigurationsdateien
Wenn du dein Python-Projekt für den Deploy auf Square Cloud vorbereitest, stelle sicher, dass du die Konfigurationsdatei (squarecloud.app/.config) und die wesentlichen Dateien deiner Anwendung in einer ZIP-Datei einschließt.
🗑️ Dateien, die vor dem Hochladen auszuschließen sind
ffmpeg: Diese Software ist in der Square-Cloud-Umgebung vorinstalliert, daher ist es nicht notwendig, sie in dein Projekt aufzunehmen..venv: Dieser Ordner enthält die virtuelle Umgebung deines Projekts. Square Cloud stellt eine isolierte Umgebung bereit, sodass es nicht nötig ist, diesen Ordner hochzuladen.poetry.lock: Da Square Cloud derzeit Poetry nicht unterstützt, sollte diese Datei ausgeschlossen werden, um Kompatibilitätsprobleme beim Deploy zu vermeiden.
🤔 Warum diese Dateien ausschließen?
Das Ausschließen vonffmpeg, .venv und poetry.lock ist aus mehreren Gründen wichtig:
- Saubere Umgebung: Square Cloud erstellt eine neue Umgebung für dein Projekt. Diese Dateien einzuschließen ist unnötig und kann zu Konflikten mit den Konfigurationen der Cloud-Umgebung führen.
- Effizienz: Das Entfernen dieser Dateien verringert die Upload-Größe und macht den Vorgang schneller und schlanker.
-
Kompatibilität: Das Ausschließen von
poetry.lockvermeidet Kompatibilitätsprobleme, da Square Cloudrequirements.txtzur Installation der Abhängigkeiten verwendet.
📄 Erforderliche Dateien
- main.py (Beispiel für die Hauptdatei).
- requirements.txt (Abhängigkeitsdatei).
- ODER [pyproject.toml] (Abhängigkeitsdatei).
- squarecloud.app (Datei mit der Square-Cloud-Konfiguration).
💡 Fehlerbehebung
Die Hauptdatei ist ungültig oder beschädigt
Die Hauptdatei ist ungültig oder beschädigt
Dieser Fehler tritt auf, wenn die als “main” für deine Anwendung
in der Konfigurationsdatei definierte Datei nicht existiert, falsch
geschrieben ist oder der Pfad falsch ist. Wenn sich deine Hauptdatei in einem
Ordner befindet, gib zum Beispiel
folder/file.py an.Nicht genügend Arbeitsspeicher
Nicht genügend Arbeitsspeicher
Die minimale Menge an RAM, die zum Hosten eines Bots erforderlich ist, beträgt 256MB und für
eine Website/API 512MB. Je nach Größe und Komplexität deiner
Anwendung kann es jedoch ratsam sein, eine größere Menge RAM zuzuweisen, um zu
vermeiden, dass deiner Anwendung der Arbeitsspeicher ausgeht und sie abstürzt.
📤 So hostest du dein Projekt
Nachdem du nun alle Dateien für dein Python-Projekt vorbereitet hast, besteht der nächste Schritt darin, sie auf Square Cloud hochzuladen und deine Anwendung online zu stellen. Es gibt mehrere Möglichkeiten zum Hochladen, aber wir behandeln zwei: über das Dashboard oder über die CLI.Über das Dashboard
Upload-Seite aufrufen
Rufe die Upload-Seite auf und lade die ZIP-Datei deines Projekts hoch.
Umgebung konfigurieren
Nachdem du deine ZIP-Datei hochgeladen hast, musst du den Namen, die Hauptdatei oder Runtime-Umgebung und weitere Einstellungen für dein Projekt konfigurieren.
Wenn du ein Web-Projekt hochlädst, achte darauf, “Web Publication” auszuwählen und deinem Projekt eine Subdomain zuzuweisen.
Wenn du ein Web-Projekt hochlädst, achte darauf, “Web Publication” auszuwählen und deinem Projekt eine Subdomain zuzuweisen.
Über die CLI
Um diese Methode zu nutzen, musst du eine Konfigurationsdatei mit dem Namensquarecloud.app im Stammverzeichnis deines Projekts erstellen. Diese Datei enthält die notwendige Konfiguration für dein Projekt.
Mehr erfahren: So erstellst du die Konfigurationsdatei für Square Cloud.
Die Datei squarecloud.app ist eine Konfigurationsdatei, mit der deine Anwendung konfiguriert wird; sie dient dazu, deine Umgebung zu definieren.
CLI installieren
Zuerst musst du die CLI in deiner Umgebung installiert haben. Falls du sie noch nicht hast, führe den folgenden Befehl in deinem Terminal aus:Falls du sie bereits hast, empfehlen wir, sie zu aktualisieren. Führe dazu den folgenden Befehl in deinem Terminal aus:
- Windows
- Linux, macOS und WSL
Authentifizieren
Um dich zu authentifizieren und weitere CLI-Befehle zu nutzen, findest du deinen Autorisierungsschlüssel hier, indem du auf “Request API Key” klickst. Nachdem du deinen Autorisierungsschlüssel erhalten hast, führe den folgenden Befehl aus: