Zum Inhalt springen

Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen

Den Dienst schließen

Was du der Reihe nach tust, wenn du den Server nicht mehr betreibst: Nutzern erlauben, ihre Daten mitzunehmen, die Konten löschen, die auf anderen Servern übrig bleiben, dann den Server anhalten und auf eine statische Abschlussseite umschalten. Jeder Befehl ist ausführlicher unter Administratoren und Rollen beschrieben. Im Web-Client erledigt Administration > Server schließen dasselbe für alle mit manage_service_closure: Es kündigt die Schließung an, ändert ihre Termine oder zieht sie zurück; sobald das Schließdatum verstrichen ist, zeigt Prüfen und schließen, was check zeigt, und schließt den Server, nachdem du seine Domain eingetippt hast; danach zeigt es den Zustellfortschritt, den status zeigt.

Die Phasen der Einstellung des Dienstes von oben nach unten: was der Betreiber links tut und der Zustand des Servers rechts, mit dem Abschlussdatum und der Export-Frist dazwischen. Die Tabelle unten beschreibt jede Phase.

Die Tabelle folgt dem Diagramm von oben nach unten; die Spalte „Server“ beginnt mit dem Zustand, den my admin closure status zeigt. Das Abschlussdatum (-closes-at) beendet die Ankündigungsfrist, und die Export-Frist (-export-until, 30 Tage nach dem Abschlussdatum, sofern nicht gesetzt) beendet Phase 5.

Phase Server Was der Betreiber tut
1. Ankündigen announced. Läuft wie gewohnt. Registrierungen, Einladungen und neue Unterstützer-Abos enden my admin closure announce, eine Mitteilung auf der Statusseite veröffentlichen
2. Ankündigungsfrist announced. Läuft wie gewohnt. Nutzer können ihre Daten exportieren und zu einem anderen Server umziehen Jahresunterstützern das Geld erstatten, Umzüge und Aufbewahrungssperren prüfen
3. Schließen (nach dem Abschlussdatum) closed. Nutzer können sich nur anmelden und exportieren. Der Server stellt für jedes Konto ein Delete zu my admin closure check und close
4. Zustellung abgeschlossen Hält delivery_completed fest; lokale Actors geben außerdem 410 zurück Mit my admin closure status bestätigen. Die Worker nicht stoppen
5. Bis zur Export-Frist delivery_completed. Bleibt geschlossen und bietet weiter den Export an Die Datensätze unter Aufbewahrungssperren exportieren
6. Statische Seite Gestoppt. Das Front-End liefert die statische Seite und 410 für die Föderation my admin closure export-html, das Front-End umstellen, my serve stoppen
7. Verwerfen Keiner. Liefere die statische Seite und 410 noch etwa ein Jahr weiter aus Die DB, Blobs und Backups verwerfen. Die Domain etwa ein Jahr behalten

Du kannst jede Phase mit dem Wartungsmodus kombinieren (Wartung). Während der Wartung stoppen Exporte und die Zustellung von Delete-Aktivitäten.

Lege das Abschlussdatum (-closes-at) und die Frist fürs Mitnehmen der Daten (-export-until, 30 Tage nach dem Abschlussdatum, wenn weggelassen) fest und kündige sie dann an.

Terminal-Fenster
my admin closure announce -closes-at 2027-01-31T15:00:00Z -message "Thank you for being here."
my admin closure status
  • Das Abschlussdatum hat keine untere Grenze, aber eine Warnung erscheint, wenn die Zeit von der Ankündigung bis zum Abschlussdatum kürzer als 30 Tage ist. Gib den Nutzern Zeit zum Exportieren und Umziehen.
  • Um das Datum zu ändern, führe announce erneut aus; um abzusagen, führe my admin closure withdraw aus. Beides sendet jedem Nutzer eine Benachrichtigung service_closure.
  • Nach der Ankündigung wird der wirksame Registrierungsmodus closed, ausstehende Anträge werden abgelehnt, und jedes laufende Unterstützer-Abo wird zum Ende seines Zeitraums gekündigt (Abonnenten erhalten eine Benachrichtigung und eine E-Mail). Das Zurückziehen der Ankündigung macht die Ablehnungen und Kündigungen nicht rückgängig.
  • Benachrichtigungen werden von Jobs erzeugt, stoppe die Worker also nicht.
  • Veröffentliche auf der Statusseite (Überwachung und Statusseite) das Abschlussdatum, die Export-Frist und wie man exportiert und umzieht. Die Statusseite überlebt den Server, sie führt also auch Menschen, die nach der Einstellung vorbeikommen.
  • Nutzer können auf dem Einstellungsbildschirm ihre Daten exportieren (den Datenexport und die CSV-Dateien) und zu einem anderen Server umziehen (Move). Ein Banner auf jedem Bildschirm und eine Benachrichtigung zeigen das Abschlussdatum, die Export-Frist und den Weg zu diesem Bildschirm.
  • Jahresunterstützer: Die Ankündigung kündigt Abos zum Ende des Zeitraums, aber bei einem Abo, dessen Zeitraum nach dem Abschlussdatum endet, ist die Zeit, in der es nicht genutzt werden kann, bereits bezahlt. Der Server erstattet nichts, erstatte also jedem Abonnenten im Bildschirm des Zahlungsanbieters das Geld (in Stripe im Zahlungsbildschirm des Dashboards, in PAY.JP im Zahlungsbildschirm der Admin-Konsole) (Unterstützer-Zahlungen (Stripe), Unterstützer-Zahlungen (PAY.JP)).
  • Nachdem das Abschlussdatum verstrichen ist, erhalten Personen mit manage_service_closure eine Benachrichtigung admin_service_closure_due. Der Server schließt nicht von selbst.

Sobald das Abschlussdatum verstrichen ist, führe vor dem Schließen die Prüfungen aus.

Terminal-Fenster
my admin closure check
  • Unfertige Umzüge erzeugen eine Warnung. Warte, bis sie abgeschlossen sind, bevor du schließt, denn nach dem Schließen kann niemand mehr einen Move starten.

  • Aufbewahrungssperren (retention_holds) auf einem Konto erzeugen eine Warnung. Die Pflicht hinter einer Sperre endet nicht, wenn du den Server schließt, exportiere also die Datensätze unter einer Sperre und bewahre sie außerhalb des Servers auf (liste die Sperren mit my admin retention list auf).

    Terminal-Fenster
    my admin account export-moderation @alice > alice-moderation.json

Wenn die Prüfungen abgeschlossen sind, schließe. Das lässt sich nicht rückgängig machen. Bestätige durch Eingabe von y und dem Domainnamen (verwende in der Automatisierung -confirm-domain).

Terminal-Fenster
my admin closure close

Nach dem Schließen können Nutzer sich nur anmelden und ihre Daten exportieren. Die verbleibenden Unterstützer-Abos werden sofort gekündigt, und ein Delete (Actor) für jedes lokale Konto wird an andere Server zugestellt (auch wenn federation_mode off oder inbound ist). Die Inbox und GET-Anfragen auf Beiträge und Sammlungen geben 410 Gone zurück.

4. Bestätigen, dass die Zustellung abgeschlossen ist

Abschnitt betitelt „4. Bestätigen, dass die Zustellung abgeschlossen ist“

Stoppe my serve und die Worker (Prozesse, deren role all oder worker ist; bei einer Push-Queue die Cloud-Tasks-Queue) nicht, bevor der Zustand delivery_completed ist. Die Worker stellen die Delete-Aktivitäten zu, und solange sie das tun, liefert der Server weiter das Dokument und den Schlüssel des lokalen Actors aus, damit Empfänger die Signatur des Delete prüfen können. Wenn du zu früh stoppst, bleiben die Konten auf anderen Servern bestehen.

Terminal-Fenster
my admin closure status
  • accounts with a Delete ist die Zahl der Konten, für die ein Delete festgehalten wurde, fan-outs pending ist die verbleibende Fan-out-Arbeit, und deliveries <state> ist die Zahl der Zustellungen pro Zustand.
  • Zustellungen werden nach der üblichen Richtlinie wiederholt (bis zu 9 Mal über etwa 4 Tage). Wenn alle abgeschlossen sind, hält die Prüfung, die alle 10 Minuten läuft, delivery_completed fest (state: delivery_completed). Von da an geben auch die lokalen Actors und der Server-Actor 410 zurück.
  • Eine Zustellung, die dead wurde, wird nicht automatisch wiederholt. Um sie zu wiederholen, verwende my job retry.

Auch nach Abschluss der Zustellung läuft der Server geschlossen bis export_until weiter und bedient weiter die Exporte der Nutzer. Der Server löscht nie von selbst Daten, er läuft also über die Frist hinaus weiter, bis du ihn stoppst. Wenn du die Datensätze unter Aufbewahrungssperren (§3) noch nicht exportiert hast, tu es jetzt.

Exportiere nach Ablauf der Export-Frist die Abschlussseite. Das liest die Datenbank, führe es also aus, bevor du my serve anhältst und die Datenbank verwirfst.

Terminal-Fenster
my admin closure export-html -out ./closure # all locales; index.html starts from the instance's default locale
my admin closure export-html -out ./closure -lang ja,en # set the locales and the order in index.html
  • Was er schreibt:
    • <dir>/<locale>.html und <dir>/index.html, die alle Sprachen der Reihe nach auflistet. Sie verwenden dieselbe Vorlage und dasselbe CSS wie die Wartungsseite (my maintenance export) und zeigen den Servernamen (maintenance_server_name, sonst den Instanznamen, sonst den Hostnamen), das Schließdatum, die Nachricht des Betreibers aus der Ankündigung und einen Link zur Statusseite (status_page_url). Das CSS ist nur inline, es gibt keine Skripte oder externen Ressourcen, und die CSP steht in einem <meta>-Tag. Die Farbüberschreibungen des veröffentlichten Designs sind eingebaut.
    • Konfigurationsbeispiele für das Frontend: nginx.conf, Caddyfile und cloudfront-function.js. Jedes liefert 410 ohne Body für die Föderations- und Discovery-Pfade (/ap/*, /inbox, /.well-known/webfinger, /.well-known/host-meta, /.well-known/host-meta.json, /.well-known/nodeinfo, /nodeinfo/*) und für Profile (/@*), und für jeden anderen Pfad die Seite der ersten Sprache in Accept-Language (oder index.html, wenn es keine gibt). Eine Sprache erreicht die Seite der Locale, in der die App sie anzeigen würde: zh, zh-SG und zh-Hans erhalten zh-CN.html, und zh-Hant, zh-HK und zh-MO erhalten zh-TW.html.
  • Der Befehl verweigert, wenn der Server nicht geschlossen ist (Exit-Code 1). Vor delivery_completed warnt er, dass Zustellungen weiterlaufen (und schreibt die Dateien trotzdem).

Schalte das Frontend um. Lege nur die Seiten (*.html) an den öffentlichen Ort und passe Hostname, Verzeichnis und Zertifikatspfade im Beispiel an deine Umgebung an.

Frontend So richtest du es ein
nginx Lege die Seiten in /srv/closure und binde nginx.conf aus dem http-Block ein. Die Seiten werden ebenfalls mit 410 ausgeliefert
Caddy Lege die Seiten in /srv/closure und verwende das Caddyfile. Caddy besorgt das Zertifikat, und die Seiten werden ebenfalls mit 410 ausgeliefert
CloudFront Lege die Seiten direkt unter einen S3-Bucket, mache diesen Bucket zum Origin des Standard-Cache-Behaviors und verknüpfe cloudfront-function.js als CloudFront Function für Viewer-Requests (cloudfront-js-2.0). Nimm Accept-Language in den Cache-Key der Cache-Policy auf. Die Seiten werden mit 200 ausgeliefert (eine Viewer-Request-Funktion kann den Status der Antwort des Origins nicht ändern)

Prüfe nach dem Umschalten, dass curl -i https://social.example/.well-known/webfinger?resource=acct:alice@social.example 410 zurückgibt und dass curl -i https://social.example/ die Abschlussseite liefert. Halte dann my serve und die Worker an. Beende für die Verfügbarkeitsüberwachung entweder die Health-Check-Monitore oder richte sie auf die Abschlussseite.

Verwirf nach dem Stoppen die DB, die Blobs (Medien und Exportdateien), den KV-Store und die Queues samt ihren Backups und Snapshots. Mit einer Suchmaschine verwirfst du auch deren Index und Snapshots: Sie enthalten den Text von Beiträgen. Bestätige, bevor du irgendetwas verwirfst, noch einmal, dass du die Datensätze unter Aufbewahrungssperren exportiert und aufbewahrt hast. Das Verwerfen lässt sich nicht rückgängig machen.

Behalte die Domain und liefere die statische Seite und 410 noch etwa ein Jahr weiter aus. Andere Server sehen das 410, hören auf abzurufen und zuzustellen und leeren ihre Caches. Föderierte URIs verwenden UUIDs, es besteht also wenig Risiko, dass ein Actor mit derselben id erneut erstellt wird, aber wenn jemand anderes die Domain übernimmt, gehören das Handle (acct:alice@social.example) und die Profil-URLs ihm und können dazu dienen, deine Nutzer zu imitieren. Verlängere die Domain und das Zertifikat weiter, und überlege es dir noch einmal, bevor du die Domain aufgibst, auch nach Ablauf des Jahres.

Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt

Analyse auf dieser Website