The examples use Authentication from
Getting Started: the application's request middleware.
Start from the graph the tutorial built and change the lines your requirements touch:
const GitLive = Git.ApiLive.pipe(
Layer.provide(Git.ApiHandlersLive),
Layer.provide(Authentication.layer),
Layer.provide(Git.ReposDurableObject),
Layer.provide(Git.RegistryDurableObject),
Layer.provide(Git.HasherInline),
Layer.provide(Git.BlobStoreR2(GitObjects)),
); | You need | Change | Where |
|---|---|---|
| Everything on one Cloudflare account | nothing | All on Cloudflare |
| Large pushes verified fast, still on one cloud | HasherWorkerLoader() | Scaling |
| Bytes stored in AWS | BlobStoreS3(bucket) | Bytes in S3, hashing on Lambda |
| The widest push parallelism | HasherLambda(HasherFunction) | Bytes in S3, hashing on Lambda |
| Bytes somewhere that is neither R2 nor S3 | your own BlobStore | Bring your own store |
| Registry reads near users everywhere, SQL over the index | RegistryD1(RepoIndex) | Registry |
| Your own users and credentials | your HttpRouter middleware | Tutorial Part 4 |
| Branch rules | application handlers + Git.Engine | Tutorial Part 6 |
| Your web app and git on one domain | a front-door Worker | Application example |
Every row is independent. Bytes in S3 with the loader hasher and a D1 registry is three changed lines, and the type checker confirms the graph is whole. Scaling is the why behind the first four rows.
One cloud or two
A graph that only touches Cloudflare deploys with Cloudflare's providers:
export default Alchemy.Stack(
"GitService",
{ providers: Cloudflare.providers(), state: Cloudflare.state() },
Effect.gen(function* () {
const git = yield* GitHost;
return { url: git.url.as<string>() };
}),
); A graph that declares a Lambda or reads S3 carries both provider sets. The stack is otherwise identical, and Alchemy creates what each cloud needs:
export default Alchemy.Stack(
"GitService",
- { providers: Cloudflare.providers(), state: Cloudflare.state() },
+ {
+ providers: Layer.mergeAll(Cloudflare.providers(), AWS.providers()),
+ state: Cloudflare.state(),
+ },
Effect.gen(function* () {
const git = yield* GitHost;
return { url: git.url.as<string>() };
}),
);