Un actor de lucru este doar timpul de funcționare
An Apify Actorul poate rula cu succes și încă să fie un produs slab. Acesta poate accepta un input nelegat, emite înregistrări ale căror modificări de formă între rulează, necesită secrete nedocumentate, expune diagnostice interne ca rânduri de set de date, sau nu au nici un default sigur pentru un revizor de piață. Niciuna dintre aceste probleme împiedică în mod necesar un dezvoltator să-l ruleze manual. Toate acestea fac Actor dificil de a cumpăra, evalua, automatiza, și suport.
Produsul începe atunci când timpul de funcționare este înconjurat de un contract stabil. Cumpărătorii trebuie să înțeleagă ce pot cere, ce vor primi, cât poate costa o cursă, cum se comportă un rezultat gol, și care acreditări rămân sub controlul lor. Operatorii de piață au nevoie de artefacte deterministe, dovezi de calitate, stare de publicare, și o modalitate de a repara produsul fără a înlocui identitatea sa.
Acest lucru se transformă într-un ciclu de viață: sursă, politica de intrare, contractul de ieșire, eșantion, pachet, preț, calitate rula, cotare publică, integrare și reconciliere continuă.
Alegeţi o promisiune de produs îngustă
Titlul Actorului ar trebui să descrie un rezultat al cumpărătorului, nu o capacitate generică de răzuire. O promisiune îngustă face ca fiecare decizie ulterioară să fie mai ușoară: selectarea sursei, câmpurile de intrare, schema, datele probelor, documentația, evenimentul de stabilire a prețurilor și limbajul de căutare.
Definește familia de produse în mod explicit. Un monitor de rechemare, găsitor de oferte, normalizator de postare a unui loc de muncă, furnizor de căutare, monitor de preț și stoc, și extractor legal de depunere nu ar trebui să scadă înapoi la o schema generică de date. Fiecare familie are nevoie de propriile câmpuri și terminologie necesare. defaults cross-domine crea pachete care valida tehnic în timp ce descrie produsul greșit.
Promisiunea stabilește, de asemenea, limita de sursă. Un actor pregătit să cumpere are nevoie de un adaptor stabil și o sursă ale cărei drepturi, model de acces și rezultate preconizate sunt compatibile cu utilizarea comercială preconizată. În cazul în care acest lucru nu poate fi stabilit, publicarea ar trebui să se oprească înainte de generarea pachetului.
Legat fiecare intrare publică
Intrările publice fac parte din contractul de produs. Acestea ar trebui să fie tastat, explicat, validat, și limitat. URL-urile au nevoie de protocoale permise și politica gazdă. Limitele numerice au nevoie de minime și maxime. Modurile au nevoie de enumuri explicite. Acreditările opționale au nevoie de reguli precise de stocare și transmitere.
O rulare implicită în condiții de siguranță merită o atenție specială, deoarece revizorii și cumpărătorii pentru prima dată o vor folosi. Zentra-actorii generați utilizează un mod explicit cu un singur element, neîncărcat pentru verificarea calității și a pieței nesupravegheate. Colecția live este disponibilă numai atunci când apelantul selectează modul sursă live și producția pregătită de cumpărător.
Acest implicit are mai multe beneficii. Aceasta dovedește că Actorul începe. Ea demonstrează contractul de teren. Aceasta împiedică o revizuire automată de la lansarea unui crawl scump. Ea produce dovezi deterministe chiar și atunci când sursa live este temporar indisponibil. Cel mai important, nu pretinde că un eșantion sintetic este un rezultat de cumpărător viu.
Proiectați mai întâi contractul de ieșire a produsului
Schema setului de date nu ar trebui să fie un gând ulterior generat din oricare rând a apărut în timpul încercării. Definește familia de înregistrări cu care se confruntă cumpărătorul înainte de publicare: identificator stabil, marcaje temporale relevante, câmpuri de domenii necesare, valori opționale, enums, structuri cuiburi, comportament nul și câmpuri de proveniență care sunt sigure pentru a fi expuse.
Din acest contract, se generează un set coordonat de artefacte:
- schema setului de date Actor;
- un rând de probă determinist, schema-complet;
- validare pentru rândurile gata de cumpărare în viață;
- dispozitive de reglare a fumului pentru verificarea pachetelor;
- documentația publică pe teren;
- definiții ale rezultatelor integrării pentru fluxurile de lucru Zapier, Sheets sau GitHub.
Păstrați timpul de funcționare și metadatele tarifare din setul de date, cu excepția cazului în care aparține înregistrării cumpărătorului. Evenimente de încărcare, identificatori interni de funcționare, diagnostice de sursă și dovezi de calitate aparțin în manifeste, jurnale sau înregistrări operaționale. Atunci când validarea strictă a setului de date vede aceeași familie de câmp în modurile de eșantionare și live, revizuirea pieței devine mai previzibilă.
Faceți rezultatele goale și parțiale cinstit
Un Actor poate rula corect și să găsească nimic. Rezultatele goale ar trebui să rămână goale, nu să fie căptușite cu înregistrări demo, astfel încât o integrare pare activă. Pachetul și docurile ar trebui să explice modul în care rezultatele zero sunt reprezentate și care filtre în mod obișnuit îngustați setul de date.
Eşecurile parţiale ale sursei necesită, de asemenea, o politică explicită. Decide dacă rularea eşuează, returnează înregistrările parţiale validate cu un avertisment sau aşteaptă rejudecarea. Indiferent de politică, rândurile invalide nu trebuie să fie taxate ca rezultat de cumpărător de succes. În modelul de termen generat de Zentra, evenimentele tarifare se ataşează doar la rândurile live valide, în timp ce eşantionul, calitatea, activitatea internă, proprietară şi activitatea nevalidă rămâne în afara veniturilor reale ale cumpărătorului.
Conectarea prețurilor la producția validată
Un model per rezultat are nevoie de un eveniment stabil şi o definiţie clară a unui record exigibil. Un pachet fix are nevoie de o arhivă deterministă şi un preţ de furnizor-nativ. Un plafon de utilizare trebuie să oprească rularea înainte de a crea costuri necontrolate.
Pentru un actor, documentaţi comportamentul implicit al eşantionului, modul live, elementele maxime, încărcarea şi oprirea condiţiei împreună. Timpul de funcţionare ar trebui să suprime taxele pentru eşantionul implicit şi căile de calitate. Aceasta ar trebui să valideze contractul de ieşire înainte de a ataşa orice semnal pay-per-eveniment.
Previziunile și rulările interne nu ar trebui să fie prezentate ca venituri reale. Adevărul veniturilor începe cu activitatea de cumpărător eligibil și dovezile de plată ale pieței, nu cu un set de date QA de succes.
Pachet pentru instalare și inspecție
Un pachet de actor gata de cumpărător ar trebui să fie ușor de înțeles fără un apel. Cel puțin are nevoie de un manifest complet Actor, schema de intrare, schema de setare, eșantion stabil, README, exemple, limite, orientări credibile, Changelog, versiune, condiții de licență sau utilizare, depanare, și o descriere clară a statului public/privat.
Arhiva sau punerea în aplicare sarcină utilă ar trebui să fie determinist. Probe stabile și artefacte sortate păstrează checkums semnificative. Secrete, căi locale, identificatori de furnizor brut, seturi de date private, și diagnosticul proprietarului trebuie să rămână în afara pachetului.
Documentaţia ar trebui să distingă acreditările deţinătoare de cumpărător de acreditările editorului. Integrari cum ar fi Zapier sau Google Sheels pot invoca un actor public cu Apify jetonul cumpărătorului fără a necesita un cont Zentra plătit separat. Jetonul ar trebui să fie stocat prin mecanismul secret aprobat de integrare şi trimis doar către gazda exactă Apify.
Dovedește funcționarea implicită a pieței
Testele unității locale sunt necesare, dar calea pieței are propriul contract. Rulați pachetul generat cu intrarea implicită exactă pe care o va vedea un revizor. Confirmați că începe asincronizat, produce eșantionul așteptat cu un singur punct, scrie la setul de date implicit declarat, se potrivește schema, rămâne neîncărcat, și expune suficiente dovezi pentru a diagnostica eșecul fără scurgeri de date private.
Controalele de calitate ar trebui să acopere integralitatea manifest, intrările delimitate, compatibilitatea schema, modul de eșantionare, oprirea limita de încărcare, documentarea, politica sursă, alinierea prețurilor, acoperirea sarcinilor și vizibilitatea la distanță. Eșecurile semnificative repetate pot întrerupe sau privatiza o listă în timp ce păstrează identitatea și istoria la distanță. Limitele ratei de furnizor sau de întreținere ar trebui să aștepte și să redea; acestea nu ar trebui să fie clasificate în mod eronat ca un produs rău.
Publică prin reconciliere, nu prin înlocuire
Starea de publicare este mai mult decât publică sau privată. Planul de control ar trebui să știe dacă pachetul este generat, validat, pregătit, prezentat, în curs de revizuire, publicat, oprit, respins, sau arhivat. Acesta ar trebui să păstreze, de asemenea, identificatorul Actor extern, URL-ul magazinului atunci când sunt disponibile, timbru de timp publicat, și acoperirea sarcinii.
Înainte de a crea un actor sau o sarcină la distanță, reconcilierea ar trebui să caute o identitate existentă. Regenerarea ar trebui să actualizeze produsul existent în loc și să păstreze statutul public. Un răspuns temporar furnizor nu ar trebui să demote o listă publicată. O pauză de calitate ar trebui să păstreze istoria astfel încât același produs poate recupera mai degrabă decât reapare ca un duplicat.
Acreditările externe și aprobarea pieței rămân dependențe operaționale. Cererea poate pregăti, valida, coada, sincroniza și repara produsul, dar nu poate inventa o aprobare sau revendica activitatea cumpărătorului care nu s-a întâmplat.
O listă de verificare a unui actor gata să cumpere
Un actor este gata pentru revizuirea produsului atunci când fiecare răspuns este specific:
- Promisiunea produsului este îngustă şi poate fi căutată?
- Sursa este permisă și susținută de un adaptor stabil?
- Sunt intrările publice tastate, documentate și delimitate?
- Rula implicită produce o mostră sigură, deterministă, neîncărcată?
- Proba și rândurile live satisfac același Contract de ieșire a produsului?
- Rezultatele goale sunt corecte și nu sunt excluse de la plata taxelor?
- Este prețul legat de un eveniment de ieșire definit, validat?
- Manifestările, schemele, doctorii, limitele şi problemele sunt complete?
- S-au produs probe de date exacte privind starea de nerambursare a pieței?
- Poate publicarea să reconcilieze și să actualizeze o identitate la distanță existentă?
- Acreditările cumpărătorului sunt separate de acreditările editorilor?
- Sunt clasificate în mod diferit eșecurile de calitate, furnizor și proprietar-acțiune?
Atunci când aceste porți trec împreună, Actorul nu mai este pur și simplu runnable. Este inspectabil, ambalat, publicabil, și poate fi întreținut ca un produs de date.
