[{"data":1,"prerenderedAt":1300},["ShallowReactive",2],{"/blog/use-inputs-in-includable-files":3,"navigation-en-us":514,"banner-en-us":941,"footer-en-us":951,"blog-post-authors-en-us-Itzik Gan Baruch":1195,"blog-related-posts-en-us-use-inputs-in-includable-files":1210,"blog-promotions-en-us":1236,"next-steps-en-us":1290},{"id":4,"title":5,"authors":6,"body":8,"category":492,"date":493,"description":494,"extension":495,"externalUrl":496,"faq":496,"featured":497,"heroImage":498,"meta":499,"navigation":500,"path":501,"seo":502,"slug":506,"stem":507,"tags":508,"template":512,"updatedDate":496,"__hash__":513},"blogPosts/en-us/blog/use-inputs-in-includable-files.md","Define input parameters to includable CI/CD configuration files",[7],"Itzik Gan Baruch",{"type":9,"value":10,"toc":488},"minimark",[11,28,31,45,48,53,61,64,160,163,167,178,185,227,249,252,353,359,424,433,458,466,469,484],[12,13,14,15,21,22,27],"p",{},"In GitLab 15.11, we introduced an exciting new feature that allows users to ",[16,17,20],"a",{"href":18,"rel":19},"https://docs.gitlab.com/releases/#define-inputs-for-included-cicd-configuration",[],"define input parameters for includable configuration files",". With the ability to use input parameters in ",[16,23,26],{"href":24,"rel":25},"https://docs.gitlab.com/development/cicd/templates/",[],"CI templates",", you can replace any keyword in the template with a parameter, including stage, script, or job name. For example, you can add a prefix to all of the jobs to better isolate them from the pipeline into which you are including the configuration.",[12,29,30],{},"These input parameters can be declared as mandatory or optional for each configuration file, reducing the need for global variables and making your CI/CD templates more robust and isolated. The input parameters are scoped to the included configuration only, which means they have no impact on the rest of the pipeline. This allows you to declare and enforce constraints, for example by enforcing mandatory inputs for templates.",[12,32,33,34,39,40,44],{},"This development is the first milestone of the long-term roadmap of the ",[16,35,38],{"href":36,"rel":37},"https://gitlab.com/groups/gitlab-org/-/epics/7462",[],"CI/CD Components Catalog",", a new feature that will allow users to search and reuse single-purpose CI/CD configuration units with specific parameters for their use case. If you want to learn more about this exciting new development, you can read our ",[16,41,43],{"href":42},"/blog/how-to-build-reusable-ci-templates/","blog post about our CI templates feature",".",[12,46,47],{},"In this technical blog post, we will provide step-by-step instructions on how to define CI/CD templates with input parameters and how to use them when including templates.",[49,50,52],"h2",{"id":51},"step-1-create-a-template-yaml-document","Step 1: Create a template YAML document",[12,54,55,56,60],{},"The first step is to create a template YAML document that describes what input arguments can be used with the template. The second part of the template is the definition of the jobs that may include references to values using the interpolation format ",[57,58,59],"code",{},"$[[ inputs.input-name ]]",". You should use three dash lines between the two parts.",[12,62,63],{},"Here is an example of a deploy-template.yml:",[65,66,71],"pre",{"className":67,"code":68,"language":69,"meta":70,"style":70},"language-yaml shiki shiki-themes github-light","spec:\n  inputs:\n    website:\n    environment:\n      default: test\n---\ndeploy:\n  stage: deploy\n  script: echo \"deploy $[[ inputs.website ]] to $[[ inputs.environment ]]\"\n\n","yaml","",[57,72,73,86,94,102,110,123,130,138,149],{"__ignoreMap":70},[74,75,78,82],"span",{"class":76,"line":77},"line",1,[74,79,81],{"class":80},"shJU0","spec",[74,83,85],{"class":84},"sgsFI",":\n",[74,87,89,92],{"class":76,"line":88},2,[74,90,91],{"class":80},"  inputs",[74,93,85],{"class":84},[74,95,97,100],{"class":76,"line":96},3,[74,98,99],{"class":80},"    website",[74,101,85],{"class":84},[74,103,105,108],{"class":76,"line":104},4,[74,106,107],{"class":80},"    environment",[74,109,85],{"class":84},[74,111,113,116,119],{"class":76,"line":112},5,[74,114,115],{"class":80},"      default",[74,117,118],{"class":84},": ",[74,120,122],{"class":121},"sYBdl","test\n",[74,124,126],{"class":76,"line":125},6,[74,127,129],{"class":128},"s7eDp","---\n",[74,131,133,136],{"class":76,"line":132},7,[74,134,135],{"class":80},"deploy",[74,137,85],{"class":84},[74,139,141,144,146],{"class":76,"line":140},8,[74,142,143],{"class":80},"  stage",[74,145,118],{"class":84},[74,147,148],{"class":121},"deploy\n",[74,150,152,155,157],{"class":76,"line":151},9,[74,153,154],{"class":80},"  script",[74,156,118],{"class":84},[74,158,159],{"class":121},"echo \"deploy $[[ inputs.website ]] to $[[ inputs.environment ]]\"\n",[12,161,162],{},"In this template, we have defined two input parameters: website and environment. The environment parameter has a default value. In the content section, we define a job that interpolates the input arguments.",[49,164,166],{"id":165},"step-2-include-the-template-in-the-ci-configuration","Step 2: Include the template in the CI configuration",[12,168,169,170,173,174,177],{},"In your main CI configuration file ",[57,171,172],{},".gitlab-ci.yml",", include the template and add input parameters using the ",[57,175,176],{},"inputs"," keyword.",[12,179,180,181,184],{},"Here is an example of including the ",[57,182,183],{},"deploy-template.yml"," with input parameters:",[65,186,188],{"className":67,"code":187,"language":69,"meta":70,"style":70},"include:\n  - local: deploy-template.yml\n    inputs:\n      website: my-website.example.com\n\n",[57,189,190,197,210,217],{"__ignoreMap":70},[74,191,192,195],{"class":76,"line":77},[74,193,194],{"class":80},"include",[74,196,85],{"class":84},[74,198,199,202,205,207],{"class":76,"line":88},[74,200,201],{"class":84},"  - ",[74,203,204],{"class":80},"local",[74,206,118],{"class":84},[74,208,209],{"class":121},"deploy-template.yml\n",[74,211,212,215],{"class":76,"line":96},[74,213,214],{"class":80},"    inputs",[74,216,85],{"class":84},[74,218,219,222,224],{"class":76,"line":104},[74,220,221],{"class":80},"      website",[74,223,118],{"class":84},[74,225,226],{"class":121},"my-website.example.com\n",[12,228,229,230,232,233,238,239,242,243,242,246,44],{},"In this example, we included a local template in our project. Note: You can use ",[57,231,176],{}," with the other ",[16,234,237],{"href":235,"rel":236},"https://docs.gitlab.com/ci/yaml/#include",[],"include types"," such as ",[57,240,241],{},"include:project",", ",[57,244,245],{},"include:template",[57,247,248],{},"include:remote",[12,250,251],{},"In the below example, we use inputs to add a prefix to jobs name, and make the stage dynamic as well.",[65,253,255],{"className":67,"code":254,"language":69,"meta":70,"style":70},"spec:\n  inputs:\n    website:\n    environment:\n      default: staging\n    stage:\n      default: test\n    job_prefix:\n      default: \"\"\n---\n\"$[[ inputs.job_prefix ]]deploy\":\n  stage: $[[ inputs.stage ]]\n  script: echo \"deploy $[[ inputs.website ]] to $[[ inputs.environment ]]\"\n\n",[57,256,257,263,269,275,281,290,297,305,312,321,326,334,344],{"__ignoreMap":70},[74,258,259,261],{"class":76,"line":77},[74,260,81],{"class":80},[74,262,85],{"class":84},[74,264,265,267],{"class":76,"line":88},[74,266,91],{"class":80},[74,268,85],{"class":84},[74,270,271,273],{"class":76,"line":96},[74,272,99],{"class":80},[74,274,85],{"class":84},[74,276,277,279],{"class":76,"line":104},[74,278,107],{"class":80},[74,280,85],{"class":84},[74,282,283,285,287],{"class":76,"line":112},[74,284,115],{"class":80},[74,286,118],{"class":84},[74,288,289],{"class":121},"staging\n",[74,291,292,295],{"class":76,"line":125},[74,293,294],{"class":80},"    stage",[74,296,85],{"class":84},[74,298,299,301,303],{"class":76,"line":132},[74,300,115],{"class":80},[74,302,118],{"class":84},[74,304,122],{"class":121},[74,306,307,310],{"class":76,"line":140},[74,308,309],{"class":80},"    job_prefix",[74,311,85],{"class":84},[74,313,314,316,318],{"class":76,"line":151},[74,315,115],{"class":80},[74,317,118],{"class":84},[74,319,320],{"class":121},"\"\"\n",[74,322,324],{"class":76,"line":323},10,[74,325,129],{"class":128},[74,327,329,332],{"class":76,"line":328},11,[74,330,331],{"class":121},"\"$[[ inputs.job_prefix ]]deploy\"",[74,333,85],{"class":84},[74,335,337,339,341],{"class":76,"line":336},12,[74,338,143],{"class":80},[74,340,118],{"class":84},[74,342,343],{"class":121},"$[[ inputs.stage ]]\n",[74,345,347,349,351],{"class":76,"line":346},13,[74,348,154],{"class":80},[74,350,118],{"class":84},[74,352,159],{"class":121},[12,354,355,356,358],{},"Then we can include it from the ",[57,357,172],{}," with the input parameters:",[65,360,362],{"className":67,"code":361,"language":69,"meta":70,"style":70},"include:\n  - local: deploy-template.yml\n    inputs:\n      stage: deploy\n      website: http://example.com\n      environment: production\n      job_prefix: \"my-app-\"\n\n",[57,363,364,370,380,386,395,404,414],{"__ignoreMap":70},[74,365,366,368],{"class":76,"line":77},[74,367,194],{"class":80},[74,369,85],{"class":84},[74,371,372,374,376,378],{"class":76,"line":88},[74,373,201],{"class":84},[74,375,204],{"class":80},[74,377,118],{"class":84},[74,379,209],{"class":121},[74,381,382,384],{"class":76,"line":96},[74,383,214],{"class":80},[74,385,85],{"class":84},[74,387,388,391,393],{"class":76,"line":104},[74,389,390],{"class":80},"      stage",[74,392,118],{"class":84},[74,394,148],{"class":121},[74,396,397,399,401],{"class":76,"line":112},[74,398,221],{"class":80},[74,400,118],{"class":84},[74,402,403],{"class":121},"http://example.com\n",[74,405,406,409,411],{"class":76,"line":125},[74,407,408],{"class":80},"      environment",[74,410,118],{"class":84},[74,412,413],{"class":121},"production\n",[74,415,416,419,421],{"class":76,"line":132},[74,417,418],{"class":80},"      job_prefix",[74,420,118],{"class":84},[74,422,423],{"class":121},"\"my-app-\"\n",[12,425,426,427,432],{},"You can ",[16,428,431],{"href":429,"rel":430},"https://gitlab.com/tech-marketing/ci-interpolation-example",[],"fork"," this project, which uses the above examples:",[434,435,436,444,451],"ul",{},[437,438,439],"li",{},[16,440,443],{"href":441,"rel":442},"https://gitlab.com/tech-marketing/ci-interpolation-example/-/blob/main/dynamic-job.yml",[],"Dynamic job",[437,445,446],{},[16,447,450],{"href":448,"rel":449},"https://gitlab.com/tech-marketing/ci-interpolation-example/-/blob/main/deploy-template.yml",[],"Dynamic script",[437,452,453],{},[16,454,457],{"href":455,"rel":456},"https://gitlab.com/tech-marketing/ci-interpolation-example/-/blob/main/.gitlab-ci.yml",[],"Main CI configuration",[12,459,460,461,44],{},"For more information, please use our ",[16,462,465],{"href":463,"rel":464},"https://docs.gitlab.com/ci/yaml/includes/#define-input-parameters-with-specinputs",[],"online documentation",[12,467,468],{},"That's it! You have successfully created CI templates that accept inputs and used them in a pipeline configuration. By using templates with inputs, you can simplify pipeline configuration and make templates more modular and reusable.",[12,470,471,472,477,478,483],{},"Thank you to ",[16,473,476],{"href":474,"rel":475},"https://gitlab.com/fabiopitino",[],"Fabio Pitino"," and ",[16,479,482],{"href":480,"rel":481},"https://gitlab.com/grzesiek",[],"Grzegorz Bizon"," for their content reviews.",[485,486,487],"style",{},"html pre.shiki code .shJU0, html code.shiki .shJU0{--shiki-default:#22863A}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}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);}",{"title":70,"searchDepth":88,"depth":88,"links":489},[490,491],{"id":51,"depth":88,"text":52},{"id":165,"depth":88,"text":166},"engineering","2023-05-08","This is the first milestone of the long-term roadmap of the CI/CD Components Catalog roadmap.","md",null,false,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749679170/Blog/Hero%20Images/migration-data.jpg",{},true,"/en-us/blog/use-inputs-in-includable-files",{"title":5,"description":494,"ogTitle":5,"ogDescription":494,"noIndex":497,"ogImage":498,"ogUrl":503,"ogSiteName":504,"ogType":505,"canonicalUrls":503},"https://about.gitlab.com/blog/use-inputs-in-includable-files","https://about.gitlab.com","article","use-inputs-in-includable-files","en-us/blog/use-inputs-in-includable-files",[509,510,511],"tutorial","DevOps","CI/CD","BlogPost","X2bLykM8BG5zA4rOfjGBsCwiQyCaBe9D9ey-ScAti2A",{"logo":515,"freeTrial":520,"sales":525,"login":530,"items":535,"search":861,"minimal":892,"duo":911,"switchNav":920,"pricingDeployment":931},{"config":516},{"href":517,"dataGaName":518,"dataGaLocation":519},"/","gitlab logo","header",{"text":521,"config":522},"Get free trial",{"href":523,"dataGaName":524,"dataGaLocation":519},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":526,"config":527},"Request a demo",{"href":528,"dataGaName":529,"dataGaLocation":519},"/sales/?contact-topic=request-demo","sales",{"text":531,"config":532},"Sign in",{"href":533,"dataGaName":534,"dataGaLocation":519},"https://gitlab.com/users/sign_in/","sign in",[536,565,664,669,783,839],{"text":537,"config":538,"menu":540},"Platform",{"dataNavLevelOne":539},"platform",{"type":541,"columns":542},"cards",[543,549,557],{"title":537,"description":544,"link":545},"The intelligent orchestration platform for DevSecOps",{"text":546,"config":547},"Explore our Platform",{"href":548,"dataGaName":539,"dataGaLocation":519},"/platform/",{"title":550,"description":551,"link":552},"GitLab Duo Agent Platform","Agentic AI for the entire software lifecycle",{"text":553,"config":554},"Meet GitLab Duo",{"href":555,"dataGaName":556,"dataGaLocation":519},"/gitlab-duo-agent-platform/","gitlab duo agent platform",{"title":558,"description":559,"link":560},"Why GitLab","See the top reasons enterprises choose GitLab",{"text":561,"config":562},"Learn more",{"href":563,"dataGaName":564,"dataGaLocation":519},"/why-gitlab/","why gitlab",{"text":566,"left":500,"config":567,"menu":569},"Product",{"dataNavLevelOne":568},"solutions",{"type":570,"link":571,"columns":575,"feature":643},"lists",{"text":572,"config":573},"View all Solutions",{"href":574,"dataGaName":568,"dataGaLocation":519},"/solutions/",[576,599,622],{"title":577,"description":578,"link":579,"items":584},"Automation","CI/CD and automation to accelerate deployment",{"config":580},{"icon":581,"href":582,"dataGaName":583,"dataGaLocation":519},"AutomatedCodeAlt","/solutions/delivery-automation/","automated software delivery",[585,588,591,595],{"text":511,"config":586},{"href":587,"dataGaLocation":519,"dataGaName":511},"/solutions/continuous-integration/",{"text":550,"config":589},{"href":555,"dataGaLocation":519,"dataGaName":590},"gitlab duo agent platform - product menu",{"text":592,"config":593},"Source Code Management",{"href":594,"dataGaLocation":519,"dataGaName":592},"/solutions/source-code-management/",{"text":596,"config":597},"Automated Software Delivery",{"href":582,"dataGaLocation":519,"dataGaName":598},"Automated software delivery",{"title":600,"description":601,"link":602,"items":607},"Security","Deliver code faster without compromising security",{"config":603},{"href":604,"dataGaName":605,"dataGaLocation":519,"icon":606},"/solutions/application-security-testing/","security and compliance","ShieldCheckLight",[608,612,617],{"text":609,"config":610},"Application Security Testing",{"href":604,"dataGaName":611,"dataGaLocation":519},"Application security testing",{"text":613,"config":614},"Software Supply Chain Security",{"href":615,"dataGaLocation":519,"dataGaName":616},"/solutions/supply-chain/","Software supply chain security",{"text":618,"config":619},"Software Compliance",{"href":620,"dataGaName":621,"dataGaLocation":519},"/solutions/software-compliance/","software compliance",{"title":623,"link":624,"items":629},"Measurement",{"config":625},{"icon":626,"href":627,"dataGaName":628,"dataGaLocation":519},"DigitalTransformation","/solutions/visibility-measurement/","visibility and measurement",[630,634,638],{"text":631,"config":632},"Visibility & Measurement",{"href":627,"dataGaLocation":519,"dataGaName":633},"Visibility and Measurement",{"text":635,"config":636},"Value Stream Management",{"href":637,"dataGaLocation":519,"dataGaName":635},"/solutions/value-stream-management/",{"text":639,"config":640},"Analytics & Insights",{"href":641,"dataGaLocation":519,"dataGaName":642},"/solutions/analytics-and-insights/","Analytics and insights",{"title":644,"type":570,"items":645},"GitLab for",[646,652,658],{"text":647,"config":648},"Enterprise",{"icon":649,"href":650,"dataGaLocation":519,"dataGaName":651},"Building","/enterprise/","enterprise",{"text":653,"config":654},"Small Business",{"icon":655,"href":656,"dataGaLocation":519,"dataGaName":657},"Work","/small-business/","small business",{"text":659,"config":660},"Public Sector",{"icon":661,"href":662,"dataGaLocation":519,"dataGaName":663},"Organization","/solutions/public-sector/","public sector",{"text":665,"config":666},"Pricing",{"href":667,"dataGaName":668,"dataGaLocation":519,"dataNavLevelOne":668},"/pricing/","pricing",{"text":670,"config":671,"menu":673},"Resources",{"dataNavLevelOne":672},"resources",{"type":570,"link":674,"columns":678,"feature":772},{"text":675,"config":676},"View all resources",{"href":677,"dataGaName":672,"dataGaLocation":519},"/resources/",[679,712,739],{"title":680,"items":681},"Getting started",[682,687,692,697,702,707],{"text":683,"config":684},"Install",{"href":685,"dataGaName":686,"dataGaLocation":519},"/install/","install",{"text":688,"config":689},"Quick start guides",{"href":690,"dataGaName":691,"dataGaLocation":519},"/get-started/","quick setup checklists",{"text":693,"config":694},"Learn",{"href":695,"dataGaLocation":519,"dataGaName":696},"https://university.gitlab.com/","learn",{"text":698,"config":699},"Product documentation",{"href":700,"dataGaName":701,"dataGaLocation":519},"https://docs.gitlab.com/","product documentation",{"text":703,"config":704},"Best practice videos",{"href":705,"dataGaName":706,"dataGaLocation":519},"/getting-started-videos/","best practice videos",{"text":708,"config":709},"Integrations",{"href":710,"dataGaName":711,"dataGaLocation":519},"/integrations/","integrations",{"title":713,"items":714},"Discover",[715,720,725,730,734],{"text":716,"config":717},"Customer success stories",{"href":718,"dataGaName":719,"dataGaLocation":519},"/customers/","customer success stories",{"text":721,"config":722},"Blog",{"href":723,"dataGaName":724,"dataGaLocation":519},"/blog/","blog",{"text":726,"config":727},"Demo Hub",{"href":728,"dataGaName":729,"dataGaLocation":519},"/demo-hub/","demo hub",{"text":731,"config":732},"The Source",{"href":733,"dataGaName":724,"dataGaLocation":519},"/the-source/",{"text":735,"config":736},"Remote",{"href":737,"dataGaName":738,"dataGaLocation":519},"https://handbook.gitlab.com/handbook/company/culture/all-remote/","remote",{"title":740,"items":741},"Connect",[742,747,752,757,762,767],{"text":743,"config":744},"GitLab Services",{"href":745,"dataGaName":746,"dataGaLocation":519},"/services/","services",{"text":748,"config":749},"Contribute",{"href":750,"dataGaName":751,"dataGaLocation":519},"https://contributors.gitlab.com","contribute",{"text":753,"config":754},"Community",{"href":755,"dataGaName":756,"dataGaLocation":519},"/community/","community",{"text":758,"config":759},"Forum",{"href":760,"dataGaName":761,"dataGaLocation":519},"https://forum.gitlab.com/","forum",{"text":763,"config":764},"Events",{"href":765,"dataGaName":766,"dataGaLocation":519},"/events/","events",{"text":768,"config":769},"Partners",{"href":770,"dataGaName":771,"dataGaLocation":519},"/partners/","partners",{"config":773,"title":776,"text":777,"link":778},{"background":774,"textColor":775},"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":779,"config":780},"Read the latest",{"href":781,"dataGaName":782,"dataGaLocation":519},"/whats-new/","whats new",{"text":784,"config":785,"menu":787},"Company",{"dataNavLevelOne":786},"company",{"type":570,"columns":788},[789],{"items":790},[791,796,802,804,809,814,819,824,829,834],{"text":792,"config":793},"About",{"href":794,"dataGaName":795,"dataGaLocation":519},"/company/","about",{"text":797,"config":798,"footerGa":801},"Jobs",{"href":799,"dataGaName":800,"dataGaLocation":519},"/jobs/","jobs",{"dataGaName":800},{"text":763,"config":803},{"href":765,"dataGaName":766,"dataGaLocation":519},{"text":805,"config":806},"Leadership",{"href":807,"dataGaName":808,"dataGaLocation":519},"/company/team/e-group/","leadership",{"text":810,"config":811},"Handbook",{"href":812,"dataGaName":813,"dataGaLocation":519},"https://handbook.gitlab.com/","handbook",{"text":815,"config":816},"Investor relations",{"href":817,"dataGaName":818,"dataGaLocation":519},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":820,"config":821},"Trust Center",{"href":822,"dataGaName":823,"dataGaLocation":519},"/security/","trust center",{"text":825,"config":826},"AI Transparency Center",{"href":827,"dataGaName":828,"dataGaLocation":519},"/ai-transparency-center/","ai transparency center",{"text":830,"config":831},"Newsletter",{"href":832,"dataGaName":833,"dataGaLocation":519},"/company/contact/#contact-forms","newsletter",{"text":835,"config":836},"Press",{"href":837,"dataGaName":838,"dataGaLocation":519},"/press/","press",{"text":840,"config":841,"menu":842},"Contact us",{"dataNavLevelOne":786},{"type":570,"columns":843},[844],{"items":845},[846,851,856],{"text":847,"config":848},"Talk to sales",{"href":849,"dataGaName":850,"dataGaLocation":519},"/sales/","talk to sales",{"text":852,"config":853},"Support portal",{"href":854,"dataGaName":855,"dataGaLocation":519},"https://support.gitlab.com/hc/en-us","support portal",{"text":857,"config":858},"Customer portal",{"href":859,"dataGaName":860,"dataGaLocation":519},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":862,"login":863,"suggestions":870},"Close",{"text":864,"link":865},"To search repositories and projects, login to",{"text":866,"config":867},"gitlab.com",{"href":533,"dataGaName":868,"dataGaLocation":869},"search login","search",{"text":871,"default":872},"Suggestions",[873,875,879,881,885,889],{"text":550,"config":874},{"href":555,"dataGaName":550,"dataGaLocation":869},{"text":876,"config":877},"Code Suggestions (AI)",{"href":878,"dataGaName":876,"dataGaLocation":869},"/solutions/code-suggestions/",{"text":511,"config":880},{"href":587,"dataGaName":511,"dataGaLocation":869},{"text":882,"config":883},"GitLab on AWS",{"href":884,"dataGaName":882,"dataGaLocation":869},"/partners/technology-partners/aws/",{"text":886,"config":887},"GitLab on Google Cloud",{"href":888,"dataGaName":886,"dataGaLocation":869},"/partners/technology-partners/google-cloud-platform/",{"text":890,"config":891},"Why GitLab?",{"href":563,"dataGaName":890,"dataGaLocation":869},{"freeTrial":893,"mobileIcon":898,"desktopIcon":903,"secondaryButton":906},{"text":894,"config":895},"Start free trial",{"href":896,"dataGaName":524,"dataGaLocation":897},"https://gitlab.com/-/trials/new/","nav",{"altText":899,"config":900},"Gitlab Icon",{"src":901,"dataGaName":902,"dataGaLocation":897},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":899,"config":904},{"src":905,"dataGaName":902,"dataGaLocation":897},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":907,"config":908},"Get Started",{"href":909,"dataGaName":910,"dataGaLocation":897},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":912,"mobileIcon":916,"desktopIcon":918},{"text":913,"config":914},"Learn more about GitLab Duo",{"href":555,"dataGaName":915,"dataGaLocation":897},"gitlab duo",{"altText":899,"config":917},{"src":901,"dataGaName":902,"dataGaLocation":897},{"altText":899,"config":919},{"src":905,"dataGaName":902,"dataGaLocation":897},{"button":921,"mobileIcon":926,"desktopIcon":928},{"text":922,"config":923},"/switch",{"href":924,"dataGaName":925,"dataGaLocation":897},"#contact","switch",{"altText":899,"config":927},{"src":901,"dataGaName":902,"dataGaLocation":897},{"altText":899,"config":929},{"src":930,"dataGaName":902,"dataGaLocation":897},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":932,"mobileIcon":937,"desktopIcon":939},{"text":933,"config":934},"Back to pricing",{"href":667,"dataGaName":935,"dataGaLocation":897,"icon":936},"back to pricing","GoBack",{"altText":899,"config":938},{"src":901,"dataGaName":902,"dataGaLocation":897},{"altText":899,"config":940},{"src":905,"dataGaName":902,"dataGaLocation":897},{"title":942,"titleMobile":943,"button":944,"config":949},"Duo Agent Platform delivers 400% ROI, per new Forrester Consulting study.","400% ROI: Forrester TEI for GitLab Duo",{"text":561,"config":945},{"href":946,"dataGaName":947,"dataGaLocation":948},"https://about.gitlab.com/blog/gitlab-duo-agent-platform-delivers-400-percent-roi/","forrester-tei-dap-banner","global-banner",{"layout":950,"disabled":497},"release",{"data":952},{"text":953,"source":954,"edit":960,"contribute":965,"config":970,"items":975,"minimal":1184},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"text":955,"config":956},"View page source",{"href":957,"dataGaName":958,"dataGaLocation":959},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/","page source","footer",{"text":961,"config":962},"Edit this page",{"href":963,"dataGaName":964,"dataGaLocation":959},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/content/","web ide",{"text":966,"config":967},"Please contribute",{"href":968,"dataGaName":969,"dataGaLocation":959},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/CONTRIBUTING.md/","please contribute",{"twitter":971,"facebook":972,"youtube":973,"linkedin":974},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[976,1023,1076,1120,1152],{"title":665,"links":977,"subMenu":992},[978,982,987],{"text":979,"config":980},"View plans",{"href":667,"dataGaName":981,"dataGaLocation":959},"view plans",{"text":983,"config":984},"Why Premium?",{"href":985,"dataGaName":986,"dataGaLocation":959},"/pricing/premium/","why premium",{"text":988,"config":989},"Why Ultimate?",{"href":990,"dataGaName":991,"dataGaLocation":959},"/pricing/ultimate/","why ultimate",[993],{"title":994,"links":995},"Contact Us",[996,999,1001,1003,1008,1013,1018],{"text":997,"config":998},"Contact sales",{"href":849,"dataGaName":529,"dataGaLocation":959},{"text":852,"config":1000},{"href":854,"dataGaName":855,"dataGaLocation":959},{"text":857,"config":1002},{"href":859,"dataGaName":860,"dataGaLocation":959},{"text":1004,"config":1005},"Status",{"href":1006,"dataGaName":1007,"dataGaLocation":959},"https://status.gitlab.com/","status",{"text":1009,"config":1010},"Terms of use",{"href":1011,"dataGaName":1012,"dataGaLocation":959},"/terms/","terms of use",{"text":1014,"config":1015},"Privacy statement",{"href":1016,"dataGaName":1017,"dataGaLocation":959},"/privacy/","privacy statement",{"text":1019,"config":1020},"Cookie preferences",{"dataGaName":1021,"dataGaLocation":959,"id":1022,"isOneTrustButton":500},"cookie preferences","ot-sdk-btn",{"title":566,"links":1024,"subMenu":1033},[1025,1029],{"text":1026,"config":1027},"DevSecOps platform",{"href":548,"dataGaName":1028,"dataGaLocation":959},"devsecops platform",{"text":1030,"config":1031},"AI-Assisted Development",{"href":555,"dataGaName":1032,"dataGaLocation":959},"ai-assisted development",[1034],{"title":1035,"links":1036},"Topics",[1037,1042,1047,1051,1056,1061,1066,1071],{"text":1038,"config":1039},"CICD",{"href":1040,"dataGaName":1041,"dataGaLocation":959},"/topics/ci-cd/","cicd",{"text":1043,"config":1044},"GitOps",{"href":1045,"dataGaName":1046,"dataGaLocation":959},"/topics/gitops/","gitops",{"text":510,"config":1048},{"href":1049,"dataGaName":1050,"dataGaLocation":959},"/topics/devops/","devops",{"text":1052,"config":1053},"Version Control",{"href":1054,"dataGaName":1055,"dataGaLocation":959},"/topics/version-control/","version control",{"text":1057,"config":1058},"DevSecOps",{"href":1059,"dataGaName":1060,"dataGaLocation":959},"/topics/devsecops/","devsecops",{"text":1062,"config":1063},"Cloud Native",{"href":1064,"dataGaName":1065,"dataGaLocation":959},"/topics/cloud-native/","cloud native",{"text":1067,"config":1068},"AI for Coding",{"href":1069,"dataGaName":1070,"dataGaLocation":959},"/topics/devops/ai-for-coding/","ai for coding",{"text":1072,"config":1073},"Agentic AI",{"href":1074,"dataGaName":1075,"dataGaLocation":959},"/topics/agentic-ai/","agentic ai",{"title":1077,"links":1078},"Solutions",[1079,1081,1083,1088,1092,1095,1099,1102,1104,1107,1110,1115],{"text":609,"config":1080},{"href":604,"dataGaName":609,"dataGaLocation":959},{"text":598,"config":1082},{"href":582,"dataGaName":583,"dataGaLocation":959},{"text":1084,"config":1085},"Agile development",{"href":1086,"dataGaName":1087,"dataGaLocation":959},"/solutions/agile-delivery/","agile delivery",{"text":1089,"config":1090},"SCM",{"href":594,"dataGaName":1091,"dataGaLocation":959},"source code management",{"text":1038,"config":1093},{"href":587,"dataGaName":1094,"dataGaLocation":959},"continuous integration & delivery",{"text":1096,"config":1097},"Value stream management",{"href":637,"dataGaName":1098,"dataGaLocation":959},"value stream management",{"text":1043,"config":1100},{"href":1101,"dataGaName":1046,"dataGaLocation":959},"/solutions/gitops/",{"text":647,"config":1103},{"href":650,"dataGaName":651,"dataGaLocation":959},{"text":1105,"config":1106},"Small business",{"href":656,"dataGaName":657,"dataGaLocation":959},{"text":1108,"config":1109},"Public sector",{"href":662,"dataGaName":663,"dataGaLocation":959},{"text":1111,"config":1112},"Education",{"href":1113,"dataGaName":1114,"dataGaLocation":959},"/solutions/education/","education",{"text":1116,"config":1117},"Financial services",{"href":1118,"dataGaName":1119,"dataGaLocation":959},"/solutions/finance/","financial services",{"title":670,"links":1121},[1122,1124,1126,1128,1131,1133,1136,1138,1140,1142,1144,1146,1148,1150],{"text":683,"config":1123},{"href":685,"dataGaName":686,"dataGaLocation":959},{"text":688,"config":1125},{"href":690,"dataGaName":691,"dataGaLocation":959},{"text":693,"config":1127},{"href":695,"dataGaName":696,"dataGaLocation":959},{"text":698,"config":1129},{"href":700,"dataGaName":1130,"dataGaLocation":959},"docs",{"text":721,"config":1132},{"href":723,"dataGaName":724,"dataGaLocation":959},{"text":1134,"config":1135},"What's new",{"href":781,"dataGaName":782,"dataGaLocation":959},{"text":716,"config":1137},{"href":718,"dataGaName":719,"dataGaLocation":959},{"text":735,"config":1139},{"href":737,"dataGaName":738,"dataGaLocation":959},{"text":743,"config":1141},{"href":745,"dataGaName":746,"dataGaLocation":959},{"text":748,"config":1143},{"href":750,"dataGaName":751,"dataGaLocation":959},{"text":753,"config":1145},{"href":755,"dataGaName":756,"dataGaLocation":959},{"text":758,"config":1147},{"href":760,"dataGaName":761,"dataGaLocation":959},{"text":763,"config":1149},{"href":765,"dataGaName":766,"dataGaLocation":959},{"text":768,"config":1151},{"href":770,"dataGaName":771,"dataGaLocation":959},{"title":784,"links":1153},[1154,1156,1158,1160,1162,1164,1168,1173,1175,1177,1179],{"text":792,"config":1155},{"href":794,"dataGaName":786,"dataGaLocation":959},{"text":797,"config":1157},{"href":799,"dataGaName":800,"dataGaLocation":959},{"text":805,"config":1159},{"href":807,"dataGaName":808,"dataGaLocation":959},{"text":810,"config":1161},{"href":812,"dataGaName":813,"dataGaLocation":959},{"text":815,"config":1163},{"href":817,"dataGaName":818,"dataGaLocation":959},{"text":1165,"config":1166},"Sustainability",{"href":1167,"dataGaName":1165,"dataGaLocation":959},"/sustainability/",{"text":1169,"config":1170},"Diversity, inclusion and belonging (DIB)",{"href":1171,"dataGaName":1172,"dataGaLocation":959},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":820,"config":1174},{"href":822,"dataGaName":823,"dataGaLocation":959},{"text":830,"config":1176},{"href":832,"dataGaName":833,"dataGaLocation":959},{"text":835,"config":1178},{"href":837,"dataGaName":838,"dataGaLocation":959},{"text":1180,"config":1181},"Modern Slavery Transparency Statement",{"href":1182,"dataGaName":1183,"dataGaLocation":959},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":1185},[1186,1189,1192],{"text":1187,"config":1188},"Terms",{"href":1011,"dataGaName":1012,"dataGaLocation":959},{"text":1190,"config":1191},"Cookies",{"dataGaName":1021,"dataGaLocation":959,"id":1022,"isOneTrustButton":500},{"text":1193,"config":1194},"Privacy",{"href":1016,"dataGaName":1017,"dataGaLocation":959},[1196],{"id":1197,"title":7,"body":496,"config":1198,"content":1200,"description":496,"extension":1204,"meta":1205,"navigation":500,"path":1206,"seo":1207,"stem":1208,"__hash__":1209},"blogAuthors/en-us/blog/authors/itzik-gan-baruch.yml",{"template":1199},"BlogAuthor",{"name":7,"config":1201},{"headshot":1202,"ctfId":1203},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749658921/Blog/Author%20Headshots/iganbaruch-headshot.jpg","iganbaruch","yml",{},"/en-us/blog/authors/itzik-gan-baruch",{},"en-us/blog/authors/itzik-gan-baruch","bz9VMiTQ1ixvnoxUFk0jiUcnLG3oQsymgXNCqyRqfsk",[1211,1220,1228],{"title":1212,"description":1213,"heroImage":1214,"category":492,"date":1215,"authors":1216,"slug":1219,"externalUrl":496},"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",[1217,1218],"Mathias Ewald","Martin Paloncy, Edgeless Systems","confidential-ai-for-gitlab-self-hosted",{"title":1221,"description":1222,"heroImage":1223,"category":492,"date":1224,"authors":1225,"slug":1227,"externalUrl":496},"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",[1226],"Lysanne Pinto","green-devops-carbon-measurement-cicd-pipeline",{"title":1229,"description":1230,"heroImage":1231,"category":492,"date":1232,"authors":1233,"slug":1235,"externalUrl":496},"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",[1234],"Paul Meresanu","how-to-build-ci-cd-observability-at-scale",{"promotions":1237},[1238,1252,1264,1276],{"id":1239,"categories":1240,"header":1242,"text":1243,"button":1244,"image":1249},"ai-modernization",[1241],"ai","Is AI achieving its promise at scale?","Quiz will take 5 minutes or less",{"text":1245,"config":1246},"Get your AI maturity score",{"href":1247,"dataGaName":1248,"dataGaLocation":724},"/assessments/ai-modernization-assessment/","modernization assessment",{"config":1250},{"src":1251},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138786/qix0m7kwnd8x2fh1zq49.png",{"id":1253,"categories":1254,"header":1256,"text":1243,"button":1257,"image":1261},"devops-modernization",[1255,1060],"product","Are you just managing tools or shipping innovation?",{"text":1258,"config":1259},"Get your DevOps maturity score",{"href":1260,"dataGaName":1248,"dataGaLocation":724},"/assessments/devops-modernization-assessment/",{"config":1262},{"src":1263},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138785/eg818fmakweyuznttgid.png",{"id":1265,"categories":1266,"header":1268,"text":1243,"button":1269,"image":1273},"security-modernization",[1267],"security","Are you trading speed for security?",{"text":1270,"config":1271},"Get your security maturity score",{"href":1272,"dataGaName":1248,"dataGaLocation":724},"/assessments/security-modernization-assessment/",{"config":1274},{"src":1275},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138786/p4pbqd9nnjejg5ds6mdk.png",{"id":1277,"paths":1278,"header":1281,"text":1282,"button":1283,"image":1288},"github-azure-migration",[1279,1280],"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":1284,"config":1285},"See how GitLab compares to GitHub",{"href":1286,"dataGaName":1287,"dataGaLocation":724},"/compare/gitlab-vs-github/github-azure-migration/","github azure migration",{"config":1289},{"src":1263},{"header":1291,"blurb":1292,"button":1293,"secondaryButton":1298},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":1294,"config":1295},"Get your free trial",{"href":1296,"dataGaName":524,"dataGaLocation":1297},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":997,"config":1299},{"href":849,"dataGaName":529,"dataGaLocation":1297},1786803738851]