Przejdź do treści

Migracja z PrintNode do CloudPrint

Migracja z PrintNode to zmiana kontraktu API i sposobu działania, a nie podmiana nazw endpointów. Najpierw opisz przypisania drukarek, formaty, retry i statusy, a potem przenoś po jednym kontrolowanym procesie.

Zrób inwentaryzację

Zbierz lokalizacje, komputery, drukarki, typy dokumentów, opcje i awarie. Zapisz, gdzie są ID, jak działa offline i czy retry może utworzyć duplikat. To kryteria akceptacji CloudPrint.

Odwzoruj pojęcia

W CloudPrint agent ujawnia kolejki, backend zapisuje printer_id, przesyła PDF lub RAW, tworzy zadanie, zapisuje print_job_id i czyta status. Starych ID nie można użyć: połącz agentów i pozwól administratorowi jawnie wybrać nowe drukarki.

Zmień auth i retry

Użyj OAuth2 Client Credentials z minimalnymi scopes. Każdej operacji nadaj stabilny Idempotency-Key. Po timeout odtwórz lub powtórz pierwotne żądanie zamiast tworzyć niezależne drugie zadanie.

Uruchom reprezentatywny pilot

Wybierz jedną lokalizację, model drukarki i ważny dokument. Porównaj rozmiar, kopie, wyrównanie, czas do statusu końcowego i offline. Uwzględnij interfejs operatora oraz dane dla wsparcia.

Przełącz bez podwójnego wysyłania

Zachowaj możliwość powrotu, ale każdą operację kieruj tylko do jednego dostawcy. Monitoruj błędy, czas i reprinty. Po stabilizacji unieważnij stare sekrety i usuń kod, który mógłby wysłać dokument dwa razy.

Lista kontrolna przed wdrożeniem

  • Odwzoruj urządzenia, drukarki i statusy poprzedniego dostawcy na identyfikatory CloudPrint.
  • Przeprowadź kontrolowane przełączenie z okresem umożliwiającym wycofanie zmian.
  • Jawnie obsługuj status końcowy, ponowienia i ochronę przed podwójnym drukiem.
  • Zapisuj identyfikatory zadań i przyczyny błędów na potrzeby wsparcia i monitoringu.

Następne kroki

Przewodniki dotyczące integracji CloudPrint, podłączania lokalnego agenta i obsługi procesów drukowania.