main
ply4 git calls52 ms42 KiB3 cachedprotocol v2
84 lines3.1 KiBRaw
1import { execFile } from 'node:child_process'
2import { join } from 'node:path'
3import { fileURLToPath } from 'node:url'
4import { redact } from './redact.ts'
5import { assertDeploymentCreate, withTrafficLock } from './traffic-gate.ts'
6import { traceCommand } from './trace.ts'
8export const ROOT = fileURLToPath(new URL('../..', import.meta.url))
9const CF = join(ROOT, 'node_modules', '.bin', 'cf')
11export type CfResult = {
12 readonly code: number
13 readonly stdout: string
14 readonly stderr: string
17/** The directory cf runs in. cf creates `node_modules/.cache` under cwd, so this is the repo, never `/`. */
18export function cfWorkdir(): string {
19 return ROOT
22export type CfRunner = (args: readonly string[], secrets: readonly string[]) => Promise<CfResult>
24let installed: CfRunner | null = null
26/** Tests install a runner. Production leaves this unset and execs `cf`. */
27export function useCfRunner(next: CfRunner | null): void {
28 installed = next
31function isDeploymentCreate(args: readonly string[]): boolean {
32 return args[0] === 'workers' && args[1] === 'deployments' && args[2] === 'create'
35/** cf with --quiet. Stdout is raw so a token can be parsed; callers must not log it. The log copy is redacted. */
36export function runCf(args: readonly string[], secrets: readonly string[] = []): Promise<CfResult> {
37 if (!isDeploymentCreate(args)) return execCf(args, secrets)
38 return withTrafficLock(async () => {
39 assertDeploymentCreate()
40 return execCf(args, secrets)
41 })
44function execCf(args: readonly string[], secrets: readonly string[]): Promise<CfResult> {
45 const started = Date.now()
46 const runner = installed
47 if (runner) {
48 return runner(args, secrets).then(result => traced(args, secrets, started, result))
49 }
50 return new Promise(resolve => {
51 execFile(CF, ['--quiet', ...args], {
52 cwd: cfWorkdir(),
53 env: { ...process.env, CF_SEND_TELEMETRY: 'false' },
54 maxBuffer: 64 * 1024 * 1024,
55 encoding: 'utf8',
56 }, (err, stdout, stderr) => {
57 const coded = err && typeof err === 'object' && 'code' in err ? (err as { code?: unknown }).code : undefined
58 const code = typeof coded === 'number' ? coded : err ? 1 : 0
59 const rawOut = stdout ?? ''
60 const safeErr = redact(stderr ?? '', secrets)
61 const result = { code, stdout: rawOut, stderr: safeErr }
62 void traced(args, secrets, started, result).then(resolve, () => resolve(result))
63 })
64 })
67function traced(args: readonly string[], secrets: readonly string[], started: number, result: CfResult): Promise<CfResult> {
68 return traceCommand({
69 argv: [CF, '--quiet', ...args],
70 cwd: cfWorkdir(),
71 exitCode: result.code,
72 durationMs: Date.now() - started,
73 stdout: redact(result.stdout, secrets),
74 stderr: redact(result.stderr, secrets),
75 }).then(() => result)
78export async function cfOk(args: readonly string[], secrets: readonly string[] = []): Promise<string> {
79 const result = await runCf(args, secrets)
80 if (result.code !== 0) {
81 throw new Error(`cf ${args.slice(0, 4).join(' ')} exited ${result.code}: ${result.stderr.slice(0, 500)}`)
82 }
83 return result.stdout
Diagnostics4 git calls · 52 ms
CallStatusSizeTime052 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200145 B · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=145
git.response.cache=HIT
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=145
git.pkt.payload.max=76
git.ls_refs.count=2
git.ls_refs.head=refs/heads/main
fetchblob:none · deepen 1020040 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=41349
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=526b305930b8ef382f2d7a1f9c0238730a585921
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=6
git.pkt.data=4
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=41349
git.pkt.payload.max=41254
git.sideband.band1.bytes=41253
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=61
git.pack.bytes=41253
git.pack.ofs_delta=0
git.pack.ref_delta=0
git.pack.chain.max=0
git.pack.trailer=ab60efef4b7243678c75de64a4386986ee885c1c
git.pack.full=61
Open pack map
fetch2001.2 KiB · hit47 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=47
git.response.bytes=1266
git.response.cache=HIT
git.response.duration_ms=47
git.fetch.wants=9c3d0cf38e2a630e3ed8d6025b67d620ec6e03ce
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1266
git.pkt.payload.max=1245
git.sideband.band1.bytes=1244
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/ply-web.git
Ref
refs/heads/main
Commit
526b305930b8ef382f2d7a1f9c0238730a585921
cf-ray
a5e2ba1d0b5ecf33
Request
cf102aff…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format