Popoln vodnik po Activepieces: Inteligentna avtomatizacija in agenti umetne inteligence

Posodabljanje ActivePieces ni zgolj stvar prenosa nove slike in ponovnega zagona vsebnika. Platforma prihrani tokovi, povezave, izvedbe in šifrirane skrivnosti v različnih komponentah, zato lahko sprememba, narejena brez varnostne kopije, pusti na videz delujočo namestitev, vendar brez dostopa do vaših poverilnic ali avtomatizacije.

Postopek se razlikuje tudi glede na to, kako ste namestili platformo. Domača instanca s PGLite se ne posodablja na enak način kot uradna namestitev s PostgreSQL, Redis, glavnim strežnikom in več delavci. V tem priročniku bomo videli ... Kako pravilno posodobiti ActivepiecesPreverite, ali vse deluje, in če se pojavijo težave, se vrnite na prejšnjo različico.

Pred posodabljanjem: Ugotovite, kako ste namestili Activepieces

Activepieces trenutno ponuja dve glavni Dockerjevi uvedbi. Ključnega pomena je vedeti, katero uporabljate, ker Podatki so shranjeni drugače v vsaki modaliteti.

• Uradna namestitev z Docker Compose: Uporablja ločene vsebnike za aplikacijo, delavca, PostgreSQL in Redis. Je priporočena možnost za strežnike in produkcijska okolja.
• Domača namestitev z Docker Run: Vse se izvaja v enem samem vsebniku z uporabo PGLite in čakalne vrste, shranjene v pomnilniku. Zasnovan je za osebne projekte, nameščene na enem samem računalniku.
• Upravljana platforma: Če uporabljate Activepieces Cloud, ponudnik poskrbi za uvajanje posodobitev in vam teh ukazov ni treba izvajati.

Če imate mapo z datotekami docker-compose.yml y .envVerjetno uporabljate uradno uvajanje. Če pa ste zagnali en sam ukaz z AP_DB_TYPE=PGLITE in vaši podatki se nahajajo v ~/.activepiecesImate domačo inštalacijo.

Aktivne vsebnike lahko preverite tudi z:

docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}"

Celotna namestitev bo prikazala storitve, kot so app, worker, postgres y redisDomači bo običajno prikazal samo en zabojnik, imenovan activepieces.

Kako preveriti nameščeno in razpoložljivo različico

V uradni uvedbi je različica običajno nastavljena s spremenljivko AP_VERSION iz datoteke .envDo njega lahko dostopate iz mape Activepieces z:

grep '^AP_VERSION=' .env

S tem ukazom si lahko ogledate tudi, katere slike storitve uporabljajo:

docker compose -p activepieces images

Preden spremenite različico, si oglejte publikacije v uradnem repozitoriju in bodite še posebej pozorni na razdelke, imenovane Prelomne spremembeTa opozorila označujejo, ali morate pred začetkom nove slike spremeniti spremenljivke, izvesti posebno selitev ali posodobiti katere koli komponente.

Ni priporočljivo samodejno uporabljati nobene novo izdane različice na kritičnem strežniku. ActivePieces pogosto izdaja posodobitve, zato je bolj preudarno ravnati previdno. nastavite določeno različico, ga preizkusite in posodobite na nadzorovan način.

Kako varnostno kopirati ActivePieces

V namestitvi Docker Compose se tokovi in ​​povezave nahajajo v PostgreSQL. Kopirajte samo mapo, v katero shranite datoteko Compose. Ne ustvari kopije baze podatkov, saj se običajno nahaja v Dockerjevem nosilcu.

V imeniku Activepieces ustvarite mapo za varnostne kopije:

mkdir -p backups

Nato izvozite bazo podatkov PostgreSQL:

docker compose -p activepieces exec -T postgres \
  pg_dump -U postgres activepieces \
  > "backups/activepieces-$(date +%F-%H%M).sql"

Ukaz uporablja uporabniško ime in ime baze podatkov, ki sta vključena v uradno uvedbo. Če ste ju spremenili v datoteki .envZamenjati jih boste morali s svojimi vrednostmi.

Poleg PostgreSQL-a morate kopirati tudi datoteko s spremenljivkami in konfiguracijo Compose:

cp .env "backups/env-$(date +%F-%H%M).backup"
cp docker-compose.yml "backups/docker-compose-$(date +%F-%H%M).yml"
chmod 600 backups/*

Kopija .env Bistveno je, ker vsebuje AP_ENCRYPTION_KEYActivepieces uporablja ta ključ za šifriranje shranjenih povezav. Tudi če uspešno obnovite PostgreSQL, Poverilnic ni mogoče dešifrirati, če izgubite ali zamenjate ta ključ..

Da zmanjšate tveganje prekinitve izvajanja, izvedite posodobitev v obdobju nizke aktivnosti in predhodno preverite, ali se ne izvajajo nobeni pomembni tokovi.

Kako posodobiti Activepieces z Docker Compose

Če ste Activepieces namestili z uradnim skriptom, je priporočeni način posodobitve, da iz njegovega imenika zaženete naslednji ukaz:

curl -fsSL https://get.activepieces.com | sh -s -- --upgrade

Ta postopek ohrani datoteko .env, podatki in spremembe, narejene v docker-compose.ymlČe želite skript pred zagonom preveriti, lahko njegovo vsebino prikažete, ne da bi jo poslali neposredno interpreterju:

curl -fsSL https://get.activepieces.com

Če Docker Compose upravljate ročno, najprej spremenite spremenljivko v datoteki. .env za različico, ki jo želite namestiti:

AP_VERSION=X.Y.Z

Morate zamenjati X.Y.Z z natančno številko, objavljeno v repozitoriju. Nato prenesite nove slike in ponovno ustvarite storitve:

docker compose -p activepieces pull
docker compose -p activepieces up -d

Pomembno je ohraniti ime projekta activepiecesČe zaženete Compose z drugim imenom ali iz druge konfiguracije, lahko Docker ustvari novi in ​​na videz prazni zvezkizaradi česar se zdi, kot da je vaš denarni tok izginil.

Ob zagonu bo Activepieces uporabil ustrezne migracije baze podatkov. Med tem postopkom ne ustavljajte vsebnikov, razen če dnevniki kažejo jasno napako.

Kako posodobiti domačo napeljavo s PGLite

Domača različica shranjuje vaše podatke v mapi ~/.activepiecesPreden zamenjate vsebnik, ga ustavite in ustvarite celotno kopijo:

docker stop activepieces
cp -a ~/.activepieces \
  "$HOME/.activepieces-backup-$(date +%F-%H%M)"

Nato izbrišite samo vsebnik in prenesite novo sliko:

docker rm activepieces
docker pull activepieces/activepieces:latest

Na koncu znova zaženite isti ukaz, ki ste ga uporabili med namestitvijo, pri čemer ohranite prvotni nosilec, vrata in spremenljivke:

docker run -d --name activepieces \
  -p 8080:80 \
  -v ~/.activepieces:/root/.activepieces \
  -e AP_DB_TYPE=PGLITE \
  -e AP_REDIS_TYPE=MEMORY \
  -e AP_FRONTEND_URL="https://automatizaciones.ejemplo.com" \
  activepieces/activepieces:latest

Zamenjajte primer URL-ja z dejanskim naslovom vašega primerka. Tokovi se bodo ohranili, ker ostanejo v nameščeni mapi in ne znotraj odstranjene posode.

Ta model je zasnovan za en sam stroj in ne omogoča skaliranja z več delavci. Če morate migrirati na izdajo za podjetja ali namestiti več primerkov, preprosto spreminjanje nekaj spremenljivk ni dovolj: migracijo na PostgreSQL in Redis boste morali načrtovati ločeno.

Kako posodobiti Activepieces iz Dockge, Portainer ali Coolify

Ko upravljate ActivePieces iz vizualne nadzorne plošče, se izogibajte hkratnemu posodabljanju iz terminala in vmesnika. Najprej naredite identične kopije PostgreSQL in datoteke. .envNato spremenite oznako slike in uporabite funkcijo za ponovno ustvari, namesti ali posodobi sklad na voljo na plošči.

Če uporabljate Dockge, lahko sledite postopku za posodabljanje Dockerjevega vsebnika z uporabo Dockgeja, pri čemer se količine in spremenljivke Activepieces ohranijo nedotaknjene.

V vseh primerih preverite, ali je plošča zamenjala različico, ki jo je določil latest brez da bi se tega sploh zavedali. Na produkcijskih strežnikih je bolje uporabiti posebna oznaka različice da bi nadzorovali, kdaj se spremembe uporabijo.

Kako preveriti, ali posodobitev deluje

Ko so kontejnerji zagnani, preverite njihovo stanje:

docker compose -p activepieces ps

Glavne storitve bi morale biti aktivne. Nato preverite končno točko stanja:

curl http://localhost:8080/api/v1/health

Dostopite do plošče in vnesite Skrbništvo platforme, infrastruktura in delavciVsaj en delavec mora biti videti povezan. Priporočljivo je tudi, da ročno zaženete testni potek in pregledate morebitno avtomatizacijo, ki uporablja poverilnice OAuth ali zunanji API.

Če morate raziskati napako, ločeno preverite dnevnike aplikacije in delavcev:

docker compose -p activepieces logs --tail=200 app
docker compose -p activepieces logs --tail=200 worker

Ne predvidevajte, da je posodobitev končana samo zato, ker se plošča naloži. Preverite, ali Tokovi se izvajajo, povezave je mogoče dešifrirati in spletni kavlji ostanejo dostopni..

Kako se vrniti na prejšnjo različico

Če nova različica povzroči napako, morda ne bo dovolj le spreminjanje oznake slike. Nekatere posodobitve spreminjajo shemo PostgreSQL, zato Activepieces vključuje poseben ukaz za to. povrnitev migracij baze podatkov.

Najprej ustavite storitve:

docker compose -p activepieces down

Nato izvedite povrnitev prejšnjega stanja z uporabo nove slike, saj ta vsebuje logiko, potrebno za razveljavitev migracije:

docker run --rm --env-file .env --entrypoint npm \
  activepieces/activepieces:VERSION_NUEVA \
  run rollback -- --to VERSION_ANTERIOR

Obe vrednosti zamenjajte z ustreznima različicama. Nato spremenite AP_VERSION v datoteki .env vrnite se na prejšnjo različico in znova zaženite storitve:

docker compose -p activepieces up -d

Preden to storite, preglejte opombe ob izdaji. Nekatere destruktivne migracije lahko zahtevajo dodatno potrditev in Ne smejo biti vsiljeni brez veljavne kopije.Če imate kakršne koli dvome, je varneje obnoviti varnostno kopijo PostgreSQL in hkrati obnoviti datoteko .env ustrezno.

Pogoste napake pri posodabljanju Activepieces

Če so tokovi izginili, preverite, ali še vedno uporabljate isti nosilec PostgreSQL in isto ime projekta Compose. Zaženite sklad iz druge mape ali brez njega. -p activepieces lahko privede do nastanka drugačen volumen baze podatkov.

Ko se povezave pojavijo, a nato prenehajo delovati, preverite AP_ENCRYPTION_KEYObnovitev baze podatkov z drugačnim ključem prepreči dešifriranje shranjenih poverilnic in prisili aplikacije, da se ponovno povežejo.

Če je razdelek workers prazen in se pojavijo napake Socket.IO, worker verjetno ne more komunicirati z glavno storitvijo. V svoji konfiguraciji, AP_FRONTEND_URL Kazati mora na interno ime storitve:

worker:
  environment:
    - AP_CONTAINER_TYPE=WORKER
    - AP_FRONTEND_URL=http://app

Javni URL mora biti ohranjen v konfiguraciji glavne aplikacije. Znotraj vsebnika delavca, localhost Nanaša se na samega delavca in ne na strežnik Activepieces.

Če Docker zavrne ukaze, preverite, ali uporabljate Docker Compose v2:

docker compose version

Stari ukaz docker-compose Ni združljivo s trenutno uradno uvedbo.

Ko se glavni vsebnik nenehno znova zažene, preverite njegove dnevnike. Eden od možnih vzrokov v izdaji Enterprise je vzdrževanje AP_EXECUTION_MODE=UNSANDBOXED, trenutno zavrnjena vrednost. V tem primeru je treba uporabiti združljiv način, kot je SANDBOX_CODE_ONLY.

Če se plošča naloži, vendar nekatere operacije po posodobitvi ne uspejo, preverite, ali so v nameščeni različici nezdružljive spremembe. Morda se je spremenilo delovanje komponente, spremenljivke ali spletnega kavlja, tudi če je celotna namestitev videti pravilna.

Za varno posodabljanje Activepieces je treba določiti vrsto namestitve, varnostno kopirati PostgreSQL ali PGLite in ohraniti ključe datotek. .envS fiksno različico, preverjeno kopijo in naknadnim preverjanjem delavcev in potekov lahko vključite nove funkcije, ne da bi pri tem karkoli tvegali. avtomatizacije, ki jih že imate v proizvodnji.