Befehlszeilenargumente für appcfg.sh

Das appcfg.sh-Tool erledigt eine Reihe von Aufgaben für die Anwendungsverwaltung, einschließlich Bereitstellen von Anwendungen und Aktualisieren der Datenspeicherindexe. Das appcfg-Tool ist im App Engine SDK enthalten, das Sie unter App Engine Java 8 SDK herunterladen und installieren können.

Nutzung: appcfg.sh [options] <action> [<app-dir>] [<argument>]

<app-dir> muss das Verzeichnis sein, das Ihre WAR-Datei enthält. Weitere Informationen finden Sie unter Anwendung bereitstellen.

Die Aktion muss eine der folgenden sein:
help: Hilfe für eine bestimmte Aktion ausdrucken.
download_app: Eine zuvor hochgeladene App-Version herunterladen.
request_logs: Anfragelogs im üblichen Apache-Logformat schreiben.
rollback: Führt für ein laufendes Update ein Rollback aus.
start_module_version: Startet die angegebene Modulversion.
stop_module_version: Stoppt die angegebene Modulversion.
update: Erstellt oder aktualisiert eine Anwendungsversion.
update_indexes: Aktualisiert Anwendungsindizes.
update_cron: Aktualisiert die Cronjobs der Anwendung.
update_queues: Aktualisiert Aufgabenwarteschlangen-Definitionen der Anwendung.
update_dispatch: Aktualisiert die Weiterleitungskonfiguration der Anwendung.
update_dos: Aktualisiert die DoS-Schutzkonfiguration der Anwendung.
version: Versionsinformationen drucken.
set_default_version: Standardversion für die Bereitstellung festlegen.
cron_info: Zeigt die Zeiten für die nächsten Durchläufe jedes Cronjobs an.
resource_limits_info: Ressourcenlimits anzeigen.
vacuum_indexes: Löscht nicht verwendete Indizes aus der Anwendung.
backends list: Aktuell konfigurierte Back-Ends auflisten.
backends update: Das angegebene Back-End oder alle Back-Ends aktualisieren.
backends rollback: Führt für ein zuvor laufendes Update ein Rollback aus.
backends start: Startet das angegebene Back-End.
backends stop: Angegebenes Back-End beenden.
backends delete: Löscht das angegebene Back-End.
backends configure: Konfiguriert das angegebene Back-End.
list_versions: Aktuell hochgeladene Versionen auflisten.
delete_version: Angegebene Version löschen.

Für eine ausführliche Beschreibung verwenden Sie 'help <action>'.

Optionen:

-s SERVER, --server=SERVER
Der Server, zu dem eine Verbindung hergestellt werden soll.
-e EMAIL, --email=EMAIL
Der zu verwendende Nutzername. Bei Auslassung erfolgt eine Eingabeaufforderung.
-H HOST, --host=HOST
Überschreibt den Hostheader, der mit allen RPCs gesendet wird.
-p PROXYHOST[:PORT], --proxy=PROXYHOST[:PORT]
Anfragen werden über den angegebenen Proxyserver geleitet. Wenn --proxy_https ebenfalls angegeben ist, wird hier nur HTTP über den Proxyserver geleitet, ansonsten HTTP und HTTPS.
--proxy_https=PROXYHOST[:PORT]
HTTPS-Anfragen werden über den angegebenen Proxyserver geleitet.
--no_cookies
Zugangsdaten werden nicht auf/von Festplatte gespeichert/geladen.
--sdk_root=root
Überschreibt den Speicherort des SDK.
--passin
Anmeldepasswort wird immer von stdin geschrieben.
-A APP_ID, --application=PROJECT_ID
Gibt die Projekt-ID an.
-M MODULE, --module=SERVICENAME
Überschreibt den Namen des Dienstes, der zuvor als "Module" bezeichnet wurde, aus den Dateien appengine-web.xml oder app.yaml.
-V VERSION, --version=VERSION
Überschreibt die Hauptversion von appengine-web.xml oder app.yaml
.
--oauth2
Wird ignoriert (OAuth2 ist Standardwert).
--noisy
Es werden wesentlich mehr Informationen über die Tätigkeit des Tools geloggt.
--enable_jar_splitting
Große JAR-Dateien (> 10 MB.) werden in kleinere Fragmente aufgeteilt.
--jar_splitting_excludes=SUFFIXES
Wenn --enable-jar-splitting festgelegt ist, werden Dateien, die mit der Liste der kommagetrennten SUFFIXES übereinstimmen, aus allen JAR-Dateien ausgeschlossen.
--disable_jar_jsps
Von JSPs generierte Klassen werden nicht in JAR-Dateien gefasst.
--enable_jar_classes
WEB-INF/Klasseninhalt wird in JAR-Dateien gefasst.
--delete_jsps
JSP-Quelldateien werden nach der Kompilierung gelöscht.
--retain_upload_dir
Beim Hochladen verwendetes temporäres (Staging-)Verzeichnis wird nicht gelöscht.
--compile_encoding
Die Zeichencodierung, die beim Kompilieren von JSPs verwendet werden soll.
-n NUM_DAYS, --num_days=NUM_DAYS
Anzahl der Tage, zu denen Logdaten abgerufen werden sollen. Der Grenzpunkt ist um Mitternacht UTC. Verwenden Sie 0, um alle verfügbaren Logs abzurufen. Standardwert ist 1.
--severity=SEVERITY
Schweregrad der abzurufenden Logmeldungen auf Anwendungsebene. Der Bereich ist 0 (FEHLER BEHEBEN) bis 4 (KRITISCH). Wird diese Option nicht angegeben, werden nur Anfragelogs zurückgegeben.
--include_all
Lognachrichten enthalten alles.
-a, --append
An vorhandene Datei anhängen.
-n NUM_RUNS, --num_runs=NUM_RUNS
Anzahl der geplanten Ausführungen für die Berechnung.
-f, --force
Ohne Aufforderung Löschen von Indexen erzwingen.
--no_usage_reporting
Nutzungsberichte deaktivieren.
--use_google_application_default_credentials
Google-Standardanmeldedaten für Anwendungen gemäß Beschreibung unter https://developers.google.com/identity/protocols/application-default-credentials verwenden.
--service_account_json_key_file=path
Speicherort der JSON-Schlüsseldatei des Dienstkontos für eine Anmeldung mit den Anmeldedaten des Dienstkontos. (Cloud SDK verwendet ~/.config/gcloud/application_default_credentials.json.)

Alternativen zur appcfg-Befehlszeile für die Staging-Konfiguration

Die Staging-Optionen für die Befehlszeile umfassen Folgendes:

  • --enable_jar_splitting
  • --jar_splitting_excludes=SUFFIXES
  • --disable_jar_jsps
  • --enable_jar_classes
  • --delete_jsps

Anstatt diese Befehlszeilenoptionen zu verwenden, kann es sich anbieten, die Staging-Konfiguration in der Anwendungskonfigurationsdatei festzulegen. Das heißt, dass Sie die Konfiguration für die Anwendung einmal festlegen können, anstatt bei jeder Bereitstellung die Konfiguration angeben zu müssen.