[{"data":1,"prerenderedAt":413},["ShallowReactive",2],{"navigation":3,"page-\u002Fdeployments\u002Fwhen-a-deployment-fails":105,"surround-\u002Fdeployments\u002Fwhen-a-deployment-fails":408},[4,17,25,48,63,74,86],{"title":5,"path":6,"stem":7,"children":8,"icon":16,"exact":11},"Getting started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,12],{"title":10,"path":6,"stem":7,"exact":11,"children":-1},"Introduction",true,{"title":13,"path":14,"stem":15,"exact":11,"children":-1},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-rocket",{"title":18,"path":19,"stem":20,"children":21,"icon":24,"exact":11},"Concepts","\u002Fconcepts","2.concepts\u002F1.index",[22],{"title":23,"path":19,"stem":20,"exact":11,"children":-1},"The Kuppit model","i-lucide-shapes",{"title":26,"path":27,"stem":28,"children":29,"icon":47,"exact":11},"Deployments","\u002Fdeployments","3.deployments\u002F1.index",[30,31,35,39,43],{"title":26,"path":27,"stem":28,"exact":11,"children":-1},{"title":32,"path":33,"stem":34,"exact":11,"children":-1},"Builds","\u002Fdeployments\u002Fbuilds","3.deployments\u002F2.builds",{"title":36,"path":37,"stem":38,"exact":11,"children":-1},"Redeploy and roll back","\u002Fdeployments\u002Fredeploy-and-rollback","3.deployments\u002F3.redeploy-and-rollback",{"title":40,"path":41,"stem":42,"exact":11,"children":-1},"Logs","\u002Fdeployments\u002Flogs","3.deployments\u002F4.logs",{"title":44,"path":45,"stem":46,"exact":11,"children":-1},"When a deployment fails","\u002Fdeployments\u002Fwhen-a-deployment-fails","3.deployments\u002F5.when-a-deployment-fails","i-lucide-cloud-upload",{"title":49,"path":50,"stem":51,"children":52,"icon":62,"exact":11},"Resources","\u002Fresources","4.resources\u002F1.index",[53,54,58],{"title":49,"path":50,"stem":51,"exact":11,"children":-1},{"title":55,"path":56,"stem":57,"exact":11,"children":-1},"Web services","\u002Fresources\u002Fweb-services","4.resources\u002F2.web-services",{"title":59,"path":60,"stem":61,"exact":11,"children":-1},"PostgreSQL","\u002Fresources\u002Fpostgresql","4.resources\u002F3.postgresql","i-lucide-boxes",{"title":64,"icon":65,"path":66,"stem":67,"children":68,"page":73,"exact":11},"Configuration","i-lucide-sliders-horizontal","\u002Fconfiguration","5.configuration",[69],{"title":70,"path":71,"stem":72,"exact":11,"children":-1},"Environment variables","\u002Fconfiguration\u002Fvariables","5.configuration\u002F1.variables",false,{"title":75,"path":76,"stem":77,"children":78,"icon":85,"exact":11},"Domains","\u002Fdomains","7.domains\u002F1.index",[79,81],{"title":80,"path":76,"stem":77,"exact":11,"children":-1},"Hostnames",{"title":82,"path":83,"stem":84,"exact":11,"children":-1},"Custom domains","\u002Fdomains\u002Fcustom-domains","7.domains\u002F2.custom-domains","i-lucide-globe",{"title":87,"path":88,"stem":89,"children":90,"icon":104,"exact":11},"Environments","\u002Fenvironments","8.environments\u002F1.index",[91,92,96,100],{"title":87,"path":88,"stem":89,"exact":11,"children":-1},{"title":93,"path":94,"stem":95,"exact":11,"children":-1},"Preview environments","\u002Fenvironments\u002Fpreview-environments","8.environments\u002F2.preview-environments",{"title":97,"path":98,"stem":99,"exact":11,"children":-1},"Named environments","\u002Fenvironments\u002Fnamed-environments","8.environments\u002F3.named-environments",{"title":101,"path":102,"stem":103,"exact":11,"children":-1},"Deleting an environment","\u002Fenvironments\u002Fdeleting-an-environment","8.environments\u002F4.deleting-an-environment","i-lucide-git-branch",{"id":106,"title":44,"badge":107,"body":108,"category":107,"description":402,"draft":73,"extension":403,"links":107,"meta":404,"navigation":11,"path":45,"seo":405,"sitemap":406,"stem":46,"__hash__":407},"docs\u002F3.deployments\u002F5.when-a-deployment-fails.md",null,{"type":109,"value":110,"toc":393},"minimark",[111,124,135,140,150,306,310,320,372,376,379,383],[112,113,114,115,119,120,123],"p",{},"A deployment that stops before going live is ",[116,117,118],"strong",{},"Failed",", and traffic is not moved: whatever was serving keeps serving. Its page says which phase failed, whose problem it is, and what to do next, with the raw message from the infrastructure one disclosure down under ",[116,121,122],{},"Advanced details",".",[112,125,126,127,130,131,134],{},"The title is ",[116,128,129],{},"Build failed"," when the image could not be built, and ",[116,132,133],{},"Deployment failed"," otherwise. Below it, one sentence names the cause. The sentences fall into three groups.",[136,137,139],"h2",{"id":138},"your-applications","Your application's",[112,141,142,143,146,147,123],{},"These are things in the repository or the running code. The page offers ",[116,144,145],{},"View relevant logs",", which opens the stream that failed with errors selected, and ",[116,148,149],{},"Redeploy",[151,152,153,169],"table",{},[154,155,156],"thead",{},[157,158,159,163,166],"tr",{},[160,161,162],"th",{},"Failure",[160,164,165],{},"What it means",[160,167,168],{},"What to do",[170,171,172,192,210,225,236,251,262,276],"tbody",{},[157,173,174,178,185],{},[175,176,177],"td",{},"The Dockerfile Kuppit was told to build no longer exists",[175,179,180,181,184],{},"The service's ",[116,182,183],{},"Dockerfile path"," points at a file the commit does not have.",[175,186,187,188,191],{},"Fix the path on ",[116,189,190],{},"Settings",", or restore the file.",[157,193,194,197,200],{},[175,195,196],{},"Build settings no longer match the repository",[175,198,199],{},"The commit changed shape since the settings were saved, for example a Dockerfile appeared.",[175,201,202,203,206,207,209],{},"Choose ",[116,204,205],{},"Inspect latest"," on ",[116,208,190],{},", review, save.",[157,211,212,215,218],{},[175,213,214],{},"The repository is too large for Kuppit to build",[175,216,217],{},"More than 20,000 files, or extraction took over a minute.",[175,219,220,221,224],{},"Narrow the ",[116,222,223],{},"Root directory",", or remove what is not needed to build.",[157,226,227,230,233],{},[175,228,229],{},"The repository source could not be read",[175,231,232],{},"The archive from GitHub was malformed.",[175,234,235],{},"Push again. If it repeats, check the repository for files Git cannot represent.",[157,237,238,241,244],{},[175,239,240],{},"The build failed",[175,242,243],{},"Your build command or Dockerfile step exited with an error.",[175,245,246,247,250],{},"Read the ",[116,248,249],{},"Build"," log.",[157,252,253,256,259],{},[175,254,255],{},"The build ran out of time",[175,257,258],{},"The build exceeded 15 minutes.",[175,260,261],{},"Cache better, build less, or move to a Dockerfile with a tighter build.",[157,263,264,267,270],{},[175,265,266],{},"The new revision could not start",[175,268,269],{},"The container exited before it was healthy.",[175,271,246,272,275],{},[116,273,274],{},"Runtime"," log. A missing start command or a crash on boot lands here.",[157,277,278,281,288],{},[175,279,280],{},"The application did not become healthy",[175,282,283,284,123],{},"The container ran but never answered on ",[285,286,287],"code",{},"PORT",[175,289,290,291,293,294,297,298,123],{},"Listen on ",[285,292,287],{}," and ",[285,295,296],{},"0.0.0.0",". See ",[299,300,302,303,305],"a",{"href":301},"\u002Fresources\u002Fweb-services#the-port-contract","the ",[285,304,287],{}," contract",[136,307,309],{"id":308},"yours-to-fix-on-the-variables-tab","Yours to fix on the Variables tab",[112,311,312,313,316,317,123],{},"A reference that cannot be resolved stops the deployment before anything is built. The page says ",[116,314,315],{},"Check this service's variables, then deploy again"," and offers ",[116,318,319],{},"Edit variables",[151,321,322,330],{},[154,323,324],{},[157,325,326,328],{},[160,327,162],{},[160,329,168],{},[170,331,332,340,348,360],{},[157,333,334,337],{},[175,335,336],{},"A variable references a database that no longer exists",[175,338,339],{},"Remove the variable or point it at a database that exists.",[157,341,342,345],{},[175,343,344],{},"A variable references a database that is being deleted",[175,346,347],{},"The same. The deletion will finish; the reference will not come back.",[157,349,350,353],{},[175,351,352],{},"A variable references something the database does not expose",[175,354,355,356,123],{},"Choose one of the ",[299,357,359],{"href":358},"\u002Fresources\u002Fpostgresql#variables-a-database-exposes","six variables a database exposes",[157,361,362,365],{},[175,363,364],{},"The referenced database is still being created",[175,366,367,368,371],{},"Wait for ",[116,369,370],{},"Ready",", then redeploy.",[136,373,375],{"id":374},"kuppits-own","Kuppit's own",[112,377,378],{},"Some failures are Kuppit's to fix, not something in your repository, and the page says so. They include an internal build error, a build Kuppit lost track of, traffic that did not move to the new revision in time, a deployment that stopped making progress and was abandoned, and a referenced database that failed to provision or cannot be reached from this service. Redeploy once; if it fails the same way, it is being looked at.",[136,380,382],{"id":381},"after-a-failure","After a failure",[112,384,385,386,388,389,392],{},"The failed deployment stays in the history with its logs. Fix the cause, then push, or choose ",[116,387,149],{}," on the failure or ",[116,390,391],{},"Redeploy this commit"," in the menu, to build the same commit again with the service's current settings and variables.",{"title":394,"searchDepth":395,"depth":395,"links":396},"",3,[397,399,400,401],{"id":138,"depth":398,"text":139},2,{"id":308,"depth":398,"text":309},{"id":374,"depth":398,"text":375},{"id":381,"depth":398,"text":382},"What the failure page says, whose fault each failure is, and what to do about it.","md",{},{"title":44,"description":402},{"loc":45},"Xz6miAp5qkOLr31meANutut3pPct4AyqkGogk-XZfEg",[409,411],{"title":40,"path":41,"stem":42,"description":410,"children":-1},"Build logs and runtime logs, where each lives, how to filter them, and what Kuppit does to them before you see them.",{"title":49,"path":50,"stem":51,"description":412,"children":-1},"The things your application runs or depends on, and how they connect.",1788534985286]