[{"data":1,"prerenderedAt":1414},["ShallowReactive",2],{"navigation_docs":3,"-engineering-deployment-capability-exchange":449,"-engineering-deployment-capability-exchange-surround":1409},[4,8,72,102,248,294,331,352,445],{"title":5,"path":6,"stem":7},"Introduction","\u002Fintroduction","0.introduction",{"title":9,"icon":10,"path":11,"stem":12,"children":13,"page":67},"Company","i-lucide-building-2","\u002Fcompany","1.company",[14,18,22,26,30,34,38,42,46,50,54,68],{"title":15,"path":16,"stem":17},"About","\u002Fcompany\u002Fabout","1.company\u002F0.about",{"title":19,"path":20,"stem":21},"Values","\u002Fcompany\u002Fvalues","1.company\u002F1.values",{"title":23,"path":24,"stem":25},"Communication","\u002Fcompany\u002Fcommunication","1.company\u002Fcommunication",{"title":27,"path":28,"stem":29},"Competition","\u002Fcompany\u002Fcompetition","1.company\u002Fcompetition",{"title":31,"path":32,"stem":33},"Hybrid Working","\u002Fcompany\u002Fhybrid-working","1.company\u002Fhybrid-working",{"title":35,"path":36,"stem":37},"Manchester Office","\u002Fcompany\u002Foffice","1.company\u002Foffice",{"title":39,"path":40,"stem":41},"Operations","\u002Fcompany\u002Foperations","1.company\u002Foperations",{"title":43,"path":44,"stem":45},"Policies","\u002Fcompany\u002Fpolicies","1.company\u002Fpolicies",{"title":47,"path":48,"stem":49},"Problem Statement","\u002Fcompany\u002Fproblem-statement","1.company\u002Fproblem-statement",{"title":51,"path":52,"stem":53},"Product Strategy","\u002Fcompany\u002Fproduct-strategy","1.company\u002Fproduct-strategy",{"title":55,"path":56,"stem":57,"children":58,"page":67},"Products","\u002Fcompany\u002Fproducts","1.company\u002Fproducts",[59,63],{"title":60,"path":61,"stem":62},"Capability Exchange","\u002Fcompany\u002Fproducts\u002Fcapability-exchange","1.company\u002Fproducts\u002Fcapability-exchange",{"title":64,"path":65,"stem":66},"ESProfiler Platform","\u002Fcompany\u002Fproducts\u002Fesprofiler","1.company\u002Fproducts\u002Fesprofiler",false,{"title":69,"path":70,"stem":71},"Security","\u002Fcompany\u002Fsecurity","1.company\u002Fsecurity",{"title":73,"icon":74,"path":75,"stem":76,"children":77,"page":67},"People Ops","i-lucide-users","\u002Fpeople-ops","2.people-ops",[78,82,86,90,94,98],{"title":79,"path":80,"stem":81},"Compensation","\u002Fpeople-ops\u002Fcompensation","2.people-ops\u002Fcompensation",{"title":83,"path":84,"stem":85},"Education","\u002Fpeople-ops\u002Feducation","2.people-ops\u002Feducation",{"title":87,"path":88,"stem":89},"Expenses","\u002Fpeople-ops\u002Fexpenses","2.people-ops\u002Fexpenses",{"title":91,"path":92,"stem":93},"Holiday & Leave","\u002Fpeople-ops\u002Fleave","2.people-ops\u002Fleave",{"title":95,"path":96,"stem":97},"Onboarding","\u002Fpeople-ops\u002Fonboarding","2.people-ops\u002Fonboarding",{"title":99,"path":100,"stem":101},"Recruitment","\u002Fpeople-ops\u002Frecruitment","2.people-ops\u002Frecruitment",{"title":103,"icon":104,"path":105,"stem":106,"children":107,"page":67},"Engineering","i-lucide-rocket","\u002Fengineering","3.engineering",[108,168,189,210,232,240,244],{"title":109,"path":110,"stem":111,"children":112,"page":67},"Contributing","\u002Fengineering\u002Fcontributing","3.engineering\u002Fcontributing",[113,117,121,125,129,133,146,155],{"title":114,"path":115,"stem":116},"Development Setup","\u002Fengineering\u002Fcontributing\u002Fdevelopment-setup","3.engineering\u002Fcontributing\u002F1.development-setup",{"title":118,"path":119,"stem":120},"Engineering Operations","\u002Fengineering\u002Fcontributing\u002Fengineering-operations","3.engineering\u002Fcontributing\u002F2.engineering-operations",{"title":122,"path":123,"stem":124},"Documentation","\u002Fengineering\u002Fcontributing\u002Fdocumentation","3.engineering\u002Fcontributing\u002F3.documentation",{"title":126,"path":127,"stem":128},"Agentic Coding","\u002Fengineering\u002Fcontributing\u002Fagentic-coding","3.engineering\u002Fcontributing\u002F4.agentic-coding",{"title":130,"path":131,"stem":132},"Coding Standards","\u002Fengineering\u002Fcontributing\u002Fcoding-standards","3.engineering\u002Fcontributing\u002F5.coding-standards",{"title":134,"path":135,"stem":136,"children":137,"page":67},"Back End","\u002Fengineering\u002Fcontributing\u002Fback-end","3.engineering\u002Fcontributing\u002Fback-end",[138,142],{"title":139,"path":140,"stem":141},"API Guidelines","\u002Fengineering\u002Fcontributing\u002Fback-end\u002Fapi-guidelines","3.engineering\u002Fcontributing\u002Fback-end\u002Fapi-guidelines",{"title":143,"path":144,"stem":145},"LLM Prompts & Langfuse Integration","\u002Fengineering\u002Fcontributing\u002Fback-end\u002Fllm-prompts","3.engineering\u002Fcontributing\u002Fback-end\u002Fllm-prompts",{"title":147,"path":148,"stem":149,"children":150,"page":67},"Database","\u002Fengineering\u002Fcontributing\u002Fdatabase","3.engineering\u002Fcontributing\u002Fdatabase",[151],{"title":152,"path":153,"stem":154},"Database Volumes","\u002Fengineering\u002Fcontributing\u002Fdatabase\u002Fdatabase-refresh","3.engineering\u002Fcontributing\u002Fdatabase\u002Fdatabase-refresh",{"title":156,"path":157,"stem":158,"children":159,"page":67},"Front End","\u002Fengineering\u002Fcontributing\u002Ffront-end","3.engineering\u002Fcontributing\u002Ffront-end",[160,164],{"title":161,"path":162,"stem":163},"Data Attributes","\u002Fengineering\u002Fcontributing\u002Ffront-end\u002Fdata-attributes","3.engineering\u002Fcontributing\u002Ffront-end\u002Fdata-attributes",{"title":165,"path":166,"stem":167},"Testing","\u002Fengineering\u002Fcontributing\u002Ffront-end\u002Ftesting","3.engineering\u002Fcontributing\u002Ffront-end\u002Ftesting",{"title":169,"path":170,"stem":171,"children":172},"Deployment","\u002Fengineering\u002Fdeployment","3.engineering\u002Fdeployment\u002F0.index",[173,174,177,181,185],{"title":169,"path":170,"stem":171},{"title":60,"path":175,"stem":176},"\u002Fengineering\u002Fdeployment\u002Fcapability-exchange","3.engineering\u002Fdeployment\u002Fcapability-exchange",{"title":178,"path":179,"stem":180},"Langfuse Deployment","\u002Fengineering\u002Fdeployment\u002Fecs-langfuse-deployment","3.engineering\u002Fdeployment\u002Fecs-langfuse-deployment",{"title":182,"path":183,"stem":184},"ESP Platform Configuration","\u002Fengineering\u002Fdeployment\u002Fesp-platform-configuration","3.engineering\u002Fdeployment\u002Fesp-platform-configuration",{"title":186,"path":187,"stem":188},"Platform","\u002Fengineering\u002Fdeployment\u002Fplatform","3.engineering\u002Fdeployment\u002Fplatform",{"title":190,"path":191,"stem":192,"children":193,"page":67},"Github","\u002Fengineering\u002Fgithub","3.engineering\u002Fgithub",[194,198,202,206],{"title":195,"path":196,"stem":197},"Packages","\u002Fengineering\u002Fgithub\u002Fpackages","3.engineering\u002Fgithub\u002Fpackages",{"title":199,"path":200,"stem":201},"Personal Access Token","\u002Fengineering\u002Fgithub\u002Fpersonal-access-token","3.engineering\u002Fgithub\u002Fpersonal-access-token",{"title":203,"path":204,"stem":205},"Troubleshooting","\u002Fengineering\u002Fgithub\u002Ftroubleshooting","3.engineering\u002Fgithub\u002Ftroubleshooting",{"title":207,"path":208,"stem":209},"Workflows","\u002Fengineering\u002Fgithub\u002Fworkflows","3.engineering\u002Fgithub\u002Fworkflows",{"title":211,"path":212,"stem":213,"children":214},"Platform Ops","\u002Fengineering\u002Fplatform-ops","3.engineering\u002Fplatform-ops\u002F0.index",[215,216,220,224,228],{"title":211,"path":212,"stem":213},{"title":217,"path":218,"stem":219},"Production Database","\u002Fengineering\u002Fplatform-ops\u002Fdatabase-connection","3.engineering\u002Fplatform-ops\u002Fdatabase-connection",{"title":221,"path":222,"stem":223},"New Tenant Creation","\u002Fengineering\u002Fplatform-ops\u002Fnew-tenant-creation","3.engineering\u002Fplatform-ops\u002Fnew-tenant-creation",{"title":225,"path":226,"stem":227},"Releases","\u002Fengineering\u002Fplatform-ops\u002Frelease","3.engineering\u002Fplatform-ops\u002Frelease",{"title":229,"path":230,"stem":231},"Versioning","\u002Fengineering\u002Fplatform-ops\u002Fversioning","3.engineering\u002Fplatform-ops\u002Fversioning",{"title":186,"path":233,"stem":234,"children":235,"page":67},"\u002Fengineering\u002Fplatform","3.engineering\u002Fplatform",[236],{"title":237,"path":238,"stem":239},"useAPI","\u002Fengineering\u002Fplatform\u002Fuse-api","3.engineering\u002Fplatform\u002Fuse-api",{"title":241,"path":242,"stem":243},"Project Management","\u002Fengineering\u002Fproject-management","3.engineering\u002Fproject-management",{"title":245,"path":246,"stem":247},"Tools","\u002Fengineering\u002Ftools","3.engineering\u002Ftools",{"title":249,"icon":250,"path":251,"stem":252,"children":253,"page":67},"Design","i-lucide-palette","\u002Fdesign","4.design",[254,275,279,283,287,290],{"title":255,"path":256,"stem":257,"children":258,"page":67},"Personas","\u002Fdesign\u002Fpersonas","4.design\u002F0.personas",[259,263,267,271],{"title":260,"path":261,"stem":262},"CISO - Simon","\u002Fdesign\u002Fpersonas\u002F01-ciso-simon","4.design\u002F0.personas\u002F01-ciso-simon",{"title":264,"path":265,"stem":266},"Head of Cyber - Harry","\u002Fdesign\u002Fpersonas\u002F02-head-of-cyber-harry","4.design\u002F0.personas\u002F02-head-of-cyber-harry",{"title":268,"path":269,"stem":270},"Security Architect - Sasha","\u002Fdesign\u002Fpersonas\u002F03-security-architect-sasha","4.design\u002F0.personas\u002F03-security-architect-sasha",{"title":272,"path":273,"stem":274},"Procurement Officer - Paige","\u002Fdesign\u002Fpersonas\u002F04-procurement-officer-paige","4.design\u002F0.personas\u002F04-procurement-officer-paige",{"title":276,"path":277,"stem":278},"Design Thinking","\u002Fdesign\u002Fdesign-thinking","4.design\u002F1.design-thinking",{"title":280,"path":281,"stem":282},"Design & Development","\u002Fdesign\u002Fdesign-and-development","4.design\u002F3.design-and-development",{"title":284,"path":285,"stem":286},"Branding","\u002Fdesign\u002Fbranding","4.design\u002F4.branding",{"title":245,"path":288,"stem":289},"\u002Fdesign\u002Ftools","4.design\u002F5.tools",{"title":291,"path":292,"stem":293},"Customer Success","\u002Fdesign\u002Fworking-with-customers","4.design\u002F6.working-with-customers",{"title":295,"icon":296,"path":297,"stem":298,"children":299,"page":67},"Sales","i-lucide-dollar-sign","\u002Fsales","4.sales",[300,320,324,328],{"title":301,"path":302,"stem":303,"children":304,"page":67},"Process","\u002Fsales\u002Fprocess","4.sales\u002F0.process",[305,309,313,317],{"title":306,"path":307,"stem":308},"Lead","\u002Fsales\u002Fprocess\u002Flead","4.sales\u002F0.process\u002F0.lead",{"title":310,"path":311,"stem":312},"Deal Qualification","\u002Fsales\u002Fprocess\u002Fqualification","4.sales\u002F0.process\u002F1.qualification",{"title":314,"path":315,"stem":316},"Close","\u002Fsales\u002Fprocess\u002Fclose","4.sales\u002F0.process\u002F2.close",{"title":95,"path":318,"stem":319},"\u002Fsales\u002Fprocess\u002Fonboarding","4.sales\u002F0.process\u002Fonboarding",{"title":321,"path":322,"stem":323},"Meetings","\u002Fsales\u002Fmeetings","4.sales\u002Fmeetings",{"title":325,"path":326,"stem":327},"Metrics","\u002Fsales\u002Fmetrics","4.sales\u002Fmetrics",{"title":245,"path":329,"stem":330},"\u002Fsales\u002Ftools","4.sales\u002Ftools",{"title":332,"icon":333,"path":334,"stem":335,"children":336,"page":67},"Marketing","i-lucide-book-image","\u002Fmarketing","5.marketing",[337,341,345,348],{"title":338,"path":339,"stem":340},"Content","\u002Fmarketing\u002Fcontent","5.marketing\u002Fcontent",{"title":342,"path":343,"stem":344},"Messaging","\u002Fmarketing\u002Fmessaging","5.marketing\u002Fmessaging",{"title":245,"path":346,"stem":347},"\u002Fmarketing\u002Ftools","5.marketing\u002Ftools",{"title":349,"path":350,"stem":351},"Website","\u002Fmarketing\u002Fwebsite","5.marketing\u002Fwebsite",{"title":353,"icon":354,"path":355,"stem":356,"children":357,"page":67},"AI & Data Ops","i-lucide-database","\u002Fdata-ops","6.data-ops",[358,362,370,395,416,420],{"title":359,"path":360,"stem":361},"Account Portal (CAS)","\u002Fdata-ops\u002Faccount-portal","6.data-ops\u002Faccount-portal",{"title":60,"path":363,"stem":364,"children":365,"page":67},"\u002Fdata-ops\u002Fcapability-exchange","6.data-ops\u002Fcapability-exchange",[366],{"title":367,"path":368,"stem":369},"Leaderboard Calculation","\u002Fdata-ops\u002Fcapability-exchange\u002Fleaderboard-calculation","6.data-ops\u002Fcapability-exchange\u002Fleaderboard-calculation",{"title":371,"path":372,"stem":373,"children":374,"page":67},"Data Management","\u002Fdata-ops\u002Fdata-management","6.data-ops\u002Fdata-management",[375,379,383,387,391],{"title":376,"path":377,"stem":378},"Adding Products","\u002Fdata-ops\u002Fdata-management\u002Fadding-products","6.data-ops\u002Fdata-management\u002Fadding-products",{"title":380,"path":381,"stem":382},"Adding Vendors","\u002Fdata-ops\u002Fdata-management\u002Fadding-vendors","6.data-ops\u002Fdata-management\u002Fadding-vendors",{"title":384,"path":385,"stem":386},"Framework Mapping","\u002Fdata-ops\u002Fdata-management\u002Fframework-mapping","6.data-ops\u002Fdata-management\u002Fframework-mapping",{"title":388,"path":389,"stem":390},"Refreshing Vendors","\u002Fdata-ops\u002Fdata-management\u002Frefreshing-vendors","6.data-ops\u002Fdata-management\u002Frefreshing-vendors",{"title":392,"path":393,"stem":394},"Reviewing Draft Vendors","\u002Fdata-ops\u002Fdata-management\u002Freviewing-draft-vendors","6.data-ops\u002Fdata-management\u002Freviewing-draft-vendors",{"title":396,"path":397,"stem":398,"children":399,"page":67},"LLM Ops","\u002Fdata-ops\u002Fllm-ops","6.data-ops\u002Fllm-ops",[400,404,408,412],{"title":401,"path":402,"stem":403},"Agents","\u002Fdata-ops\u002Fllm-ops\u002Fagents","6.data-ops\u002Fllm-ops\u002F1.agents",{"title":405,"path":406,"stem":407},"ESPi Architecture & Query Flow","\u002Fdata-ops\u002Fllm-ops\u002Fespi-architecture","6.data-ops\u002Fllm-ops\u002F2.espi-architecture",{"title":409,"path":410,"stem":411},"Evaluating Agents","\u002Fdata-ops\u002Fllm-ops\u002Fevaluations","6.data-ops\u002Fllm-ops\u002F3.evaluations",{"title":413,"path":414,"stem":415},"Benchmarking ESPi","\u002Fdata-ops\u002Fllm-ops\u002Fbenchmarking-espi","6.data-ops\u002Fllm-ops\u002F4.benchmarking-espi",{"title":417,"path":418,"stem":419},"Message Queues","\u002Fdata-ops\u002Fmessage-queues","6.data-ops\u002Fmessage-queues",{"title":421,"path":422,"stem":423,"children":424,"page":67},"Models","\u002Fdata-ops\u002Fmodels","6.data-ops\u002Fmodels",[425,429,433,437,441],{"title":426,"path":427,"stem":428},"Universal Framework Mapper Vision","\u002Fdata-ops\u002Fmodels\u002Funiversal-framework-mapper-vision","6.data-ops\u002Fmodels\u002F1.universal-framework-mapper-vision",{"title":430,"path":431,"stem":432},"Framework Description Model (FDM)","\u002Fdata-ops\u002Fmodels\u002Fframework-description-model","6.data-ops\u002Fmodels\u002F2.framework-description-model",{"title":434,"path":435,"stem":436},"Relationship Definition Model (RDM)","\u002Fdata-ops\u002Fmodels\u002Frelationship-definition-model","6.data-ops\u002Fmodels\u002F3.relationship-definition-model",{"title":438,"path":439,"stem":440},"Relationship Mapping Model (RMM)","\u002Fdata-ops\u002Fmodels\u002Frelationship-mapping-model","6.data-ops\u002Fmodels\u002F4.relationship-mapping-model",{"title":442,"path":443,"stem":444},"Platform Framework Matrix V2","\u002Fdata-ops\u002Fmodels\u002Fplatform-framework-matrix-v2","6.data-ops\u002Fmodels\u002F5.platform-framework-matrix-v2",{"title":446,"path":447,"stem":448},"Glossary","\u002Fglossary","glossary",{"id":450,"title":60,"body":451,"description":1402,"extension":1403,"links":1404,"meta":1405,"navigation":1406,"path":175,"seo":1407,"stem":176,"__hash__":1408},"docs\u002F3.engineering\u002Fdeployment\u002Fcapability-exchange.md",{"type":452,"value":453,"toc":1385},"minimark",[454,458,474,479,501,505,542,546,578,582,588,593,606,624,628,890,894,897,947,951,1031,1035,1097,1100,1103,1106,1210,1214,1224,1242,1381],[455,456,457],"p",{},"This guide walks you through deploying an updated version of the Capability Exchange (PCX) service in production using the AWS Console. No technical background required — just follow each step in order.",[459,460,462,463,468,469,473],"callout",{"icon":461},"i-lucide-info","If your release includes database schema changes, complete the ",[464,465,467],"a",{"href":466},"#database-migrations-if-required","database migrations"," ",[470,471,472],"strong",{},"before"," updating the ECS service.",[475,476,478],"h2",{"id":477},"prerequisites","Prerequisites",[480,481,482,490],"ul",{},[483,484,485,486,489],"li",{},"You have access to the ",[470,487,488],{},"AWS Console"," (via the ESProfiler Secured Workspace or direct login)",[483,491,492,493,496,497,500],{},"You are logged in as ",[470,494,495],{},"ESPROFILER"," in the ",[470,498,499],{},"Europe (London)"," region",[475,502,504],{"id":503},"part-1-navigate-to-ecs","Part 1: Navigate to ECS",[506,507,508,514,528,534],"ol",{},[483,509,510,511,513],{},"Open the ",[470,512,488],{},".",[483,515,516,517,523,524,527],{},"In the search bar at the top, type ",[470,518,519],{},[520,521,522],"code",{},"ECS"," and select ",[470,525,526],{},"Elastic Container Service"," from the results.",[483,529,530,531,513],{},"In the left-hand menu, click ",[470,532,533],{},"Clusters",[483,535,536,537,513],{},"You will see a list of clusters. Click on ",[470,538,539],{},[520,540,541],{},"esp-infrastructure",[475,543,545],{"id":544},"part-2-find-the-pcx-service","Part 2: Find the PCX Service",[506,547,549,559,568],{"start":548},5,[483,550,551,552,554,555,558],{},"Inside the ",[520,553,541],{}," cluster, click on the ",[470,556,557],{},"Services"," tab.",[483,560,561,562,567],{},"Find and click on the service named ",[470,563,564],{},[520,565,566],{},"esp-pcx-service-2bjz1boz"," (or the current PCX service listed).",[483,569,570,571,574,575,513],{},"You are now on the service's ",[470,572,573],{},"Health and metrics"," page. Confirm the status shows ",[470,576,577],{},"Active",[475,579,581],{"id":580},"part-3-database-migrations-if-required","Part 3: Database Migrations (if required)",[455,583,584,585,587],{},"If the release includes Prisma schema changes, run migrations against the production PCX database ",[470,586,472],{}," deploying the new service revision. The new container image will expect the updated schema to already be in place.",[589,590,592],"h3",{"id":591},"where-migrations-run-from","Where migrations run from",[455,594,595,596,599,600,603,604,513],{},"Production RDS lives in a ",[470,597,598],{},"private AWS network"," and is not reachable directly from your laptop. You need ",[470,601,602],{},"PuTTY"," (or an equivalent SSH client) to open a tunnel through the AWS jump box before you can connect. Full setup is documented in ",[464,605,217],{"href":218},[455,607,608,609,612,613,615,616,619,620,623],{},"Migrations are ",[470,610,611],{},"not"," applied by deploying a new ECS task. The live container does ",[470,614,611],{}," run migrations on startup. The migration is triggered by running a command on ",[470,617,618],{},"your machine",", using the migration files in your ",[470,621,622],{},"local PCX checkout"," of the release branch. The new container image does not need to be live in AWS first — you are pushing schema changes to the database ahead of the code deployment.",[589,625,627],{"id":626},"migration-workflow","Migration workflow",[506,629,630,640,661,675,802,828,852,879],{},[483,631,632,635,636,639],{},[470,633,634],{},"Check out the release"," — ensure your local PCX repo includes the migration files for this release. This should be the ",[520,637,638],{},"main"," branch.",[483,641,642,645,646,649,650,653,654,656,657],{},[470,643,644],{},"Open an SSH tunnel in PuTTY"," — forward local port ",[520,647,648],{},"15432"," to the PCX RDS endpoint on port ",[520,651,652],{},"5432"," (see ",[464,655,217],{"href":218}," if you have not done this before), then keep the session open.",[459,658,660],{"icon":659},"i-lucide-triangle-alert","Keep the PuTTY session open for the entire migration. The tunnel only works while the connection is active.",[483,662,663,666,667,670,671,674],{},[470,664,665],{},"Retrieve credentials"," — in AWS RDS (",[520,668,669],{},"eu-west-2","), open the PCX PostgreSQL instance, follow the linked secret in ",[470,672,673],{},"Configuration",", and copy the username and password from Secrets Manager. Do not store these permanently — they rotate regularly.",[483,676,677,680,681,684,685,688,689,692,693,696,697,707,709,710,728,730,731,734,735,734,738,741,742,755,757,758,760,761],{},[470,678,679],{},"Point your local environment at production"," — PCX uses Prisma, which reads the database connection from a ",[520,682,683],{},"DATABASE_URL"," environment variable. With the SSH tunnel from step 2 running, use ",[520,686,687],{},"127.0.0.1:15432"," as the host.",[690,691],"br",{},"In the PCX repository, open (or create) a ",[520,694,695],{},".env"," file in the project root and set:",[698,699,705],"pre",{"className":700,"code":702,"language":703,"meta":704},[701],"language-text","DATABASE_URL=\"postgresql:\u002F\u002F\u003Cusername>:\u003Cpassword>@127.0.0.1:15432\u002F\u003Cdatabase_name>\"\n","text","",[520,706,702],{"__ignoreMap":704},[690,708],{},"Replace:",[480,711,712,722],{},[483,713,714,717,718,721],{},[520,715,716],{},"\u003Cusername>"," and ",[520,719,720],{},"\u003Cpassword>"," — from Secrets Manager (step 3)",[483,723,724,727],{},[520,725,726],{},"\u003Cdatabase_name>"," — the database name shown in the RDS instance or secret (often the same as the instance identifier)",[690,729],{},"If the password contains special characters (e.g. ",[520,732,733],{},"@",", ",[520,736,737],{},"#",[520,739,740],{},"\u002F","), URL-encode them in the connection string.",[459,743,744,745,748,749,751,752,754],{"icon":659},"This points your local tooling at ",[470,746,747],{},"production",". Do not commit ",[520,750,695],{}," with production credentials, and revert or remove the production ",[520,753,683],{}," once migrations are complete.",[690,756],{},"To avoid editing ",[520,759,695],{}," permanently, you can set the variable for a single command instead:",[698,762,766],{"className":763,"code":764,"language":765,"meta":704,"style":704},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","DATABASE_URL=\"postgresql:\u002F\u002F\u003Cusername>:\u003Cpassword>@127.0.0.1:15432\u002F\u003Cdatabase_name>\" npx prisma migrate deploy\n","bash",[520,767,768],{"__ignoreMap":704},[769,770,773,776,780,783,787,789,793,796,799],"span",{"class":771,"line":772},"line",1,[769,774,683],{"class":775},"sTEyZ",[769,777,779],{"class":778},"sMK4o","=",[769,781,782],{"class":778},"\"",[769,784,786],{"class":785},"sfazB","postgresql:\u002F\u002F\u003Cusername>:\u003Cpassword>@127.0.0.1:15432\u002F\u003Cdatabase_name>",[769,788,782],{"class":778},[769,790,792],{"class":791},"sBMFI"," npx",[769,794,795],{"class":785}," prisma",[769,797,798],{"class":785}," migrate",[769,800,801],{"class":785}," deploy\n",[483,803,804,807,808,825,827],{},[470,805,806],{},"Confirm the connection"," — before running migrations:",[698,809,811],{"className":763,"code":810,"language":765,"meta":704,"style":704},"npx prisma migrate status\n",[520,812,813],{"__ignoreMap":704},[769,814,815,818,820,822],{"class":771,"line":772},[769,816,817],{"class":791},"npx",[769,819,795],{"class":785},[769,821,798],{"class":785},[769,823,824],{"class":785}," status\n",[690,826],{},"This should connect successfully and list any pending migrations.",[483,829,830,833,834,849,851],{},[470,831,832],{},"Run migrations"," — from the PCX project locally:",[698,835,837],{"className":763,"code":836,"language":765,"meta":704,"style":704},"npx prisma migrate deploy\n",[520,838,839],{"__ignoreMap":704},[769,840,841,843,845,847],{"class":771,"line":772},[769,842,817],{"class":791},[769,844,795],{"class":785},[769,846,798],{"class":785},[769,848,801],{"class":785},[690,850],{},"Review pending migrations first and confirm they match what is in the release.",[483,853,854,857,858,872,874,875,878],{},[470,855,856],{},"Verify"," — confirm migrations are complete:",[698,859,860],{"className":763,"code":810,"language":765,"meta":704,"style":704},[520,861,862],{"__ignoreMap":704},[769,863,864,866,868,870],{"class":771,"line":772},[769,865,817],{"class":791},[769,867,795],{"class":785},[769,869,798],{"class":785},[769,871,824],{"class":785},[690,873],{},"This should report ",[470,876,877],{},"Database schema is up to date!"," before proceeding to the ECS deployment below.",[483,880,881,884,885,887,888,513],{},[470,882,883],{},"Close the tunnel"," — once migrations are complete and verified, close the PuTTY session and revert or remove the production ",[520,886,683],{}," from your local ",[520,889,695],{},[475,891,893],{"id":892},"part-4-create-a-new-task-definition-revision","Part 4: Create a New Task Definition Revision",[455,895,896],{},"Before updating the service, you need to create a new version (revision) of the task definition with the latest image.",[506,898,900,905,913,922,936],{"start":899},9,[483,901,530,902,513],{},[470,903,904],{},"Task definitions",[483,906,907,908,513],{},"In the list of task definitions, click on ",[470,909,910],{},[520,911,912],{},"esp-pcx",[483,914,915,916,921],{},"You will see a list of revisions (e.g., esp-pcx:17, esp-pcx:16, etc.). Click the ",[470,917,918],{},[520,919,920],{},"Create new revision"," button in the top right.",[483,923,924,925,928,929,932,933,513],{},"On the new revision form, the container image should already point to the latest image (",[520,926,927],{},"esp-pcx:latest","). ",[470,930,931],{},"Do not change anything"," — just scroll to the bottom and click ",[470,934,935],{},"Create",[483,937,938,939,942,943,946],{},"You should see a green confirmation banner: ",[470,940,941],{},"\"Task definition successfully created\""," (e.g., ",[520,944,945],{},"esp-pcx:18",").",[475,948,950],{"id":949},"part-5-update-the-service-to-use-the-new-revision","Part 5: Update the Service to Use the New Revision",[506,952,954,976,984,1016,1025],{"start":953},14,[483,955,956,957],{},"Navigate back to the PCX service:\n",[480,958,959],{},[483,960,961,962,964,965,969,970,969,972],{},"Click ",[470,963,533],{}," in the left menu → ",[470,966,967],{},[520,968,541],{}," → ",[470,971,557],{},[470,973,974],{},[520,975,566],{},[483,977,978,979,921],{},"Click the orange ",[470,980,981],{},[520,982,983],{},"Update service",[483,985,986,987,990,991],{},"On the update screen, under ",[470,988,989],{},"Deployment configuration",":\n",[480,992,993,1002,1013],{},[483,994,995,996,999,1000],{},"Confirm the ",[470,997,998],{},"Task definition family"," is set to ",[520,1001,912],{},[483,1003,1004,1005,1008,1009,1012],{},"Set the ",[470,1006,1007],{},"Task definition revision"," to the latest revision number (e.g., ",[520,1010,1011],{},"18 (LATEST)",")",[483,1014,1015],{},"Leave all other settings as they are",[483,1017,1018,1019,1024],{},"Scroll to the bottom and click the orange ",[470,1020,1021],{},[520,1022,1023],{},"Update"," button.",[483,1026,1027,1028],{},"You should see a green banner: ",[470,1029,1030],{},"\"Service updated: esp-infrastructure:esp-pcx-service-2bjz1boz\"",[475,1032,1034],{"id":1033},"part-6-confirm-the-deployment","Part 6: Confirm the Deployment",[506,1036,1038,1045,1060,1073],{"start":1037},19,[483,1039,1040,1041,1044],{},"You will be taken to the ",[470,1042,1043],{},"Tasks"," tab of the service.",[483,1046,1047,1048,1051,1052,1055,1056,1059],{},"Watch the task list — you should briefly see ",[470,1049,1050],{},"2 tasks",": the old one (",[520,1053,1054],{},"Running",") and the new one (",[520,1057,1058],{},"Provisioning","). The old task will stop once the new one is healthy.",[483,1061,1062,1063,1066,1067,1069,1070,513],{},"Once complete, you should see ",[470,1064,1065],{},"1 task"," with status ",[470,1068,1054],{}," and the load balancer showing ",[470,1071,1072],{},"Healthy",[483,1074,1075,1076,1078,1079],{},"On the ",[470,1077,573],{}," tab, confirm:\n",[480,1080,1081,1090],{},[483,1082,1083,1086,1087],{},[470,1084,1085],{},"Deployment status"," = ",[520,1088,1089],{},"Success",[483,1091,1092,1086,1095],{},[470,1093,1094],{},"Target health",[520,1096,1072],{},[455,1098,1099],{},"✅ The PCX service has been successfully updated in production.",[1101,1102],"hr",{},[475,1104,203],{"id":1105},"troubleshooting",[1107,1108,1109,1122],"table",{},[1110,1111,1112],"thead",{},[1113,1114,1115,1119],"tr",{},[1116,1117,1118],"th",{},"Issue",[1116,1120,1121],{},"What to check",[1123,1124,1125,1145,1168,1178,1190,1198],"tbody",{},[1113,1126,1127,1137],{},[1128,1129,1130,1133,1134],"td",{},[520,1131,1132],{},"migrate deploy"," fails with ",[470,1135,1136],{},"P3005",[1128,1138,1139,1140,1144],{},"Database has schema but no Prisma migration history — see ",[464,1141,1143],{"href":1142},"#baselining-an-existing-production-database-p3005","baselining"," below. Production has already been baselined; this should only recur after a snapshot restore or similar.",[1113,1146,1147,1156],{},[1128,1148,1149,1133,1152,1155],{},[520,1150,1151],{},"migrate dev",[470,1153,1154],{},"P3006"," \u002F shadow database errors",[1128,1157,1158,1159,1161,1162,1164,1165,1167],{},"Do ",[470,1160,611],{}," use ",[520,1163,1151],{}," on production; use ",[520,1166,1132],{}," only.",[1113,1169,1170,1175],{},[1128,1171,1172,1173],{},"Connection refused on ",[520,1174,687],{},[1128,1176,1177],{},"PuTTY tunnel is not open, or local port forwarding is misconfigured.",[1113,1179,1180,1183],{},[1128,1181,1182],{},"Task stays in \"Provisioning\" for a long time",[1128,1184,1185,1186,1189],{},"Click the ",[470,1187,1188],{},"Events"," tab to see deployment messages",[1113,1191,1192,1195],{},[1128,1193,1194],{},"Deployment status shows \"In progress\"",[1128,1196,1197],{},"Wait 2–3 minutes and refresh — this is normal during rollover",[1113,1199,1200,1203],{},[1128,1201,1202],{},"Load balancer shows \"Unhealthy\"",[1128,1204,1205,1206,1209],{},"Check the ",[470,1207,1208],{},"Logs"," tab on the service for container errors",[589,1211,1213],{"id":1212},"baselining-an-existing-production-database-p3005","Baselining an existing production database (P3005)",[455,1215,1216,1217,717,1221,1167],{},"Production PCX has already been baselined. You should not need this for routine releases — use the ",[464,1218,1220],{"href":1219},"#migration-workflow","migration workflow",[520,1222,1223],{},"npx prisma migrate deploy",[455,1225,1226,1227,1133,1229,1231,1232,1235,1236,513],{},"Use this if ",[520,1228,1132],{},[470,1230,1136],{}," (\"database schema is not empty\"), typically after restoring from an RDS snapshot or bringing a database online that was created with ",[520,1233,1234],{},"prisma db push"," rather than migrations. See also ",[464,1237,1241],{"href":1238,"rel":1239},"https:\u002F\u002Fwww.prisma.io\u002Fdocs\u002Form\u002Fprisma-migrate\u002Fworkflows\u002Fbaselining",[1240],"nofollow","Prisma baselining",[506,1243,1244,1253,1279,1309,1346,1365,1376],{},[483,1245,1246,1247,1249,1250,1252],{},"Complete steps 1–5 of the ",[464,1248,1220],{"href":1219}," (tunnel, credentials, ",[520,1251,683],{},", confirm connection).",[483,1254,1255,1258,1259,1273,1275,1276,513],{},[470,1256,1257],{},"List pending migrations",":",[698,1260,1261],{"className":763,"code":810,"language":765,"meta":704,"style":704},[520,1262,1263],{"__ignoreMap":704},[769,1264,1265,1267,1269,1271],{"class":771,"line":772},[769,1266,817],{"class":791},[769,1268,795],{"class":785},[769,1270,798],{"class":785},[769,1272,824],{"class":785},[690,1274],{},"Note every migration folder listed as ",[470,1277,1278],{},"not yet applied",[483,1280,1281,1284,1285,1287,1288,1291,1292],{},[470,1282,1283],{},"Decide which migrations the database already has"," — for each pending migration, check whether its schema changes are already live (inspect via your client on ",[520,1286,687],{},", or read ",[520,1289,1290],{},"prisma\u002Fmigrations\u002F\u003Cfolder>\u002Fmigration.sql"," and confirm the objects exist). Split into:",[480,1293,1294,1300],{},[483,1295,1296,1299],{},[470,1297,1298],{},"Already in the database"," — mark as applied in step 4",[483,1301,1302,1305,1306,1308],{},[470,1303,1304],{},"Not yet in the database"," — leave for ",[520,1307,1132],{}," in step 5",[483,1310,1311,1314,1315,1258,1318],{},[470,1312,1313],{},"Mark each baseline migration as applied"," — run ",[470,1316,1317],{},"once per folder",[698,1319,1321],{"className":763,"code":1320,"language":765,"meta":704,"style":704},"npx prisma migrate resolve --applied \"\u003Cmigration_folder_name>\"\n",[520,1322,1323],{"__ignoreMap":704},[769,1324,1325,1327,1329,1331,1334,1337,1340,1343],{"class":771,"line":772},[769,1326,817],{"class":791},[769,1328,795],{"class":785},[769,1330,798],{"class":785},[769,1332,1333],{"class":785}," resolve",[769,1335,1336],{"class":785}," --applied",[769,1338,1339],{"class":778}," \"",[769,1341,1342],{"class":785},"\u003Cmigration_folder_name>",[769,1344,1345],{"class":778},"\"\n",[483,1347,1348,1258,1351],{},[470,1349,1350],{},"Deploy remaining migrations",[698,1352,1353],{"className":763,"code":836,"language":765,"meta":704,"style":704},[520,1354,1355],{"__ignoreMap":704},[769,1356,1357,1359,1361,1363],{"class":771,"line":772},[769,1358,817],{"class":791},[769,1360,795],{"class":785},[769,1362,798],{"class":785},[769,1364,801],{"class":785},[483,1366,1367,1369,1370,1373,1374],{},[470,1368,856],{}," with ",[520,1371,1372],{},"npx prisma migrate status"," — should report ",[470,1375,877],{},[483,1377,1378,1379,513],{},"Close the tunnel and revert your local ",[520,1380,683],{},[1382,1383,1384],"style",{},"html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":704,"searchDepth":1386,"depth":1386,"links":1387},2,[1388,1389,1390,1391,1396,1397,1398,1399],{"id":477,"depth":1386,"text":478},{"id":503,"depth":1386,"text":504},{"id":544,"depth":1386,"text":545},{"id":580,"depth":1386,"text":581,"children":1392},[1393,1395],{"id":591,"depth":1394,"text":592},3,{"id":626,"depth":1394,"text":627},{"id":892,"depth":1386,"text":893},{"id":949,"depth":1386,"text":950},{"id":1033,"depth":1386,"text":1034},{"id":1105,"depth":1386,"text":203,"children":1400},[1401],{"id":1212,"depth":1394,"text":1213},"Guide on how to update the production environment for the Capability Exchange","md",null,{},true,{"title":60,"description":1402},"BvT89aPr_uf-4PGcbGvf6nVeW0rbUD-HO2wGAzFbavk",[1410,1412],{"title":169,"path":170,"stem":171,"description":1411,"children":-1},"A comprehensive overview of the deployment process for new ESProfiler tenants",{"title":178,"path":179,"stem":180,"description":1413,"children":-1},"Complete step-by-step guide for deploying and configuring Langfuse on AWS ECS using our latest task definitions, EFS for ClickHouse, S3, ALB target groups, and Cloudflare.",1795106633324]