[{"data":1,"prerenderedAt":1462},["ShallowReactive",2],{"/blog/automating-container-image-migration-from-amazon-ecr-to-gitlab":3,"navigation-en-us":679,"banner-en-us":1104,"footer-en-us":1114,"blog-post-authors-en-us-Tim Rizzi":1358,"blog-related-posts-en-us-automating-container-image-migration-from-amazon-ecr-to-gitlab":1373,"blog-promotions-en-us":1399,"next-steps-en-us":1452},{"id":4,"title":5,"authors":6,"body":8,"category":656,"date":657,"description":658,"extension":659,"externalUrl":660,"faq":660,"featured":321,"heroImage":661,"meta":662,"navigation":321,"path":663,"seo":664,"slug":669,"stem":670,"tags":671,"template":677,"updatedDate":660,"__hash__":678},"blogPosts/en-us/blog/automating-container-image-migration-from-amazon-ecr-to-gitlab.md","Automating container image migration from Amazon ECR to GitLab",[7],"Tim Rizzi",{"type":9,"value":10,"toc":645},"minimark",[11,15,18,23,33,37,40,45,48,209,213,216,279,283,286,358,361,368,371,415,420,423,462,467,470,553,557,560,575,578,582,585,603,607,610,624,627,641],[12,13,14],"p",{},"\"We need to migrate hundreds of container images from Amazon Elastic Container Registry (ECR) to GitLab. Can you help?\" This question kept coming up in conversations with platform engineers. They were modernizing their DevSecOps toolchain with GitLab but got stuck when faced with moving their container images. While each image transfer is simple, the sheer volume made it daunting.",[12,16,17],{},"One platform engineer perfectly said, \"I know exactly what needs to be done – pull, retag, push. But I have 200 microservices, each with multiple tags. I can't justify spending weeks on this migration when I have critical infrastructure work.\"",[19,20,22],"h2",{"id":21},"the-challenge","The challenge",[12,24,25,26,32],{},"That conversation sparked an idea. What if we could automate the entire process? When platform teams move their ",[27,28,31],"a",{"href":29,"rel":30},"https://about.gitlab.com/topics/ci-cd/",[],"CI/CD"," to GitLab, migrating container images shouldn't be the bottleneck. The manual process is straightforward but repetitive – pull each image, retag it, and push it to GitLab's Container Registry. Multiply this by dozens of repositories and multiple tags per image, and you're looking at days or weeks of tedious work.",[19,34,36],{"id":35},"the-solution","The solution",[12,38,39],{},"We set out to create a GitLab pipeline that would automatically do all this heavy lifting. The goal was simple: Give platform engineers a tool they could set up in minutes and let run overnight, waking up to find all their images migrated successfully.",[41,42,44],"h3",{"id":43},"setting-up-access","Setting up access",[12,46,47],{},"First things first – security. We wanted to ensure teams could run this migration with minimal AWS permissions. Here's the read-only identity and access management (IAM) policy you'll need:",[49,50,55],"pre",{"className":51,"code":52,"language":53,"meta":54,"style":54},"language-json shiki shiki-themes github-light","{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"ecr:GetAuthorizationToken\",\n                \"ecr:BatchCheckLayerAvailability\",\n                \"ecr:GetDownloadUrlForLayer\",\n                \"ecr:DescribeRepositories\",\n                \"ecr:ListImages\",\n                \"ecr:DescribeImages\",\n                \"ecr:BatchGetImage\"\n            ],\n            \"Resource\": \"*\"\n        }\n    ]\n}\n","json","",[56,57,58,67,84,93,99,112,120,128,136,144,152,160,168,174,180,191,197,203],"code",{"__ignoreMap":54},[59,60,63],"span",{"class":61,"line":62},"line",1,[59,64,66],{"class":65},"sgsFI","{\n",[59,68,70,74,77,81],{"class":61,"line":69},2,[59,71,73],{"class":72},"sYu0t","    \"Version\"",[59,75,76],{"class":65},": ",[59,78,80],{"class":79},"sYBdl","\"2012-10-17\"",[59,82,83],{"class":65},",\n",[59,85,87,90],{"class":61,"line":86},3,[59,88,89],{"class":72},"    \"Statement\"",[59,91,92],{"class":65},": [\n",[59,94,96],{"class":61,"line":95},4,[59,97,98],{"class":65},"        {\n",[59,100,102,105,107,110],{"class":61,"line":101},5,[59,103,104],{"class":72},"            \"Effect\"",[59,106,76],{"class":65},[59,108,109],{"class":79},"\"Allow\"",[59,111,83],{"class":65},[59,113,115,118],{"class":61,"line":114},6,[59,116,117],{"class":72},"            \"Action\"",[59,119,92],{"class":65},[59,121,123,126],{"class":61,"line":122},7,[59,124,125],{"class":79},"                \"ecr:GetAuthorizationToken\"",[59,127,83],{"class":65},[59,129,131,134],{"class":61,"line":130},8,[59,132,133],{"class":79},"                \"ecr:BatchCheckLayerAvailability\"",[59,135,83],{"class":65},[59,137,139,142],{"class":61,"line":138},9,[59,140,141],{"class":79},"                \"ecr:GetDownloadUrlForLayer\"",[59,143,83],{"class":65},[59,145,147,150],{"class":61,"line":146},10,[59,148,149],{"class":79},"                \"ecr:DescribeRepositories\"",[59,151,83],{"class":65},[59,153,155,158],{"class":61,"line":154},11,[59,156,157],{"class":79},"                \"ecr:ListImages\"",[59,159,83],{"class":65},[59,161,163,166],{"class":61,"line":162},12,[59,164,165],{"class":79},"                \"ecr:DescribeImages\"",[59,167,83],{"class":65},[59,169,171],{"class":61,"line":170},13,[59,172,173],{"class":79},"                \"ecr:BatchGetImage\"\n",[59,175,177],{"class":61,"line":176},14,[59,178,179],{"class":65},"            ],\n",[59,181,183,186,188],{"class":61,"line":182},15,[59,184,185],{"class":72},"            \"Resource\"",[59,187,76],{"class":65},[59,189,190],{"class":79},"\"*\"\n",[59,192,194],{"class":61,"line":193},16,[59,195,196],{"class":65},"        }\n",[59,198,200],{"class":61,"line":199},17,[59,201,202],{"class":65},"    ]\n",[59,204,206],{"class":61,"line":205},18,[59,207,208],{"class":65},"}\n",[41,210,212],{"id":211},"gitlab-configuration","GitLab configuration",[12,214,215],{},"With security handled, the next step is setting up GitLab. We kept this minimal - you'll need to configure these variables in your CI/CD settings:",[49,217,221],{"className":218,"code":219,"language":220,"meta":54,"style":54},"language-yaml shiki shiki-themes github-light","AWS_ACCOUNT_ID: Your AWS account number\nAWS_DEFAULT_REGION: Your ECR region\nAWS_ACCESS_KEY_ID: [Masked]\nAWS_SECRET_ACCESS_KEY: [Masked]\nBULK_MIGRATE: true\n","yaml",[56,222,223,234,244,258,269],{"__ignoreMap":54},[59,224,225,229,231],{"class":61,"line":62},[59,226,228],{"class":227},"shJU0","AWS_ACCOUNT_ID",[59,230,76],{"class":65},[59,232,233],{"class":79},"Your AWS account number\n",[59,235,236,239,241],{"class":61,"line":69},[59,237,238],{"class":227},"AWS_DEFAULT_REGION",[59,240,76],{"class":65},[59,242,243],{"class":79},"Your ECR region\n",[59,245,246,249,252,255],{"class":61,"line":86},[59,247,248],{"class":227},"AWS_ACCESS_KEY_ID",[59,250,251],{"class":65},": [",[59,253,254],{"class":79},"Masked",[59,256,257],{"class":65},"]\n",[59,259,260,263,265,267],{"class":61,"line":95},[59,261,262],{"class":227},"AWS_SECRET_ACCESS_KEY",[59,264,251],{"class":65},[59,266,254],{"class":79},[59,268,257],{"class":65},[59,270,271,274,276],{"class":61,"line":101},[59,272,273],{"class":227},"BULK_MIGRATE",[59,275,76],{"class":65},[59,277,278],{"class":72},"true\n",[41,280,282],{"id":281},"the-migration-pipeline","The migration pipeline",[12,284,285],{},"Now for the interesting part. We built the pipeline using Docker-in-Docker to handle all the image operations reliably:",[49,287,289],{"className":218,"code":288,"language":220,"meta":54,"style":54},"image: docker:20.10\nservices:\n  - docker:20.10-dind\n\nbefore_script:\n  - apk add --no-cache aws-cli jq\n  - aws sts get-caller-identity\n  - aws ecr get-login-password | docker login --username AWS --password-stdin\n  - docker login -u ${CI_REGISTRY_USER} -p ${CI_REGISTRY_PASSWORD} ${CI_REGISTRY}\n\n",[56,290,291,301,309,317,323,330,337,344,351],{"__ignoreMap":54},[59,292,293,296,298],{"class":61,"line":62},[59,294,295],{"class":227},"image",[59,297,76],{"class":65},[59,299,300],{"class":79},"docker:20.10\n",[59,302,303,306],{"class":61,"line":69},[59,304,305],{"class":227},"services",[59,307,308],{"class":65},":\n",[59,310,311,314],{"class":61,"line":86},[59,312,313],{"class":65},"  - ",[59,315,316],{"class":79},"docker:20.10-dind\n",[59,318,319],{"class":61,"line":95},[59,320,322],{"emptyLinePlaceholder":321},true,"\n",[59,324,325,328],{"class":61,"line":101},[59,326,327],{"class":227},"before_script",[59,329,308],{"class":65},[59,331,332,334],{"class":61,"line":114},[59,333,313],{"class":65},[59,335,336],{"class":79},"apk add --no-cache aws-cli jq\n",[59,338,339,341],{"class":61,"line":122},[59,340,313],{"class":65},[59,342,343],{"class":79},"aws sts get-caller-identity\n",[59,345,346,348],{"class":61,"line":130},[59,347,313],{"class":65},[59,349,350],{"class":79},"aws ecr get-login-password | docker login --username AWS --password-stdin\n",[59,352,353,355],{"class":61,"line":138},[59,354,313],{"class":65},[59,356,357],{"class":79},"docker login -u ${CI_REGISTRY_USER} -p ${CI_REGISTRY_PASSWORD} ${CI_REGISTRY}\n",[12,359,360],{},"The pipeline works in three phases, each building on the last:",[362,363,364],"ol",{},[365,366,367],"li",{},"Discovery",[12,369,370],{},"First, it finds all your repositories:",[49,372,376],{"className":373,"code":374,"language":375,"meta":54,"style":54},"language-bash shiki shiki-themes github-light","REPOS=$(aws ecr describe-repositories --query 'repositories[*].repositoryName' --output text)\n","bash",[56,377,378],{"__ignoreMap":54},[59,379,380,383,387,390,394,397,400,403,406,409,412],{"class":61,"line":62},[59,381,382],{"class":65},"REPOS",[59,384,386],{"class":385},"sD7c4","=",[59,388,389],{"class":65},"$(",[59,391,393],{"class":392},"s7eDp","aws",[59,395,396],{"class":79}," ecr",[59,398,399],{"class":79}," describe-repositories",[59,401,402],{"class":72}," --query",[59,404,405],{"class":79}," 'repositories[*].repositoryName'",[59,407,408],{"class":72}," --output",[59,410,411],{"class":79}," text",[59,413,414],{"class":65},")\n",[362,416,417],{"start":69},[365,418,419],{},"Tag enumeration",[12,421,422],{},"Then, for each repository, it gets all the tags:",[49,424,426],{"className":373,"code":425,"language":375,"meta":54,"style":54},"TAGS=$(aws ecr describe-images --repository-name $repo --query 'imageDetails[*].imageTags[]' --output text)\n",[56,427,428],{"__ignoreMap":54},[59,429,430,433,435,437,439,441,444,447,450,453,456,458,460],{"class":61,"line":62},[59,431,432],{"class":65},"TAGS",[59,434,386],{"class":385},[59,436,389],{"class":65},[59,438,393],{"class":392},[59,440,396],{"class":79},[59,442,443],{"class":79}," describe-images",[59,445,446],{"class":72}," --repository-name",[59,448,449],{"class":65}," $repo ",[59,451,452],{"class":72},"--query",[59,454,455],{"class":79}," 'imageDetails[*].imageTags[]'",[59,457,408],{"class":72},[59,459,411],{"class":79},[59,461,414],{"class":65},[362,463,464],{"start":86},[365,465,466],{},"Transfer",[12,468,469],{},"Finally, it handles the actual migration:",[49,471,473],{"className":373,"code":472,"language":375,"meta":54,"style":54},"docker pull ${AWS_ACCOUNT_ID}.dkr.ecr.${AWS_DEFAULT_REGION}.amazonaws.com/${repo}:${tag}\ndocker tag ${AWS_ACCOUNT_ID}.dkr.ecr.${AWS_DEFAULT_REGION}.amazonaws.com/${repo}:${tag} ${CI_REGISTRY_IMAGE}/${repo}:${tag}\ndocker push ${CI_REGISTRY_IMAGE}/${repo}:${tag}\n",[56,474,475,504,535],{"__ignoreMap":54},[59,476,477,480,483,486,489,492,495,498,501],{"class":61,"line":62},[59,478,479],{"class":392},"docker",[59,481,482],{"class":79}," pull",[59,484,485],{"class":65}," ${AWS_ACCOUNT_ID}",[59,487,488],{"class":79},".dkr.ecr.",[59,490,491],{"class":65},"${AWS_DEFAULT_REGION}",[59,493,494],{"class":79},".amazonaws.com/",[59,496,497],{"class":65},"${repo}",[59,499,500],{"class":79},":",[59,502,503],{"class":65},"${tag}\n",[59,505,506,508,511,513,515,517,519,521,523,526,529,531,533],{"class":61,"line":69},[59,507,479],{"class":392},[59,509,510],{"class":79}," tag",[59,512,485],{"class":65},[59,514,488],{"class":79},[59,516,491],{"class":65},[59,518,494],{"class":79},[59,520,497],{"class":65},[59,522,500],{"class":79},[59,524,525],{"class":65},"${tag} ${CI_REGISTRY_IMAGE}",[59,527,528],{"class":79},"/",[59,530,497],{"class":65},[59,532,500],{"class":79},[59,534,503],{"class":65},[59,536,537,539,542,545,547,549,551],{"class":61,"line":86},[59,538,479],{"class":392},[59,540,541],{"class":79}," push",[59,543,544],{"class":65}," ${CI_REGISTRY_IMAGE}",[59,546,528],{"class":79},[59,548,497],{"class":65},[59,550,500],{"class":79},[59,552,503],{"class":65},[19,554,556],{"id":555},"what-you-get","What you get",[12,558,559],{},"Remember that platform engineer who didn't want to spend weeks on migration? Here's what this solution delivers:",[561,562,563,566,569,572],"ul",{},[365,564,565],{},"automated discovery and migration of all repositories and tags",[365,567,568],{},"consistent image naming between ECR and GitLab",[365,570,571],{},"error handling for failed transfers",[365,573,574],{},"clear logging for tracking progress",[12,576,577],{},"Instead of writing scripts and babysitting the migration, the platform engineer could focus on more valuable work.",[19,579,581],{"id":580},"usage","Usage",[12,583,584],{},"Getting started is straightforward:",[362,586,587,594,597],{},[365,588,589,590,593],{},"Copy the ",[56,591,592],{},".gitlab-ci.yml"," to your repository.",[365,595,596],{},"Configure the AWS and GitLab variables.",[365,598,599,600,602],{},"Set ",[56,601,273],{}," to \"true\" to start the migration.",[19,604,606],{"id":605},"best-practices","Best practices",[12,608,609],{},"Through helping teams with their migrations, we've learned a few things:",[561,611,612,615,618,621],{},[365,613,614],{},"Run during off-peak hours to minimize the impact on your team.",[365,616,617],{},"Keep an eye on the pipeline logs - they'll tell you if anything needs attention.",[365,619,620],{},"Don't decommission ECR until you've verified all images transferred successfully.",[365,622,623],{},"For very large migrations, consider adding rate limiting to avoid overwhelming your network",[12,625,626],{},"We've open-sourced this pipeline in our public GitLab repository because we believe platform engineers should spend time building valuable infrastructure, not copying container images. Feel free to adapt it for your needs or ask questions about implementation.",[628,629,630],"blockquote",{},[631,632,634,635,640],"h4",{"id":633},"get-started-with-this-and-other-package-components-with-our-cicd-catalog-documentation","Get started with this and other package components with our ",[27,636,639],{"href":637,"rel":638},"https://gitlab.com/explore/catalog/components/package",[],"CI/CD Catalog documentation",".",[642,643,644],"style",{},"html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}html pre.shiki code .sYu0t, html code.shiki .sYu0t{--shiki-default:#005CC5}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}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 pre.shiki code .shJU0, html code.shiki .shJU0{--shiki-default:#22863A}html pre.shiki code .sD7c4, html code.shiki .sD7c4{--shiki-default:#D73A49}html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}",{"title":54,"searchDepth":69,"depth":69,"links":646},[647,648,653,654,655],{"id":21,"depth":69,"text":22},{"id":35,"depth":69,"text":36,"children":649},[650,651,652],{"id":43,"depth":86,"text":44},{"id":211,"depth":86,"text":212},{"id":281,"depth":86,"text":282},{"id":555,"depth":69,"text":556},{"id":580,"depth":69,"text":581},{"id":605,"depth":69,"text":606},"engineering","2025-02-13","When platform teams move their CI/CD to GitLab, migrating container images shouldn't be the bottleneck. Follow this step-by-step guide to automate the pipeline migration process.","md",null,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749663129/Blog/Hero%20Images/blog-image-template-1800x945__28_.png",{},"/en-us/blog/automating-container-image-migration-from-amazon-ecr-to-gitlab",{"title":5,"description":658,"ogTitle":5,"ogDescription":658,"noIndex":665,"ogImage":661,"ogUrl":666,"ogSiteName":667,"ogType":668,"canonicalUrls":666},false,"https://about.gitlab.com/blog/automating-container-image-migration-from-amazon-ecr-to-gitlab","https://about.gitlab.com","article","automating-container-image-migration-from-amazon-ecr-to-gitlab","en-us/blog/automating-container-image-migration-from-amazon-ecr-to-gitlab",[31,672,673,674,675,676],"AWS","tutorial","DevSecOps platform","product","solutions architecture","BlogPost","DpiAkxhp9rgzn8I-umPV88gk223QpuQ9OzKuRRWxWb8",{"logo":680,"freeTrial":684,"sales":689,"login":694,"items":699,"search":1024,"minimal":1055,"duo":1074,"switchNav":1083,"pricingDeployment":1094},{"config":681},{"href":528,"dataGaName":682,"dataGaLocation":683},"gitlab logo","header",{"text":685,"config":686},"Get free trial",{"href":687,"dataGaName":688,"dataGaLocation":683},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":690,"config":691},"Request a demo",{"href":692,"dataGaName":693,"dataGaLocation":683},"/sales/?contact-topic=request-demo","sales",{"text":695,"config":696},"Sign in",{"href":697,"dataGaName":698,"dataGaLocation":683},"https://gitlab.com/users/sign_in/","sign in",[700,729,828,833,946,1002],{"text":701,"config":702,"menu":704},"Platform",{"dataNavLevelOne":703},"platform",{"type":705,"columns":706},"cards",[707,713,721],{"title":701,"description":708,"link":709},"The intelligent orchestration platform for DevSecOps",{"text":710,"config":711},"Explore our Platform",{"href":712,"dataGaName":703,"dataGaLocation":683},"/platform/",{"title":714,"description":715,"link":716},"GitLab Duo Agent Platform","Agentic AI for the entire software lifecycle",{"text":717,"config":718},"Meet GitLab Duo",{"href":719,"dataGaName":720,"dataGaLocation":683},"/gitlab-duo-agent-platform/","gitlab duo agent platform",{"title":722,"description":723,"link":724},"Why GitLab","See the top reasons enterprises choose GitLab",{"text":725,"config":726},"Learn more",{"href":727,"dataGaName":728,"dataGaLocation":683},"/why-gitlab/","why gitlab",{"text":730,"left":321,"config":731,"menu":733},"Product",{"dataNavLevelOne":732},"solutions",{"type":734,"link":735,"columns":739,"feature":807},"lists",{"text":736,"config":737},"View all Solutions",{"href":738,"dataGaName":732,"dataGaLocation":683},"/solutions/",[740,763,786],{"title":741,"description":742,"link":743,"items":748},"Automation","CI/CD and automation to accelerate deployment",{"config":744},{"icon":745,"href":746,"dataGaName":747,"dataGaLocation":683},"AutomatedCodeAlt","/solutions/delivery-automation/","automated software delivery",[749,752,755,759],{"text":31,"config":750},{"href":751,"dataGaLocation":683,"dataGaName":31},"/solutions/continuous-integration/",{"text":714,"config":753},{"href":719,"dataGaLocation":683,"dataGaName":754},"gitlab duo agent platform - product menu",{"text":756,"config":757},"Source Code Management",{"href":758,"dataGaLocation":683,"dataGaName":756},"/solutions/source-code-management/",{"text":760,"config":761},"Automated Software Delivery",{"href":746,"dataGaLocation":683,"dataGaName":762},"Automated software delivery",{"title":764,"description":765,"link":766,"items":771},"Security","Deliver code faster without compromising security",{"config":767},{"href":768,"dataGaName":769,"dataGaLocation":683,"icon":770},"/solutions/application-security-testing/","security and compliance","ShieldCheckLight",[772,776,781],{"text":773,"config":774},"Application Security Testing",{"href":768,"dataGaName":775,"dataGaLocation":683},"Application security testing",{"text":777,"config":778},"Software Supply Chain Security",{"href":779,"dataGaLocation":683,"dataGaName":780},"/solutions/supply-chain/","Software supply chain security",{"text":782,"config":783},"Software Compliance",{"href":784,"dataGaName":785,"dataGaLocation":683},"/solutions/software-compliance/","software compliance",{"title":787,"link":788,"items":793},"Measurement",{"config":789},{"icon":790,"href":791,"dataGaName":792,"dataGaLocation":683},"DigitalTransformation","/solutions/visibility-measurement/","visibility and measurement",[794,798,802],{"text":795,"config":796},"Visibility & Measurement",{"href":791,"dataGaLocation":683,"dataGaName":797},"Visibility and Measurement",{"text":799,"config":800},"Value Stream Management",{"href":801,"dataGaLocation":683,"dataGaName":799},"/solutions/value-stream-management/",{"text":803,"config":804},"Analytics & Insights",{"href":805,"dataGaLocation":683,"dataGaName":806},"/solutions/analytics-and-insights/","Analytics and insights",{"title":808,"type":734,"items":809},"GitLab for",[810,816,822],{"text":811,"config":812},"Enterprise",{"icon":813,"href":814,"dataGaLocation":683,"dataGaName":815},"Building","/enterprise/","enterprise",{"text":817,"config":818},"Small Business",{"icon":819,"href":820,"dataGaLocation":683,"dataGaName":821},"Work","/small-business/","small business",{"text":823,"config":824},"Public Sector",{"icon":825,"href":826,"dataGaLocation":683,"dataGaName":827},"Organization","/solutions/public-sector/","public sector",{"text":829,"config":830},"Pricing",{"href":831,"dataGaName":832,"dataGaLocation":683,"dataNavLevelOne":832},"/pricing/","pricing",{"text":834,"config":835,"menu":837},"Resources",{"dataNavLevelOne":836},"resources",{"type":734,"link":838,"columns":842,"feature":935},{"text":839,"config":840},"View all resources",{"href":841,"dataGaName":836,"dataGaLocation":683},"/resources/",[843,876,903],{"title":844,"items":845},"Getting started",[846,851,856,861,866,871],{"text":847,"config":848},"Install",{"href":849,"dataGaName":850,"dataGaLocation":683},"/install/","install",{"text":852,"config":853},"Quick start guides",{"href":854,"dataGaName":855,"dataGaLocation":683},"/get-started/","quick setup checklists",{"text":857,"config":858},"Learn",{"href":859,"dataGaLocation":683,"dataGaName":860},"https://university.gitlab.com/","learn",{"text":862,"config":863},"Product documentation",{"href":864,"dataGaName":865,"dataGaLocation":683},"https://docs.gitlab.com/","product documentation",{"text":867,"config":868},"Best practice videos",{"href":869,"dataGaName":870,"dataGaLocation":683},"/getting-started-videos/","best practice videos",{"text":872,"config":873},"Integrations",{"href":874,"dataGaName":875,"dataGaLocation":683},"/integrations/","integrations",{"title":877,"items":878},"Discover",[879,884,889,894,898],{"text":880,"config":881},"Customer success stories",{"href":882,"dataGaName":883,"dataGaLocation":683},"/customers/","customer success stories",{"text":885,"config":886},"Blog",{"href":887,"dataGaName":888,"dataGaLocation":683},"/blog/","blog",{"text":890,"config":891},"Demo Hub",{"href":892,"dataGaName":893,"dataGaLocation":683},"/demo-hub/","demo hub",{"text":895,"config":896},"The Source",{"href":897,"dataGaName":888,"dataGaLocation":683},"/the-source/",{"text":899,"config":900},"Remote",{"href":901,"dataGaName":902,"dataGaLocation":683},"https://handbook.gitlab.com/handbook/company/culture/all-remote/","remote",{"title":904,"items":905},"Connect",[906,910,915,920,925,930],{"text":907,"config":908},"GitLab Services",{"href":909,"dataGaName":305,"dataGaLocation":683},"/services/",{"text":911,"config":912},"Contribute",{"href":913,"dataGaName":914,"dataGaLocation":683},"https://contributors.gitlab.com","contribute",{"text":916,"config":917},"Community",{"href":918,"dataGaName":919,"dataGaLocation":683},"/community/","community",{"text":921,"config":922},"Forum",{"href":923,"dataGaName":924,"dataGaLocation":683},"https://forum.gitlab.com/","forum",{"text":926,"config":927},"Events",{"href":928,"dataGaName":929,"dataGaLocation":683},"/events/","events",{"text":931,"config":932},"Partners",{"href":933,"dataGaName":934,"dataGaLocation":683},"/partners/","partners",{"config":936,"title":939,"text":940,"link":941},{"background":937,"textColor":938},"url('https://res.cloudinary.com/about-gitlab-com/image/upload/v1777322348/qpq8yrgn8knii57omj0c.png')","#000","What’s new in GitLab","Stay updated with our latest features and improvements.",{"text":942,"config":943},"Read the latest",{"href":944,"dataGaName":945,"dataGaLocation":683},"/whats-new/","whats new",{"text":947,"config":948,"menu":950},"Company",{"dataNavLevelOne":949},"company",{"type":734,"columns":951},[952],{"items":953},[954,959,965,967,972,977,982,987,992,997],{"text":955,"config":956},"About",{"href":957,"dataGaName":958,"dataGaLocation":683},"/company/","about",{"text":960,"config":961,"footerGa":964},"Jobs",{"href":962,"dataGaName":963,"dataGaLocation":683},"/jobs/","jobs",{"dataGaName":963},{"text":926,"config":966},{"href":928,"dataGaName":929,"dataGaLocation":683},{"text":968,"config":969},"Leadership",{"href":970,"dataGaName":971,"dataGaLocation":683},"/company/team/e-group/","leadership",{"text":973,"config":974},"Handbook",{"href":975,"dataGaName":976,"dataGaLocation":683},"https://handbook.gitlab.com/","handbook",{"text":978,"config":979},"Investor relations",{"href":980,"dataGaName":981,"dataGaLocation":683},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":983,"config":984},"Trust Center",{"href":985,"dataGaName":986,"dataGaLocation":683},"/security/","trust center",{"text":988,"config":989},"AI Transparency Center",{"href":990,"dataGaName":991,"dataGaLocation":683},"/ai-transparency-center/","ai transparency center",{"text":993,"config":994},"Newsletter",{"href":995,"dataGaName":996,"dataGaLocation":683},"/company/contact/#contact-forms","newsletter",{"text":998,"config":999},"Press",{"href":1000,"dataGaName":1001,"dataGaLocation":683},"/press/","press",{"text":1003,"config":1004,"menu":1005},"Contact us",{"dataNavLevelOne":949},{"type":734,"columns":1006},[1007],{"items":1008},[1009,1014,1019],{"text":1010,"config":1011},"Talk to sales",{"href":1012,"dataGaName":1013,"dataGaLocation":683},"/sales/","talk to sales",{"text":1015,"config":1016},"Support portal",{"href":1017,"dataGaName":1018,"dataGaLocation":683},"https://support.gitlab.com/hc/en-us","support portal",{"text":1020,"config":1021},"Customer portal",{"href":1022,"dataGaName":1023,"dataGaLocation":683},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":1025,"login":1026,"suggestions":1033},"Close",{"text":1027,"link":1028},"To search repositories and projects, login to",{"text":1029,"config":1030},"gitlab.com",{"href":697,"dataGaName":1031,"dataGaLocation":1032},"search login","search",{"text":1034,"default":1035},"Suggestions",[1036,1038,1042,1044,1048,1052],{"text":714,"config":1037},{"href":719,"dataGaName":714,"dataGaLocation":1032},{"text":1039,"config":1040},"Code Suggestions (AI)",{"href":1041,"dataGaName":1039,"dataGaLocation":1032},"/solutions/code-suggestions/",{"text":31,"config":1043},{"href":751,"dataGaName":31,"dataGaLocation":1032},{"text":1045,"config":1046},"GitLab on AWS",{"href":1047,"dataGaName":1045,"dataGaLocation":1032},"/partners/technology-partners/aws/",{"text":1049,"config":1050},"GitLab on Google Cloud",{"href":1051,"dataGaName":1049,"dataGaLocation":1032},"/partners/technology-partners/google-cloud-platform/",{"text":1053,"config":1054},"Why GitLab?",{"href":727,"dataGaName":1053,"dataGaLocation":1032},{"freeTrial":1056,"mobileIcon":1061,"desktopIcon":1066,"secondaryButton":1069},{"text":1057,"config":1058},"Start free trial",{"href":1059,"dataGaName":688,"dataGaLocation":1060},"https://gitlab.com/-/trials/new/","nav",{"altText":1062,"config":1063},"Gitlab Icon",{"src":1064,"dataGaName":1065,"dataGaLocation":1060},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":1062,"config":1067},{"src":1068,"dataGaName":1065,"dataGaLocation":1060},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":1070,"config":1071},"Get Started",{"href":1072,"dataGaName":1073,"dataGaLocation":1060},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":1075,"mobileIcon":1079,"desktopIcon":1081},{"text":1076,"config":1077},"Learn more about GitLab Duo",{"href":719,"dataGaName":1078,"dataGaLocation":1060},"gitlab duo",{"altText":1062,"config":1080},{"src":1064,"dataGaName":1065,"dataGaLocation":1060},{"altText":1062,"config":1082},{"src":1068,"dataGaName":1065,"dataGaLocation":1060},{"button":1084,"mobileIcon":1089,"desktopIcon":1091},{"text":1085,"config":1086},"/switch",{"href":1087,"dataGaName":1088,"dataGaLocation":1060},"#contact","switch",{"altText":1062,"config":1090},{"src":1064,"dataGaName":1065,"dataGaLocation":1060},{"altText":1062,"config":1092},{"src":1093,"dataGaName":1065,"dataGaLocation":1060},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":1095,"mobileIcon":1100,"desktopIcon":1102},{"text":1096,"config":1097},"Back to pricing",{"href":831,"dataGaName":1098,"dataGaLocation":1060,"icon":1099},"back to pricing","GoBack",{"altText":1062,"config":1101},{"src":1064,"dataGaName":1065,"dataGaLocation":1060},{"altText":1062,"config":1103},{"src":1068,"dataGaName":1065,"dataGaLocation":1060},{"title":1105,"titleMobile":1106,"button":1107,"config":1112},"Duo Agent Platform delivers 400% ROI, per new Forrester Consulting study.","400% ROI: Forrester TEI for GitLab Duo",{"text":725,"config":1108},{"href":1109,"dataGaName":1110,"dataGaLocation":1111},"https://about.gitlab.com/blog/gitlab-duo-agent-platform-delivers-400-percent-roi/","forrester-tei-dap-banner","global-banner",{"layout":1113,"disabled":665},"release",{"data":1115},{"text":1116,"source":1117,"edit":1123,"contribute":1128,"config":1133,"items":1138,"minimal":1347},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"text":1118,"config":1119},"View page source",{"href":1120,"dataGaName":1121,"dataGaLocation":1122},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/","page source","footer",{"text":1124,"config":1125},"Edit this page",{"href":1126,"dataGaName":1127,"dataGaLocation":1122},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/content/","web ide",{"text":1129,"config":1130},"Please contribute",{"href":1131,"dataGaName":1132,"dataGaLocation":1122},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/CONTRIBUTING.md/","please contribute",{"twitter":1134,"facebook":1135,"youtube":1136,"linkedin":1137},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[1139,1186,1239,1283,1315],{"title":829,"links":1140,"subMenu":1155},[1141,1145,1150],{"text":1142,"config":1143},"View plans",{"href":831,"dataGaName":1144,"dataGaLocation":1122},"view plans",{"text":1146,"config":1147},"Why Premium?",{"href":1148,"dataGaName":1149,"dataGaLocation":1122},"/pricing/premium/","why premium",{"text":1151,"config":1152},"Why Ultimate?",{"href":1153,"dataGaName":1154,"dataGaLocation":1122},"/pricing/ultimate/","why ultimate",[1156],{"title":1157,"links":1158},"Contact Us",[1159,1162,1164,1166,1171,1176,1181],{"text":1160,"config":1161},"Contact sales",{"href":1012,"dataGaName":693,"dataGaLocation":1122},{"text":1015,"config":1163},{"href":1017,"dataGaName":1018,"dataGaLocation":1122},{"text":1020,"config":1165},{"href":1022,"dataGaName":1023,"dataGaLocation":1122},{"text":1167,"config":1168},"Status",{"href":1169,"dataGaName":1170,"dataGaLocation":1122},"https://status.gitlab.com/","status",{"text":1172,"config":1173},"Terms of use",{"href":1174,"dataGaName":1175,"dataGaLocation":1122},"/terms/","terms of use",{"text":1177,"config":1178},"Privacy statement",{"href":1179,"dataGaName":1180,"dataGaLocation":1122},"/privacy/","privacy statement",{"text":1182,"config":1183},"Cookie preferences",{"dataGaName":1184,"dataGaLocation":1122,"id":1185,"isOneTrustButton":321},"cookie preferences","ot-sdk-btn",{"title":730,"links":1187,"subMenu":1195},[1188,1191],{"text":674,"config":1189},{"href":712,"dataGaName":1190,"dataGaLocation":1122},"devsecops platform",{"text":1192,"config":1193},"AI-Assisted Development",{"href":719,"dataGaName":1194,"dataGaLocation":1122},"ai-assisted development",[1196],{"title":1197,"links":1198},"Topics",[1199,1204,1209,1214,1219,1224,1229,1234],{"text":1200,"config":1201},"CICD",{"href":1202,"dataGaName":1203,"dataGaLocation":1122},"/topics/ci-cd/","cicd",{"text":1205,"config":1206},"GitOps",{"href":1207,"dataGaName":1208,"dataGaLocation":1122},"/topics/gitops/","gitops",{"text":1210,"config":1211},"DevOps",{"href":1212,"dataGaName":1213,"dataGaLocation":1122},"/topics/devops/","devops",{"text":1215,"config":1216},"Version Control",{"href":1217,"dataGaName":1218,"dataGaLocation":1122},"/topics/version-control/","version control",{"text":1220,"config":1221},"DevSecOps",{"href":1222,"dataGaName":1223,"dataGaLocation":1122},"/topics/devsecops/","devsecops",{"text":1225,"config":1226},"Cloud Native",{"href":1227,"dataGaName":1228,"dataGaLocation":1122},"/topics/cloud-native/","cloud native",{"text":1230,"config":1231},"AI for Coding",{"href":1232,"dataGaName":1233,"dataGaLocation":1122},"/topics/devops/ai-for-coding/","ai for coding",{"text":1235,"config":1236},"Agentic AI",{"href":1237,"dataGaName":1238,"dataGaLocation":1122},"/topics/agentic-ai/","agentic ai",{"title":1240,"links":1241},"Solutions",[1242,1244,1246,1251,1255,1258,1262,1265,1267,1270,1273,1278],{"text":773,"config":1243},{"href":768,"dataGaName":773,"dataGaLocation":1122},{"text":762,"config":1245},{"href":746,"dataGaName":747,"dataGaLocation":1122},{"text":1247,"config":1248},"Agile development",{"href":1249,"dataGaName":1250,"dataGaLocation":1122},"/solutions/agile-delivery/","agile delivery",{"text":1252,"config":1253},"SCM",{"href":758,"dataGaName":1254,"dataGaLocation":1122},"source code management",{"text":1200,"config":1256},{"href":751,"dataGaName":1257,"dataGaLocation":1122},"continuous integration & delivery",{"text":1259,"config":1260},"Value stream management",{"href":801,"dataGaName":1261,"dataGaLocation":1122},"value stream management",{"text":1205,"config":1263},{"href":1264,"dataGaName":1208,"dataGaLocation":1122},"/solutions/gitops/",{"text":811,"config":1266},{"href":814,"dataGaName":815,"dataGaLocation":1122},{"text":1268,"config":1269},"Small business",{"href":820,"dataGaName":821,"dataGaLocation":1122},{"text":1271,"config":1272},"Public sector",{"href":826,"dataGaName":827,"dataGaLocation":1122},{"text":1274,"config":1275},"Education",{"href":1276,"dataGaName":1277,"dataGaLocation":1122},"/solutions/education/","education",{"text":1279,"config":1280},"Financial services",{"href":1281,"dataGaName":1282,"dataGaLocation":1122},"/solutions/finance/","financial services",{"title":834,"links":1284},[1285,1287,1289,1291,1294,1296,1299,1301,1303,1305,1307,1309,1311,1313],{"text":847,"config":1286},{"href":849,"dataGaName":850,"dataGaLocation":1122},{"text":852,"config":1288},{"href":854,"dataGaName":855,"dataGaLocation":1122},{"text":857,"config":1290},{"href":859,"dataGaName":860,"dataGaLocation":1122},{"text":862,"config":1292},{"href":864,"dataGaName":1293,"dataGaLocation":1122},"docs",{"text":885,"config":1295},{"href":887,"dataGaName":888,"dataGaLocation":1122},{"text":1297,"config":1298},"What's new",{"href":944,"dataGaName":945,"dataGaLocation":1122},{"text":880,"config":1300},{"href":882,"dataGaName":883,"dataGaLocation":1122},{"text":899,"config":1302},{"href":901,"dataGaName":902,"dataGaLocation":1122},{"text":907,"config":1304},{"href":909,"dataGaName":305,"dataGaLocation":1122},{"text":911,"config":1306},{"href":913,"dataGaName":914,"dataGaLocation":1122},{"text":916,"config":1308},{"href":918,"dataGaName":919,"dataGaLocation":1122},{"text":921,"config":1310},{"href":923,"dataGaName":924,"dataGaLocation":1122},{"text":926,"config":1312},{"href":928,"dataGaName":929,"dataGaLocation":1122},{"text":931,"config":1314},{"href":933,"dataGaName":934,"dataGaLocation":1122},{"title":947,"links":1316},[1317,1319,1321,1323,1325,1327,1331,1336,1338,1340,1342],{"text":955,"config":1318},{"href":957,"dataGaName":949,"dataGaLocation":1122},{"text":960,"config":1320},{"href":962,"dataGaName":963,"dataGaLocation":1122},{"text":968,"config":1322},{"href":970,"dataGaName":971,"dataGaLocation":1122},{"text":973,"config":1324},{"href":975,"dataGaName":976,"dataGaLocation":1122},{"text":978,"config":1326},{"href":980,"dataGaName":981,"dataGaLocation":1122},{"text":1328,"config":1329},"Sustainability",{"href":1330,"dataGaName":1328,"dataGaLocation":1122},"/sustainability/",{"text":1332,"config":1333},"Diversity, inclusion and belonging (DIB)",{"href":1334,"dataGaName":1335,"dataGaLocation":1122},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":983,"config":1337},{"href":985,"dataGaName":986,"dataGaLocation":1122},{"text":993,"config":1339},{"href":995,"dataGaName":996,"dataGaLocation":1122},{"text":998,"config":1341},{"href":1000,"dataGaName":1001,"dataGaLocation":1122},{"text":1343,"config":1344},"Modern Slavery Transparency Statement",{"href":1345,"dataGaName":1346,"dataGaLocation":1122},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":1348},[1349,1352,1355],{"text":1350,"config":1351},"Terms",{"href":1174,"dataGaName":1175,"dataGaLocation":1122},{"text":1353,"config":1354},"Cookies",{"dataGaName":1184,"dataGaLocation":1122,"id":1185,"isOneTrustButton":321},{"text":1356,"config":1357},"Privacy",{"href":1179,"dataGaName":1180,"dataGaLocation":1122},[1359],{"id":1360,"title":7,"body":660,"config":1361,"content":1363,"description":660,"extension":1367,"meta":1368,"navigation":321,"path":1369,"seo":1370,"stem":1371,"__hash__":1372},"blogAuthors/en-us/blog/authors/tim-rizzi.yml",{"template":1362},"BlogAuthor",{"name":7,"config":1364},{"headshot":1365,"ctfId":1366},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749661866/Blog/Author%20Headshots/trizzi-headshot.jpg","trizzi","yml",{},"/en-us/blog/authors/tim-rizzi",{},"en-us/blog/authors/tim-rizzi","ADPqrpcnKveFJS0m_zFV0VLtb_h_txu59QVgz_YwKMc",[1374,1383,1391],{"title":1375,"description":1376,"heroImage":1377,"category":656,"date":1378,"authors":1379,"slug":1382,"externalUrl":660},"Confidential AI for GitLab Self-Hosted","Give developers AI coding agents in GitLab Duo without source code leaving a hardware-encrypted boundary — no GPUs needed.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1773866173/vte9qh8rriznvyclhkes.png","2026-08-06",[1380,1381],"Mathias Ewald","Martin Paloncy, Edgeless Systems","confidential-ai-for-gitlab-self-hosted",{"title":1384,"description":1385,"heroImage":1386,"category":656,"date":1387,"authors":1388,"slug":1390,"externalUrl":660},"Green DevOps: Why carbon measurement belongs in your CI/CD pipeline","CI/CD pipelines have a hidden carbon cost. Here's why measuring it matters, and how you can get started with Eco CI and Carmen in GitLab.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1765809212/noh0mdfn9o94ry9ykura.png","2026-07-09",[1389],"Lysanne Pinto","green-devops-carbon-measurement-cicd-pipeline",{"title":1392,"description":1393,"heroImage":1394,"category":656,"date":1395,"authors":1396,"slug":1398,"externalUrl":660},"How to build CI/CD observability at scale","This practical guide to GitLab pipeline analytics helps self-managed users gain operational insights using Prometheus and Grafana.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1774465167/n5hlvrsrheadeccyr1oz.png","2026-04-28",[1397],"Paul Meresanu","how-to-build-ci-cd-observability-at-scale",{"promotions":1400},[1401,1415,1426,1438],{"id":1402,"categories":1403,"header":1405,"text":1406,"button":1407,"image":1412},"ai-modernization",[1404],"ai","Is AI achieving its promise at scale?","Quiz will take 5 minutes or less",{"text":1408,"config":1409},"Get your AI maturity score",{"href":1410,"dataGaName":1411,"dataGaLocation":888},"/assessments/ai-modernization-assessment/","modernization assessment",{"config":1413},{"src":1414},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138786/qix0m7kwnd8x2fh1zq49.png",{"id":1416,"categories":1417,"header":1418,"text":1406,"button":1419,"image":1423},"devops-modernization",[675,1223],"Are you just managing tools or shipping innovation?",{"text":1420,"config":1421},"Get your DevOps maturity score",{"href":1422,"dataGaName":1411,"dataGaLocation":888},"/assessments/devops-modernization-assessment/",{"config":1424},{"src":1425},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138785/eg818fmakweyuznttgid.png",{"id":1427,"categories":1428,"header":1430,"text":1406,"button":1431,"image":1435},"security-modernization",[1429],"security","Are you trading speed for security?",{"text":1432,"config":1433},"Get your security maturity score",{"href":1434,"dataGaName":1411,"dataGaLocation":888},"/assessments/security-modernization-assessment/",{"config":1436},{"src":1437},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138786/p4pbqd9nnjejg5ds6mdk.png",{"id":1439,"paths":1440,"header":1443,"text":1444,"button":1445,"image":1450},"github-azure-migration",[1441,1442],"migration-from-azure-devops-to-gitlab","integrating-azure-devops-scm-and-gitlab","Is your team ready for GitHub's Azure move?","GitHub is already rebuilding around Azure. Find out what it means for you.",{"text":1446,"config":1447},"See how GitLab compares to GitHub",{"href":1448,"dataGaName":1449,"dataGaLocation":888},"/compare/gitlab-vs-github/github-azure-migration/","github azure migration",{"config":1451},{"src":1425},{"header":1453,"blurb":1454,"button":1455,"secondaryButton":1460},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":1456,"config":1457},"Get your free trial",{"href":1458,"dataGaName":688,"dataGaLocation":1459},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":1160,"config":1461},{"href":1012,"dataGaName":693,"dataGaLocation":1459},1786803766564]