Create immutable candidates, inspect evidence, promote safely, and roll back.
Revisions and rollout operations
Every deployment starts with an immutable active revision. A rollout creates a separate candidate revision; it does not mutate or replace the active revision. Candidate creation, promotion, rejection, and rollback are durable control-plane operations and may be safely retried after a CLI disconnect or control-plane restart.
Only one candidate may exist for a deployment. Rejections and rollbacks require a persisted reason. Replaying the operation that created a candidate returns the same candidate, and replaying an already committed transition is a no-op.Elastic candidates persist their RunPod cloud, GPU, region, vLLM version and arguments, model revision, and replica bounds in the immutable revision spec. Candidate provisioning uses revision-scoped provider identities and does not publish those workers into active routing. Cancelling provisioning or rejecting the candidate removes only candidate capacity; the active revision is never part of that cleanup set.Promotion is an explicit operator action and is refused unless the latest persisted Release Guard evaluation accepted that candidate against the still-current active revision. The revision and candidate target set are committed atomically. InferCrane then waits for the newest router generation to publish exactly that worker set before it drains and deletes the old revision. Candidate creation and provisioning alone never route traffic.If the control plane restarts after the database cutover but before provider cleanup, the durable promotion resumes at router-generation verification. Cancellation before cutover removes candidate capacity; cancellation after cutover finishes safe draining because abandoning old billable capacity would leak resources.
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"InferCrane","description":"Deploy and operate AI models across your infrastructure. Build or connect inference with durable operations, safe releases, and inspectable evidence.","colors":{"primary":"#1E40AF","light":"#60A5FA","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/infercrane/Gnk5rtwZ5qnsh1Tl/assets/infercrane-logo-light.svg?fit=max\u0026auto=format\u0026n=Gnk5rtwZ5qnsh1Tl\u0026q=85\u0026s=2e953e4ae510e6ff9759bca1cd3c3478","dark":"https://mintcdn.com/infercrane/Gnk5rtwZ5qnsh1Tl/assets/infercrane-logo-dark.svg?fit=max\u0026auto=format\u0026n=Gnk5rtwZ5qnsh1Tl\u0026q=85\u0026s=bc00f53bf2c6c3621f47892b4b63195c","href":"https://infercrane.com"},"favicon":"https://mintcdn.com/infercrane/Gnk5rtwZ5qnsh1Tl/assets/infercrane-favicon.svg?fit=max\u0026auto=format\u0026n=Gnk5rtwZ5qnsh1Tl\u0026q=85\u0026s=6ac13660e88144203dde7c7b5df58762","api":{"playground":{"display":"interactive","proxy":false},"examples":{"languages":["curl","python","javascript","go"]}},"appearance":{"default":"system","strict":false},"navbar":{"primary":{"type":"button","label":"Quickstart","href":"/quickstart"}},"footer":{"links":[{"header":"Product","items":[{"label":"Quickstart","href":"/quickstart"},{"label":"Architecture","href":"/architecture/system"},{"label":"Release Guard","href":"/features/release-guard"}]},{"header":"Company","items":[{"label":"Website","href":"https://infercrane.com"},{"label":"Open console","href":"https://console.infercrane.com"},{"label":"Security","href":"/security"}]},{"header":"For AI agents","items":[{"label":"llms.txt","href":"/llms.txt"},{"label":"llms-full.txt","href":"/llms-full.txt"}]}]},"seo":{"metatags":{"canonical":"https://docs.infercrane.com","og:type":"website","og:site_name":"InferCrane Docs"},"organization":{"name":"InferCrane","url":"https://infercrane.com","sameAs":["https://infercrane.com"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Albert Sans","weight":600},"body":{"family":"Albert Sans","weight":400}},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":"css-variables"},"latex":true},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"infercrane","hasAudioNarration":false,"actualSubdomain":"infercrane","customDomains":["docs.infercrane.com"],"gitSource":{"type":"github","owner":"infercrane","repo":"infercrane","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aff1827242c46a7a36a4cc1","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Reference","count":246},{"language":"default","tag":"Control API","count":230},{"language":"default","tag":"Control API endpoints","count":229},{"language":"default","tag":"Guides","count":68},{"language":"default","tag":"Integrations","count":28},{"language":"default","tag":"Inference optimization","count":26},{"language":"default","tag":"Start here","count":21},{"language":"default","tag":"Operate","count":21},{"language":"default","tag":"Sandboxes","count":20},{"language":"default","tag":"Identity","count":18}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--infercrane-background: #faf9f6;--infercrane-surface: #ffffff;--infercrane-surface-elevated: #f5f3ee;--infercrane-text: #16181b;--infercrane-text-secondary: #626a73;--infercrane-border: #e5e2dc;--infercrane-accent: #2563eb;--infercrane-accent-hover: #1d4ed8;--infercrane-healthy: #18a98c;--infercrane-info: #297ed1;--infercrane-warning: #a66c00;--infercrane-error: #d6384c;--infercrane-font-sans: \"Albert Sans\", \"Avenir Next\", \"Helvetica Neue\", Arial, system-ui, sans-serif;--infercrane-font-mono: \"Geist Mono\", \"SFMono-Regular\", Consolas, monospace;--infercrane-radius-sm: 6px;--infercrane-radius-md: 10px;--infercrane-content-rule: rgba(22, 24, 27, 0.08);--mint-color-background: #f7f7f5;--mint-color-text: #20242a;--mint-token-constant: #9f4d00;--mint-token-string: #087f5b;--mint-token-comment: #737b85;--mint-token-keyword: #2457c5;--mint-token-parameter: #7c3aed;--mint-token-function: #0b6f8a;--mint-token-string-expression: #087f5b;--mint-token-punctuation: #737b85;--mint-token-link: #2563eb}.dark{--infercrane-background: #0b0d0f;--infercrane-surface: #111418;--infercrane-surface-elevated: #171b20;--infercrane-text: #f3f1ea;--infercrane-text-secondary: #9ca3ad;--infercrane-border: #242a31;--infercrane-accent: #60a5fa;--infercrane-accent-hover: #93c5fd;--infercrane-healthy: #44d7b6;--infercrane-info: #59a8ff;--infercrane-warning: #f5b942;--infercrane-error: #ff5667;--infercrane-content-rule: rgba(243, 241, 234, 0.08);--mint-color-background: #0e1115;--mint-color-text: #e9edf2;--mint-token-constant: #f3b56d;--mint-token-string: #75dfc6;--mint-token-comment: #7e8895;--mint-token-keyword: #82b5ff;--mint-token-parameter: #c7a4ff;--mint-token-function: #72d5f4;--mint-token-string-expression: #75dfc6;--mint-token-punctuation: #9ca7b4;--mint-token-link: #82b5ff}body{background-color:var(--infercrane-background);color:var(--infercrane-text);font-family:var(--infercrane-font-sans);letter-spacing:-0.008em;text-rendering:optimizeLegibility}h1,h2,h3{font-family:var(--infercrane-font-sans);text-wrap:balance}h1{font-weight:600;letter-spacing:-0.045em;line-height:1.04;max-width:18ch}h2{letter-spacing:-0.03em;margin-top:3.25rem}code,pre,kbd,samp{font-family:var(--infercrane-font-mono);font-variant-ligatures:none}code-block{background:color-mix(in srgb, var(--infercrane-surface) 88%, var(--infercrane-background));border:1px solid color-mix(in srgb, var(--infercrane-border) 92%, var(--infercrane-text-secondary));border-radius:9px;box-shadow:inset 0 1px rgb(255 255 255 / 0.4);overflow:hidden}.dark code-block{background:#090c10;border-color:#29313b;box-shadow:inset 0 1px rgb(255 255 255 / 0.035)}code-block pre{font-size:0.8rem;font-variant-ligatures:none;line-height:1.7;padding-block:0.35rem;tab-size:2}code-block code{font-weight:450}code-block ::selection{background:color-mix(in srgb, var(--infercrane-accent) 28%, transparent)}code-block button:focus-visible{outline:2px solid var(--infercrane-accent);outline-offset:-3px}.ic-hero{border-bottom:1px solid var(--infercrane-content-rule);margin:-0.25rem 0 2rem;padding-bottom:1.75rem}.ic-kicker{align-items:center;color:var(--infercrane-accent);display:flex;font-family:var(--infercrane-font-mono);font-size:0.78rem;font-weight:600;gap:0.5rem;letter-spacing:0.12em;text-transform:uppercase}.ic-status-dot{background:var(--infercrane-healthy);border-radius:999px;box-shadow:0 0 0 3px color-mix(in srgb, var(--infercrane-healthy) 14%, transparent);height:0.45rem;width:0.45rem}.ic-actions{display:flex;flex-wrap:wrap;gap:0.65rem;margin-top:1rem}.ic-button{align-items:center;border:1px solid transparent;border-radius:var(--infercrane-radius-sm);display:inline-flex;font-size:0.86rem;font-weight:550;gap:0.65rem;justify-content:center;line-height:1;min-height:2.45rem;padding:0.72rem 0.9rem;text-decoration:none!important;transition:background-color 150ms ease, border-color 150ms ease, color 150ms ease, transform 150ms ease}.ic-button:hover{transform:translateY(-1px)}.ic-button-primary{background:var(--infercrane-accent);color:#fff!important}.ic-button-primary:hover{background:var(--infercrane-accent-hover)}.ic-button-secondary{background:var(--infercrane-surface);border-color:var(--infercrane-border);color:var(--infercrane-text)!important}.ic-button-secondary:hover{border-color:color-mix(in srgb, var(--infercrane-text-secondary) 55%, transparent)}.ic-proof{color:var(--infercrane-text-secondary);display:flex;flex-wrap:wrap;font-family:var(--infercrane-font-mono);font-size:0.76rem;gap:0.5rem 1.25rem;margin-top:1.35rem}.ic-proof span::before{color:var(--infercrane-accent);content:\"/\";margin-right:0.42rem}.ic-flow{background:var(--infercrane-surface);border:1px solid var(--infercrane-border);border-radius:var(--infercrane-radius-md);color:var(--infercrane-text);display:flex;font-family:var(--infercrane-font-mono);font-size:0.84rem;gap:0.6rem;justify-content:space-between;margin:1.5rem 0;padding:1rem}.ic-node{align-items:flex-start;border:1px solid var(--infercrane-border);border-radius:var(--infercrane-radius-sm);display:flex;flex:1 1 0;flex-direction:column;gap:0.32rem;justify-content:center;min-height:2.6rem;padding:0.65rem 0.75rem}.ic-node-accent{border-color:color-mix(in srgb, var(--infercrane-accent) 48%, var(--infercrane-border))}.ic-node strong{font-size:0.82rem;font-weight:500}.ic-node-label{align-items:center;color:var(--infercrane-text-secondary);display:flex;font-size:0.74rem;gap:0.35rem;letter-spacing:0.04em;text-transform:uppercase}.ic-flow-arrow{align-self:center;color:var(--infercrane-text-secondary);font-size:0.75rem}.ic-dot{background:var(--infercrane-healthy);border-radius:999px;display:inline-block;height:0.45rem;width:0.45rem}.ic-muted{color:var(--infercrane-text-secondary)}@media (max-width: 760px){.ic-flow{align-items:stretch;flex-direction:column}.ic-flow-arrow{transform:rotate(90deg)}}"}]}
{"page":{"pagePath":"features/revisions","slug":"/features/revisions","pageMetadata":{"title":"Revisions and rollouts","description":"Create immutable candidates, inspect evidence, promote safely, and roll back.","href":"/features/revisions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create immutable candidates, inspect evidence, promote safely, and roll back.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`revisions-and-rollout-operations`,children:`Revisions and rollout operations`}),`\n`,_jsx(_components.p,{children:`Every deployment starts with an immutable active revision. A rollout creates a separate candidate revision; it does not mutate or replace the active revision. Candidate creation, promotion, rejection, and rollback are durable control-plane operations and may be safely retried after a CLI disconnect or control-plane restart.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`shellsession`,children:_jsx(_components.pre,{className:`shiki shiki-themes css-variables css-variables`,style:{backgroundColor:`var(--mint-background)`,\"--shiki-dark-bg\":`var(--mint-background)`,color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},language:`shellsession`,children:_jsxs(_components.code,{language:`shellsession`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:`infercrane rollout create qwen-prod --model Qwen/Qwen3-8B --min 1 --max 4 --wait`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:`infercrane rollout create qwen-prod --model Qwen/Qwen3-8B --cloud runpod --gpu H100 --wait`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:`infercrane rollout provision qwen-prod REVISION_ID --wait`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:`infercrane rollout inspect qwen-prod`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:`infercrane rollout promote qwen-prod REVISION_ID --wait`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:`infercrane rollout reject qwen-prod REVISION_ID --reason \"readiness failed\" --wait`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`var(--mint-foreground)`,\"--shiki-dark\":`var(--mint-foreground)`},children:`infercrane rollout rollback qwen-prod REVISION_ID --reason \"operator rollback\" --wait`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Only one candidate may exist for a deployment. Rejections and rollbacks require a persisted reason. Replaying the operation that created a candidate returns the same candidate, and replaying an already committed transition is a no-op.`}),`\n`,_jsx(_components.p,{children:`Elastic candidates persist their RunPod cloud, GPU, region, vLLM version and arguments, model revision, and replica bounds in the immutable revision spec. Candidate provisioning uses revision-scoped provider identities and does not publish those workers into active routing. Cancelling provisioning or rejecting the candidate removes only candidate capacity; the active revision is never part of that cleanup set.`}),`\n`,_jsx(_components.p,{children:`Promotion is an explicit operator action and is refused unless the latest persisted Release Guard evaluation accepted that candidate against the still-current active revision. The revision and candidate target set are committed atomically. InferCrane then waits for the newest router generation to publish exactly that worker set before it drains and deletes the old revision. Candidate creation and provisioning alone never route traffic.`}),`\n`,_jsx(_components.p,{children:`If the control plane restarts after the database cutover but before provider cleanup, the durable promotion resumes at router-generation verification. Cancellation before cutover removes candidate capacity; cancellation after cutover finishes safe draining because abandoning old billable capacity would leak resources.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":"css-variables"},"config":{},"pageMetadata":{"title":"Revisions and rollouts","description":"Create immutable candidates, inspect evidence, promote safely, and roll back.","href":"/features/revisions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Revisions and rollout operations","slug":"revisions-and-rollout-operations","depth":1,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"infercrane","siteName":"InferCrane","title":"Revisions and rollouts - InferCrane","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-22T00:39:23.668Z","originalFileLocation":"features/revisions.md"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create immutable candidates, inspect evidence, promote safely, and roll back.\">\u003cmeta data-mint-head name=\"application-name\" content=\"InferCrane\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Revisions and rollouts - InferCrane\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create immutable candidates, inspect evidence, promote safely, and roll back.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"InferCrane Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.infercrane.com/features/revisions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://infercrane.mintlify.site/_mintlify/api/og/v2?division=Deploy+and+connect\u0026amp;title=Revisions+and+rollouts\u0026amp;description=Create+immutable+candidates%2C+inspect+evidence%2C+promote+safely%2C+and+roll+back.\u0026amp;theme=d86c484f21e0a5a8fbe6a15e\u0026amp;signature=dcebf215e6204d5a35829194740b998e835df95ee0c78245dbf3c22755a273f0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Revisions and rollouts - InferCrane\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create immutable candidates, inspect evidence, promote safely, and roll back.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://infercrane.mintlify.site/_mintlify/api/og/v2?division=Deploy+and+connect\u0026amp;title=Revisions+and+rollouts\u0026amp;description=Create+immutable+candidates%2C+inspect+evidence%2C+promote+safely%2C+and+roll+back.\u0026amp;theme=d86c484f21e0a5a8fbe6a15e\u0026amp;signature=dcebf215e6204d5a35829194740b998e835df95ee0c78245dbf3c22755a273f0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/infercrane/shneWX0fKPF9qe1w/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"InferCrane\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E40AF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.infercrane.com/features/revisions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/features/revisions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://infercrane.com/#organization\",\"name\":\"InferCrane\",\"url\":\"https://infercrane.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/infercrane/Gnk5rtwZ5qnsh1Tl/assets/infercrane-logo-light.svg?fit=max\u0026auto=format\u0026n=Gnk5rtwZ5qnsh1Tl\u0026q=85\u0026s=2e953e4ae510e6ff9759bca1cd3c3478\"},\"sameAs\":[\"https://infercrane.com\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.infercrane.com#website\",\"name\":\"InferCrane\",\"url\":\"https://docs.infercrane.com\",\"publisher\":{\"@id\":\"https://infercrane.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.infercrane.com/features/revisions#webpage\",\"url\":\"https://docs.infercrane.com/features/revisions\",\"name\":\"Revisions and rollouts\",\"description\":\"Create immutable candidates, inspect evidence, promote safely, and roll back.\",\"dateModified\":\"2026-08-22T00:39:23.668Z\",\"isPartOf\":{\"@id\":\"https://docs.infercrane.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.infercrane.com/features/revisions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.infercrane.com/features/revisions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Deploy and connect\",\"item\":\"https://docs.infercrane.com/showcase\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Revisions and rollouts\",\"item\":\"https://docs.infercrane.com/features/revisions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.infercrane.com/features/revisions#article\",\"headline\":\"Revisions and rollouts\",\"name\":\"Revisions and rollouts\",\"description\":\"Create immutable candidates, inspect evidence, promote safely, and roll back.\",\"url\":\"https://docs.infercrane.com/features/revisions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.infercrane.com/features/revisions#webpage\"},\"dateModified\":\"2026-08-22T00:39:23.668Z\",\"publisher\":{\"@id\":\"https://infercrane.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.infercrane.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"InferCrane\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"InferCrane\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/features/revisions.md","siteName":"InferCrane","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","groups":[{"group":"Start here","boost":2,"pages":[{"title":"Give InferCrane a model. Get a production endpoint.","sidebarTitle":"Introduction","mode":"wide","href":""},{"title":"Quickstart","href":"/quickstart"},{"title":"Run on this machine","href":"/run-on-this-machine"},{"title":"Model API quickstart","sidebarTitle":"Model APIs","href":"/model-apis"},{"title":"Benchmark evidence","sidebarTitle":"Benchmark evidence","href":"/benchmarks"},{"title":"InferCrane v1.0.0-rc.1","sidebarTitle":"v1.0.0-rc.1 public beta","href":"/release-notes-v1.0.0-rc.1"},{"title":"Why InferCrane","sidebarTitle":"Why InferCrane","mode":"wide","href":"/why-infercrane"},{"title":"Choose the right inference approach","sidebarTitle":"Compare approaches","mode":"wide","href":"/compare"},{"title":"Community, Cloud, and Enterprise","sidebarTitle":"Product editions","href":"/editions"},{"title":"Core concepts","sidebarTitle":"Concepts","href":"/concepts"},{"title":"Architecture","href":"/architecture/system"},{"title":"Control-plane hosting","href":"/architecture/control-plane-hosting"},{"title":"Managed Model API architecture","href":"/architecture/managed-model-apis"},{"title":"Managed deployments","href":"/architecture/managed-deployments"},{"title":null,"href":"/architecture/invariants"},{"title":null,"href":"/architecture/data-flows"},{"title":"InferCrane agent","href":"/architecture/agent"}]},{"group":"Deploy and connect","boost":1.5,"pages":[{"title":"What you can build","sidebarTitle":"Showcase","mode":"wide","href":"/showcase/index"},{"title":"Build your inference deployment","sidebarTitle":"Build your inference","href":"/showcase/build-inference"},{"title":"Verified Models","sidebarTitle":"Verified Models","href":"/features/model-catalog"},{"title":"Inference projects","href":"/features/inference-projects"},{"title":"Connect the stack you already run","sidebarTitle":"Connect existing inference","href":"/showcase/connect-existing"},{"title":"Start with an API, add your own GPUs later","href":"/showcase/api-to-self-hosted"},{"title":"Stable endpoints and serving plans","href":"/features/endpoints"},{"title":"DeploymentSpec","href":"/deployment-spec"},{"title":"Inference protocols","href":"/features/protocols"},{"title":null,"href":"/features/gateway"},{"title":"Model artifacts","href":"/features/model-artifacts"},{"title":"Custom OCI workloads","href":"/features/custom-oci"},{"title":"Provisioning and readiness","description":"Distinguish provider capacity, container startup, artifact preparation, runtime startup, and readiness without guessing.","href":"/features/provisioning"},{"title":"Revisions and rollouts","href":"/features/revisions"}]},{"group":"Operate","pages":[{"title":"Deployment lifecycle","description":"How durable operations survive disconnects, retries, restarts, updates, and deletion.","href":"/features/lifecycle"},{"title":"Observe operations","href":"/features/observe"},{"title":"Adopt and diagnose","href":"/features/adoption-diagnostics"},{"title":"Autoscaling","href":"/features/autoscaling"},{"title":"Release Guard","href":"/features/release-guard"},{"title":"Deterministic explanations","href":"/features/explanations"},{"title":"Inference telemetry","href":"/features/telemetry"},{"title":"GPU profiling","href":"/features/gpu-profiling"},{"title":"Reproducible benchmarking","href":"/features/benchmarking"},{"title":"Cold-start intelligence","href":"/features/cold-starts"},{"title":"Artifact cache and prewarming","href":"/features/artifact-cache"},{"title":"Admission and async inference","href":"/features/admission-async"},{"title":"Environment promotion","href":"/features/environment-promotion"},{"title":"Governed external capacity","href":"/features/external-capacity"},{"title":"Provider-native serverless","href":"/features/serverless"},{"title":"Semantic quality evidence","href":"/features/semantic-quality"},{"title":"Terminal operations workspace","href":"/features/terminal-ui"},{"title":"Sign in the CLI","href":"/features/cli-login"},{"title":"Operations console","href":"/features/dashboard"},{"title":"Reject a bad release before it reaches production","sidebarTitle":"Safe rollout","href":"/showcase/safe-rollouts"},{"title":"Operate through slow and uncertain capacity","sidebarTitle":"Capacity and evidence","href":"/showcase/capacity-evidence"}]},{"group":"Evidence and decisions","pages":[{"title":"Evidence-gated optimization","href":"/features/optimization"},{"title":"Competitive benchmark methodology","href":"/testing/competitive-benchmark-methodology"},{"title":"Open-weight optimization PoC","href":"/testing/open-weight-optimization-poc"},{"title":"Optimizer golden suite","href":"/testing/optimizer-golden-suite"},{"title":null,"href":"/testing/aws-real-evidence"},{"title":null,"href":"/testing/runpod-glm53-real-evidence"},{"title":null,"href":"/testing/runpod-qwen-real-evidence"},{"title":null,"href":"/testing/scaleway-brezel-real-evidence"},{"title":null,"href":"/testing/feature-qualification-matrix"},{"title":"Recipes and Inference Lab","href":"/features/recipes-lab"},{"title":"Replay and capacity intelligence","href":"/features/replay-capacity"},{"title":"Compare cost and performance","sidebarTitle":"Cost and performance","href":"/showcase/cost-performance"},{"title":"Inference decisions","href":"/features/inference-decisions"},{"title":"FinOps and advisory Autopilot","href":"/features/finops-autopilot"},{"title":"Inference Passports","href":"/features/inference-passports"},{"title":"Context Passport and Burst Guard","href":"/features/context-passport-burst"}]}]},{"tab":"Integrations","icon":"plug","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Reference","icon":"brackets-curly","pages":[{"title":"Reference","href":"/cli"}]}]},"basePath":"","title":"Revisions and rollouts - InferCrane","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}