Pracujący aktor jest tylko biegiem czasu
An Apify Actor może działać z powodzeniem i nadal być produktem ubogim. Może zaakceptować nieograniczony wkład, emitować rekordy, których kształt zmienia się między biegami, wymagają nieudokumentowanych tajemnic, zdemaskować wewnętrzną diagnostykę jako wiersze dataset, lub nie mają bezpiecznego domyślnego dla recenzenta rynku. Żaden z tych problemów nie musi powstrzymać dewelopera od uruchomienia go ręcznie. Wszystkie z nich sprawiają, że Aktor trudno jest kupić, ocenić, automatyzacji i wsparcia.
Produkt rozpoczyna się, gdy runtime jest otoczony stabilną umową. Kupujący muszą zrozumieć, o co mogą poprosić, o co otrzymają, ile kosztów może kosztować, jak pusty wynik zachowuje się, i które referencje pozostają pod ich kontrolą. Operatorzy Marketplace potrzebują deterministycznych artefaktów, dowodów jakości, stanu publikacji i sposobu naprawy produktu bez zastępowania jego tożsamości.
To zamienia "rozmieszczanie tego skryptu" w cykl życia: źródło, politykę wejściową, umowę wyjściową, próbę, pakiet, ustalanie cen, zarządzanie jakością, notowanie publiczne, integracje i bieżące uzgadnianie.
Wybierz wąską obietnicę produktu
Tytuł Aktora powinien opisywać wynik zakupu, a nie ogólną zdolność do skrobania. Zawężona obietnica ułatwia każdą późniejszą decyzję: wybór źródła, pola wejściowe, schematy, przykładowe dane, dokumentacja, event cenowy i język wyszukiwania.
Określ wyraźnie rodzinę produktów. Monitor wycofania, wykrywacz ofert, standaryzator delegowania pracy, system wyszukiwania dostawców, monitoring cenowo-i-księgowy oraz prawny ekstraktor plików nie powinny wracać do jednego ogólnego schematu "danych". Każda rodzina potrzebuje własnych wymaganych pól i terminologii. Domeny Cross- tworzą pakiety, które technicznie zatwierdzają przy opisywaniu niewłaściwych produktów.
Obietnica określa również granicę źródła. Aktor gotowy do zakupu potrzebuje stabilnego adaptera i źródła, którego prawa, wzór dostępu i spodziewane wyjście są zgodne z zamierzonym wykorzystaniem komercyjnym. Jeżeli nie można tego ustalić, publikacja powinna się zatrzymać przed wygenerowaniem pakietu.
Związane z każdym wkładem publicznym
Publiczne wejścia są częścią umowy produktowej. Powinny być wpisywane, wyjaśnione, potwierdzone i ograniczone. URL wymagają protokołów i polityki hosta. Limity numeryczne wymagają minimów i maksimum. Mody wymagają wyraźnych enumów. Kwalifikacje fakultatywne wymagają dokładnych zasad przechowywania i przekazywania danych.
Bezpieczny domyślny bieg zasługuje na szczególną uwagę, ponieważ recenzenci i nabywcy po raz pierwszy będą go używać. Zentra- generowane Aktorzy używają jednoelementowego, nienaładowanego trybu próbkowania dla kontroli jakości bez nadzoru i rynku. Kolekcja na żywo jest dostępna tylko wtedy, gdy dzwoniący wybierze tryb live source i gotowe do zakupu wyjście.
To, że domyślnie ma kilka korzyści. To dowodzi, że Aktor rozpoczyna. To pokazuje umowę polową. To zapobiega automatycznej recenzji od uruchomienia kosztownego crawl. To produkuje deterministyczne dowody nawet, gdy źródło jest tymczasowo niedostępne. Co najważniejsze, nie udaje, że syntetyczna próbka jest wynik na żywo kupca.
Zaprojektuj najpierw umowę wyjściową produktu
Schemat zbioru danych nie powinien być przemyślany w zależności od tego, który wiersz pojawił się podczas testowania. Przed publikacją należy zdefiniować rodzinę rekordów buyer- facing: stabilny identyfikator, odpowiednie znaczniki czasu, wymagane pola domen, wartości opcjonalne, enumy, zagnieżdżone struktury, zachowanie zerowe i pola pochodzenia, które są bezpieczne do ujawnienia.
Z tej umowy, wygenerować skoordynowany zestaw artefaktów:
- schemat zbioru danych Actora;
- jeden deterministyczny, kompletny schemat wiersza próbnego;
- walidacja dla wierszy gotowych do zakupu na żywo;
- urządzenia dymne do kontroli opakowań;
- publiczną dokumentację terenową;
- definicje wyjściowe integracji dla przepływów roboczych Zapier, Arkusz lub GitHub.
Utrzymuj metadane dotyczące czasu pracy i cen poza zbiorem danych, chyba że należy do rekordu nabywcy. Zdarzenia obciążające, identyfikatory wewnętrzne, diagnostyka źródła i dowody jakości należą do manifestów, dzienników lub zapisów operacyjnych. Gdy ścisła walidacja zbioru danych widzi tę samą rodzinę w trybie próbkowym i live, przegląd rynku staje się bardziej przewidywalny.
Uczyń puste i częściowe wyniki uczciwymi
Aktor może działać poprawnie i nic nie znaleźć. Puste wyniki powinny pozostać puste, nie powinny być wyściełane rekordami demo, tak więc integracja wydaje się aktywna. Pakiety i doki powinny wyjaśniać, w jaki sposób reprezentowane są zerowe wyniki i które filtrują powszechnie zawężanie zbioru danych.
Częściowe błędy źródłowe wymagają również wyraźnej polityki. Zdecyduj, czy bieg się nie powiedzie, zwraca potwierdzone częściowe rekordy z ostrzeżeniem, czy czeka na ponowną próbę. Niezależnie od polityki, błędne wiersze nie mogą być naliczane jako pomyślna produkcja nabywcy. W wygenerowanym przez Zentra modelu runtime, zdarzenia cenowe wiążą się tylko z ważnymi umowami live wierszy, podczas gdy próbka, jakość, wewnętrzny, właściciel i niepoprawna działalność kontraktowa pozostaje poza rzeczywistymi dochodami nabywcy.
Połącz ustalanie cen z zatwierdzoną produkcją
Cena musi pasować do pracy i dostawy. Model per- result potrzebuje stabilnego zdarzenia i wyraźnej definicji rekordu obciążającego. Stałe pakiet potrzebuje deterministycznego archiwum i provider- rodzimej ceny. Pułap użytkowania musi zatrzymać bieg, zanim stworzy niekontrolowane koszty.
Dla aktora, udokumentuj domyślne zachowanie próbki, tryb live, maksymalne elementy, zdarzenie ładowania i zatrzymać warunek razem. Czas trwania powinien tłumić opłaty dla domyślnej próbki i ścieżki jakości. To powinno potwierdzić umowę wyjściową przed podłączeniem jakiegokolwiek sygnału pay- per- event.
Przewidywania i wewnętrzne operacje nigdy nie powinny być przedstawiane jako rzeczywiste przychody. Prawda przychodów zaczyna się od kwalifikującej się działalności nabywcy i rynkowych dowodów wypłaty, a nie z udanym zestawem danych QA.
Pakiet do instalacji i inspekcji
Pakiet Aktor gotowy do zakupu powinien być zrozumiały bez wywołania. Co najmniej potrzebuje pełnego manifestu Aktora, schematu wejściowego, schematu danych, stabilnej próbki, README, przykładów, limitów, poradnictwa kredytowego, changelog, wersji, licencji lub warunków użytkowania, rozwiązywania problemów i jasny opis państwa publicznego / prywatnego.
Dane archiwalne lub wdrożeniowe powinny być determinowane. Stabilne próbki i posortowane artefakty zachowują znaczenie kwot kontrolnych. Sekrety, lokalne ścieżki, identyfikatory dostawców surowców, prywatne zbiory danych i diagnostyka właściciela muszą pozostać poza pakietem.
Dokumentacja powinna odróżnić dane uwierzytelniające będące własnością kupującego od danych uwierzytelniających wydawcy. Integracje takie jak Zapier czy Arkusz Google mogą powołać się na aktora publicznego z tokerem kupującego Apify bez konieczności posiadania osobnego, płatnego konta Zentra. Token powinien być przechowywany w zatwierdzonym tajnym mechanizmie integracji i wysyłany tylko do dokładnego hosta Apify.
Udowodnij domyślny przebieg rynku
Lokalne testy jednostkowe są niezbędne, ale ścieżka rynkowa ma własny kontrakt. Uruchom wygenerowany pakiet z dokładnym domyślnym wejściem, które recenzent zobaczy. Potwierdź, że rozpoczyna się asynchronicznie, produkuje oczekiwaną próbkę jednego elementu, pisze do deklarowanego domyślnego zbioru danych, pasuje do schematu, pozostaje bez opłat, i ujawnia wystarczające dowody, aby zdiagnozować awarię bez wycieku danych prywatnych.
Kontrole jakości powinny obejmować oczywistą kompletność, ograniczone dane wejściowe, kompatybilność schematów, tryb pobierania próbek, zatrzymanie pobierania opłat, dokumentację, politykę źródłową, dostosowanie cen, pokrycie zadań i zdalną widoczność. Powtarzające się znaczące błędy mogą wstrzymać lub sprywatyzować notowanie, zachowując jednocześnie swoją zdalną tożsamość i historię. Limity stawek lub utrzymanie dostawcy powinny czekać i próbować ponownie; nie powinny one być błędnie zaklasyfikowane jako zły produkt.
Wydawane w drodze pojednania, nie zastępowania
Stan publikacji jest więcej niż publiczny lub prywatny. Płaszczyzna kontrolna powinna wiedzieć, czy pakiet jest generowany, zatwierdzony, przygotowany, złożony, w trakcie przeglądu, opublikowany, wstrzymany, odrzucony lub zarchiwizowany. Powinna ona również zachować zewnętrzny identyfikator Aktora, URL Sklepu, gdy jest dostępny, opublikowany znacznik czasu i pokrycie zadania.
Przed utworzeniem zdalnego Aktora lub zadania, pojednanie powinno szukać istniejącej tożsamości. Regeneracja powinna uaktualnić istniejący produkt i zachować status publiczny. Tymczasowa reakcja dostawcy nie powinna zdegradować opublikowanego wykazu. Pauza jakości powinna zachować historię, aby ten sam produkt mógł odzyskać, a nie ponownie pojawić się jako duplikat.
Zewnętrzne referencje i zatwierdzenie rynku pozostają zależne od działania. Aplikacja może przygotować, potwierdzić, kolejka, synchronizacja i naprawy produktu, ale nie może wynaleźć zatwierdzenia lub roszczenia działalności kupującego, który nie miał miejsca.
Lista kontrolna Aktora gotowego do zakupu
Aktor jest gotowy do przeglądu produktu, gdy każda odpowiedź jest specyficzna:
- Czy obietnica produktu jest wąska i możliwa do przeszukania?
- Czy źródło jest dozwolone i obsługiwane przez stabilny adapter?
- Czy środki publiczne są wpisane, udokumentowane i ograniczone?
- Czy domyślny bieg wytwarza jedną bezpieczną, determistyczną, nienaładowaną próbkę?
- Czy próbki i żywe rzędy spełniają tę samą umowę wyjściową produktu?
- Czy puste wyniki są uczciwe i nieprawidłowe wiersze wyłączone z opłat?
- Czy cena jest powiązana z określonym, zatwierdzonym zdarzeniem wyjściowym?
- Czy manifesty, schematy, doki, ograniczenia i rozwiązywanie problemów są zakończone?
- Czy dokładny domyślny przebieg rynkowy dostarczył dowody z zestawu danych?
- Czy publikacja może godzić i aktualizować istniejącą tożsamość na odległość?
- Czy dokumenty kupującego są oddzielone od dokumentów wydawcy?
- Czy jakość, dostawca i właściciele są inaczej sklasyfikowani?
Kiedy te bramy przechodzą razem, Aktor nie jest już tylko bieżącą. Jest kontrolowalny, pakowalny, publikowalny i utrzymywalny jako produkt danych.
