← Artifacts / artifacts / concepts

Jak Artifacts funguje

Artifacts vytváří repozitáře Git na vyžádání. Každý repozitář je izolovaná služba Git s vlastní vzdálenou adresou URL, tokeny a trvalým stavem.

Jmenné prostory jsou nejvyšším kontejnerem pro repozitáře. Repozitář existuje vždy v rámci jednoho jmenného prostoru a jeho název je v tomto prostoru jedinečný.

Artifacts jmenné prostory samostatně nevytváří. Když vytvoříte první repozitář s novým názvem jmenného prostoru, Artifacts tento jmenný prostor vytvoří automaticky.

Jmenný prostor vymezuje hranice pojmenování a směrování repozitářů. Název jmenného prostoru společně s názvem repozitáře tvoří stálou adresu repozitáře a odpovědi API navíc vracejí ID repozitáře.

Stejně jako Durable Objects, repozitář je jedna logická instance, ke které může Cloudflare směrovat z jakéhokoli regionu.

Protože je každý repozitář izolovaný, má vlastní:

• Historie Git a reference
• přístupové tokeny a vzdálená adresa URL
• životní cyklus a trvalý stav

Repozitáře lze vytvářet podle potřeby. Artifacts tak může modelovat mnoho malých pracovních jednotek napříč samostatnými repozitáři.

Forkování funguje na stejném principu. Fork vytvoří nový repozitář, který vychází z historie existujícího repozitáře a dále se vyvíjí nezávisle, s vlastními tokeny, směrováním a životním cyklem.

Přístup je rovněž vázán na konkrétní repozitář. Každý repozitář má vlastní tokeny a každý token lze omezit na určitou úroveň přístupu:

• read pro clone, fetch, pull, indexování a kontrolu
• write pro push a další mutace

O tom, kdy tyto tokeny vytvořit, rozhoduje váš Worker nebo vrstva API. Díky tomu zůstává autentizace a autorizace mimo repozitář a repozitář je přesto možné používat z Workers, REST API nebo jakéhokoli standardního Git klienta.

Artifacts je ve výchozím nastavení odolný a trvalý. Repozitář nezávisí na běhu jediného procesu ani na dostupnosti jediného datového centra.

Cloudflare v pozadí synchronně replikuje data repozitáře napříč více datovými centry a asynchronně je kopíruje do objektového úložiště a snímků. Vlastní pipeline pro replikaci, přepnutí při selhání ani vytváření snímků tak nemusíte budovat, aby stav repozitáře zůstal dostupný.

Artifacts se stará o životní cyklus serveru Git a úložnou infrastrukturu, na které tyto pracovní postupy Git běží.

Vzory pro repozitáře najdete v Doporučené postupy pro Artifacts. Chování tokenu najdete popsané v Git protokol. Aktualizace produktu najdete v Changelog Artifacts.