[{"data":1,"prerenderedAt":1290},["ShallowReactive",2],{"/blog/how-to-automate-creation-of-runners":3,"navigation-en-us":537,"banner-en-us":975,"footer-en-us":983,"blog-post-authors-en-us-Darren Eastman":1230,"blog-related-posts-en-us-how-to-automate-creation-of-runners":1245,"blog-share-wrapper-en-us":1270,"next-steps-en-us":1280},{"id":4,"title":5,"authors":6,"body":8,"category":516,"date":517,"description":518,"extension":519,"externalUrl":520,"faq":520,"featured":521,"heroImage":522,"hidePromo":521,"meta":523,"navigation":319,"path":524,"seo":525,"slug":529,"stem":530,"tags":531,"template":535,"updatedDate":520,"__hash__":536},"blogPosts/en-us/blog/how-to-automate-creation-of-runners.md","How to automate the creation of GitLab Runners",[7],"Darren Eastman",{"type":9,"value":10,"toc":505},"minimark",[11,15,22,27,38,48,51,57,62,70,76,79,83,86,90,100,115,123,128,132,135,191,197,215,226,229,237,241,256,289,294,480,484,487,498,501],[12,13,14],"p",{},"Automating the creation of GitLab Runners is an essential tactic in optimizing the operations and management of a runner fleet. Since announcing the deprecation and planned removal of the legacy runner registration token last year, there have been various questions by customers and the user community regarding the impact of the new workflow on any automation they rely on for creating and registering runners. This is a step-by-step guide for automating runner setup using the new runner creation workflows as depicted in the sequence diagram.",[12,16,17],{},[18,19],"img",{"alt":20,"src":21},"GitLab Runner create - sequence diagram","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782397791/blog/Content%20Images/2023-06-19-how-to-automate-creating-runners/runner_create_sequence_diagram.png",[23,24,26],"h2",{"id":25},"new-terminology-and-concepts","New terminology and concepts",[12,28,29,30,34,35,37],{},"Before we dive into the automation steps, let’s first review a few new concepts with the runner creation process and how that differs from the registration token-based method. With the ",[31,32,33],"code",{},"registration token"," method, a ",[31,36,33],{}," is available for the instance, for each group, and for each project. Therefore, in a large GitLab installation, with many groups, sub-groups, and projects, you can have tens of hundreds of registration tokens that any authorized user can use to connect a runner. There are two steps to authorizing a runner (the application that you install on a target computing platform) to a GitLab instance:",[39,40,41,45],"ol",{},[42,43,44],"li",{},"Retrieve a registration token.",[42,46,47],{},"Run the register command in the runner application using the previously retrieved registration token.",[12,49,50],{},"The workflow images below depict the runner setup steps using the registration token compared with the new runner creation process.",[12,52,53],{},[18,54],{"alt":55,"src":56},"GitLab Runner registration workflows","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782397791/blog/Content%20Images/2023-06-19-how-to-automate-creating-runners/runner_registration_workflows.png",[58,59,61],"h3",{"id":60},"reusable-runner-configurations","Reusable runner configurations",[12,63,64,65,69],{},"Now, in the registration token method, if you authenticated multiple runners using the same registration token (a valid use case), each runner entity would be visible in the UI in a separate row in the list view. The new creation method introduces the concept of a reusable runner configuration. For example, if you have to deploy multiple runners at the instance level, each with the same configuration (executor type, tags, etc.), you simply create a runner and configuration ",[66,67,68],"strong",{},"once",", then register each individual runner with the same authentication token that you retrieved from the first runner creation. Each of these runners is now displayed in the UI in a nested hierarchy.",[12,71,72],{},[18,73],{"alt":74,"src":75},"Runner detailed view with shared configurations","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782397791/blog/Content%20Images/2023-06-19-how-to-automate-creating-runners/runner_detail_shared_configs.png",[12,77,78],{},"We heard from many of you that your Runners view was cluttered because each runner created received its own row in the table, even if they were the exact same configuration as 100 others. With this change, our intent is to ensure that you have the flexibility you need to configure a runner fleet at scale while ensuring that you can still easily understand and manage the fleet in the GitLab Runners view. We understand that this is a paradigm shift that may take some getting used to.",[23,80,82],{"id":81},"automation-steps-for-creating-a-runner","Automation steps for creating a runner",[12,84,85],{},"Here are the automation steps to create a runner.",[58,87,89],{"id":88},"step-1-create-an-access-token","Step 1: Create an access token",[12,91,92,93,99],{},"You will first need to create an access token. A ",[94,95,98],"a",{"href":96,"rel":97},"https://docs.gitlab.com/user/profile/personal_access_tokens/",[],"personal access token"," for an administrator account will allow you to create runners at the instance, group, and project levels.",[12,101,102,103,106,107,110,111,114],{},"If you only need to create a group or project runner, then it is best to use a group access token or project access token, respectively. For a group or project, navigate to ",[31,104,105],{},"Settings / Access Tokens"," and create a token. You must specify a name, the token expiration date, role, and scope. For the role, select ",[31,108,109],{},"Owner","; for the scopes, select ",[31,112,113],{},"create_runner",".",[12,116,117,118,114],{},"Note: The access token is only visible once in the UI. You will need to store this token in a secure location - for example, a secrets management solution such as Hashicorp Vault or the ",[94,119,122],{"href":120,"rel":121},"https://docs.keeper.io/secrets-manager/secrets-manager/integrations/terraform",[],"Keeper Secrets Manager Terraform plugin",[12,124,125],{},[18,126],{"alt":55,"src":127},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1782397791/blog/Content%20Images/2023-06-19-how-to-automate-creating-runners/project_access_token.png",[58,129,131],{"id":130},"step-2-use-the-access-token-to-create-a-runner-in-the-gitlab-instance","Step 2: Use the access token to create a runner in the GitLab instance",[12,133,134],{},"Now that you have an access token scoped to the instance, group, or project, the next step is to use that token to create a runner automatically. In this example, we will simply invoke a POST REST endpoint in a terminal using CURL.",[136,137,142],"pre",{"className":138,"code":139,"language":140,"meta":141,"style":141},"language-shell shiki shiki-themes github-light","curl -sX POST https://gitlab.example.com/api/v4/user/runners --data runner_type=group_type --data \"group_id=\u003Ctarget_group_or_project_id>\" --data \"description=software-eng-docker-builds-runner\" --data \"tag_list=\u003Cyour comma-separated tags>\" --header \"PRIVATE-TOKEN: \u003Cyour_access_token>\"\n","shell","",[31,143,144],{"__ignoreMap":141},[145,146,149,153,157,161,164,167,170,172,175,177,180,182,185,188],"span",{"class":147,"line":148},"line",1,[145,150,152],{"class":151},"s7eDp","curl",[145,154,156],{"class":155},"sYu0t"," -sX",[145,158,160],{"class":159},"sYBdl"," POST",[145,162,163],{"class":159}," https://gitlab.example.com/api/v4/user/runners",[145,165,166],{"class":155}," --data",[145,168,169],{"class":159}," runner_type=group_type",[145,171,166],{"class":155},[145,173,174],{"class":159}," \"group_id=\u003Ctarget_group_or_project_id>\"",[145,176,166],{"class":155},[145,178,179],{"class":159}," \"description=software-eng-docker-builds-runner\"",[145,181,166],{"class":155},[145,183,184],{"class":159}," \"tag_list=\u003Cyour comma-separated tags>\"",[145,186,187],{"class":155}," --header",[145,189,190],{"class":159}," \"PRIVATE-TOKEN: \u003Cyour_access_token>\"\n",[12,192,193,194,114],{},"Once this step is complete, the newly created runner configuration is visible in the GitLab UI. As the actual runner has not yet been configured, the status displayed is ",[31,195,196],{},"Never contacted",[12,198,199,200,203,204,207,208,211,212,214],{},"The API will return a message with the following fields: ",[31,201,202],{},"id",", ",[31,205,206],{},"token",", and ",[31,209,210],{},"token_expires_at",". You must save the value for the ",[31,213,206],{}," as it will only be displayed once.",[12,216,217,218,222,223,114],{},"As mentioned above, a critical point to note in the new runner creation is that you can reuse the runner token value to register multiple runners. If you choose to do that, runners created with the same token will be grouped in the Runners list. Whichever runner contacted GitLab most recently will be the one whose unique data (IP address, version, last contact time and status) displays in the list. You can still view all the runners in that group ",[219,220,221],"em",{},"and"," compare all of their unique data by going to the details page for that runner. Each runner in the group is uniquely identified by their ",[31,224,225],{},"system_id",[12,227,228],{},"At this point, you might ask yourself, what’s the difference between this new workflow and the workflow that relies on the registration token? The benefits are:",[39,230,231,234],{},[42,232,233],{},"You can now quickly identify the user that created a runner configuration. Not only does this add a layer of security compared to the old method, but it also simplifies troubleshooting runner performance issues, especially when your fleet expands.",[42,235,236],{},"Only the creator of the runner or administrator(s) can edit crucial configuration details like tags, the ability to run untagged jobs, the setting to lock to only run jobs in the current projects it is shared with, and more.",[23,238,240],{"id":239},"automation-of-runner-install-and-registration","Automation of runner install and registration",[12,242,243,244,249,250,255],{},"With the runner configuration creation steps completed, you now have a runner or runners configured in your GitLab instance and valid runner tokens that you can use to register a runner. You can manually install the runner application to a target compute host or automate the runner application installation. If you plan to host the runner on a public cloud virtual machine instance – for example, ",[94,245,248],{"href":246,"rel":247},"https://cloud.google.com/compute/docs/instances",[],"Google Cloud Compute Engine"," – then a good ",[94,251,254],{"href":252,"rel":253},"https://gitlab.com/gitlab-org/gitlab-runner/-/issues/1932#note_1172713979",[],"example pattern"," provided by one of our customers for automating the runner install and registration process is as follows:",[39,257,258,267,280],{},[42,259,260,261,266],{},"Use ",[94,262,265],{"href":263,"rel":264},"https://docs.gitlab.com/user/infrastructure/iac/",[],"Terraform infrastructure as code"," to install the runner application to a virtual machine hosted on GCP.",[42,268,269,270,275,276,279],{},"Use the ",[94,271,274],{"href":272,"rel":273},"https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_instance",[],"GCP Terraform provider"," and specifically the ",[31,277,278],{},"metadata"," key to automatically add the runner authentication token to the runner configuration file on the newly created GCP virtual machine.",[42,281,282,283,288],{},"Register the newly installed runner with the target GitLab instance using a ",[94,284,287],{"href":285,"rel":286},"https://cloudinit.readthedocs.io/en/latest/index.html#",[],"cloud-init"," script populated from the GCP terraform provider.",[12,290,291],{},[66,292,293],{},"Example cloud-init script",[136,295,297],{"className":138,"code":296,"language":140,"meta":141,"style":141},"#!/bin/bash\napt update\n\ncurl -L \"https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh\" | bash\nGL_NAME=$(curl 169.254.169.254/computeMetadata/v1/instance/name -H \"Metadata-Flavor:Google\")\nGL_EXECUTOR=$(curl 169.254.169.254/computeMetadata/v1/instance/attributes/gl_executor -H \"Metadata-Flavor:Google\")\napt update\napt install -y gitlab-runner\ngitlab-runner register --non-interactive --name=\"$GL_NAME\" --url=\"https://gitlab.com\" --token=\"$RUNNER_TOKEN\" --request-concurrency=\"12\" --executor=\"$GL_EXECUTOR\" --docker-image=\"alpine:latest\"\nsystemctl restart gitlab-runner\n",[31,298,299,305,314,321,339,366,387,394,408,469],{"__ignoreMap":141},[145,300,301],{"class":147,"line":148},[145,302,304],{"class":303},"sAwPA","#!/bin/bash\n",[145,306,308,311],{"class":147,"line":307},2,[145,309,310],{"class":151},"apt",[145,312,313],{"class":159}," update\n",[145,315,317],{"class":147,"line":316},3,[145,318,320],{"emptyLinePlaceholder":319},true,"\n",[145,322,324,326,329,332,336],{"class":147,"line":323},4,[145,325,152],{"class":151},[145,327,328],{"class":155}," -L",[145,330,331],{"class":159}," \"https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh\"",[145,333,335],{"class":334},"sD7c4"," |",[145,337,338],{"class":151}," bash\n",[145,340,342,346,349,352,354,357,360,363],{"class":147,"line":341},5,[145,343,345],{"class":344},"sgsFI","GL_NAME",[145,347,348],{"class":334},"=",[145,350,351],{"class":344},"$(",[145,353,152],{"class":151},[145,355,356],{"class":159}," 169.254.169.254/computeMetadata/v1/instance/name",[145,358,359],{"class":155}," -H",[145,361,362],{"class":159}," \"Metadata-Flavor:Google\"",[145,364,365],{"class":344},")\n",[145,367,369,372,374,376,378,381,383,385],{"class":147,"line":368},6,[145,370,371],{"class":344},"GL_EXECUTOR",[145,373,348],{"class":334},[145,375,351],{"class":344},[145,377,152],{"class":151},[145,379,380],{"class":159}," 169.254.169.254/computeMetadata/v1/instance/attributes/gl_executor",[145,382,359],{"class":155},[145,384,362],{"class":159},[145,386,365],{"class":344},[145,388,390,392],{"class":147,"line":389},7,[145,391,310],{"class":151},[145,393,313],{"class":159},[145,395,397,399,402,405],{"class":147,"line":396},8,[145,398,310],{"class":151},[145,400,401],{"class":159}," install",[145,403,404],{"class":155}," -y",[145,406,407],{"class":159}," gitlab-runner\n",[145,409,411,414,417,420,423,426,429,431,434,437,440,442,445,447,450,453,456,458,461,463,466],{"class":147,"line":410},9,[145,412,413],{"class":151},"gitlab-runner",[145,415,416],{"class":159}," register",[145,418,419],{"class":155}," --non-interactive",[145,421,422],{"class":155}," --name=",[145,424,425],{"class":159},"\"",[145,427,428],{"class":344},"$GL_NAME",[145,430,425],{"class":159},[145,432,433],{"class":155}," --url=",[145,435,436],{"class":159},"\"https://gitlab.com\"",[145,438,439],{"class":155}," --token=",[145,441,425],{"class":159},[145,443,444],{"class":344},"$RUNNER_TOKEN",[145,446,425],{"class":159},[145,448,449],{"class":155}," --request-concurrency=",[145,451,452],{"class":159},"\"12\"",[145,454,455],{"class":155}," --executor=",[145,457,425],{"class":159},[145,459,460],{"class":344},"$GL_EXECUTOR",[145,462,425],{"class":159},[145,464,465],{"class":155}," --docker-image=",[145,467,468],{"class":159},"\"alpine:latest\"\n",[145,470,472,475,478],{"class":147,"line":471},10,[145,473,474],{"class":151},"systemctl",[145,476,477],{"class":159}," restart",[145,479,407],{"class":159},[23,481,483],{"id":482},"whats-next","What's next?",[12,485,486],{},"So there you have it, an overview of how to automate runner creation, installation, and registration. To summarize in three simple steps:",[39,488,489,492,495],{},[42,490,491],{},"Use the API to create a runner token and configuration.",[42,493,494],{},"Store the retrieved authentication token in a secrets management solution.",[42,496,497],{},"Use infrastructure as code to install the runner application on a target compute host.",[12,499,500],{},"Our long-term vision is to directly incorporate this automation lifecycle into the product to simplify your day-to-day runner fleet management operations.",[502,503,504],"style",{},"html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}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 .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}html pre.shiki code .sD7c4, html code.shiki .sD7c4{--shiki-default:#D73A49}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}",{"title":141,"searchDepth":307,"depth":307,"links":506},[507,510,514,515],{"id":25,"depth":307,"text":26,"children":508},[509],{"id":60,"depth":316,"text":61},{"id":81,"depth":307,"text":82,"children":511},[512,513],{"id":88,"depth":316,"text":89},{"id":130,"depth":316,"text":131},{"id":239,"depth":307,"text":240},{"id":482,"depth":307,"text":483},"engineering","2023-07-06","Follow this step-by-step guide for automating runner setup using new runner creation workflows.","md",null,false,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749664087/Blog/Hero%20Images/tanukicover.jpg",{},"/en-us/blog/how-to-automate-creation-of-runners",{"title":5,"description":518,"ogTitle":5,"ogDescription":518,"noIndex":521,"ogImage":522,"ogUrl":526,"ogSiteName":527,"ogType":528,"canonicalUrls":526},"https://about.gitlab.com/blog/how-to-automate-creation-of-runners","https://about.gitlab.com","article","how-to-automate-creation-of-runners","en-us/blog/how-to-automate-creation-of-runners",[532,533,534],"tutorial","workflow","performance","BlogPost","jseyZe0TvVoDcBhuITojcJWBg1AXKkwJ9qWgmrD7DjE",{"logo":538,"freeTrial":543,"sales":548,"login":553,"items":558,"search":894,"minimal":926,"duo":945,"switchNav":954,"pricingDeployment":965},{"config":539},{"href":540,"dataGaName":541,"dataGaLocation":542},"/","gitlab logo","header",{"text":544,"config":545},"Get free trial",{"href":546,"dataGaName":547,"dataGaLocation":542},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":549,"config":550},"Request a demo",{"href":551,"dataGaName":552,"dataGaLocation":542},"/request-a-demo/","sales",{"text":554,"config":555},"Sign in",{"href":556,"dataGaName":557,"dataGaLocation":542},"https://gitlab.com/users/sign_in/","sign in",[559,645,733,738,818,872],{"text":560,"left":319,"config":561,"menu":563},"Platform",{"dataNavLevelOne":562},"platform",{"type":564,"link":565,"columns":569,"feature":634},"lists",{"text":566,"config":567},"Explore the Platform",{"href":568,"dataGaName":562,"dataGaLocation":542},"/platform/",[570,593,616],{"title":571,"items":572},"DevOps",[573,578,583,588],{"text":574,"config":575},"CI/CD",{"href":576,"dataGaLocation":542,"dataGaName":577},"/solutions/continuous-integration/","ci/cd",{"text":579,"config":580},"Source Code Management",{"href":581,"dataGaLocation":542,"dataGaName":582},"/solutions/source-code-management/","source code management",{"text":584,"config":585},"Agile Delivery",{"href":586,"dataGaLocation":542,"dataGaName":587},"/solutions/agile-delivery/","agile delivery",{"text":589,"config":590},"Artifact Management",{"href":591,"dataGaLocation":542,"dataGaName":592},"/artifact-central/","artifact management",{"title":594,"items":595},"Security & Governance",[596,601,606,611],{"text":597,"config":598},"Application Security Testing",{"href":599,"dataGaLocation":542,"dataGaName":600},"/solutions/application-security-testing/","application security testing",{"text":602,"config":603},"Governance & Compliance",{"href":604,"dataGaLocation":542,"dataGaName":605},"/solutions/software-compliance/","governance and compliance",{"text":607,"config":608},"Secrets Management",{"href":609,"dataGaLocation":542,"dataGaName":610},"/gitlab-secrets-manager/","secrets management",{"text":612,"config":613},"Supply Chain Security",{"href":614,"dataGaLocation":542,"dataGaName":615},"/solutions/supply-chain/","supply chain security",{"title":617,"items":618},"Agentic AI & Context",[619,624,629],{"text":620,"config":621},"Duo Agent Platform",{"href":622,"dataGaLocation":542,"dataGaName":623},"/gitlab-duo-agent-platform/","duo agent platform",{"text":625,"config":626},"Orbit Context Graph",{"href":627,"dataGaLocation":542,"dataGaName":628},"/gitlab-orbit/","orbit",{"text":630,"config":631},"Visibility & Measurement",{"href":632,"dataGaLocation":542,"dataGaName":633},"/solutions/visibility-measurement/","visibility and measurement",{"config":635,"title":638,"text":639,"link":640},{"background":636,"textColor":637},"url('https://res.cloudinary.com/about-gitlab-com/image/upload/v1790185102/o7dn32anqcb6z8dgd3as.jpg')","#000","GitLab Orbit is generally available","Higher agent accuracy, lower token cost",{"text":641,"config":642},"Read the announcement",{"href":643,"dataGaName":644,"dataGaLocation":542},"/blog/gitlab-orbit-ga/","orbit ga announcement",{"text":646,"left":319,"config":647,"menu":649},"Solutions",{"dataNavLevelOne":648},"solutions",{"type":564,"link":650,"columns":654,"feature":724},{"text":651,"config":652},"View all Solutions",{"href":653,"dataGaName":648,"dataGaLocation":542},"/solutions/",[655,673,691],{"title":656,"items":657},"Outcomes",[658,663,668],{"text":659,"config":660},"DevOps Modernization",{"href":661,"dataGaLocation":542,"dataGaName":662},"/assessments/devops-modernization-assessment/","devops modernization",{"text":664,"config":665},"Security Modernization",{"href":666,"dataGaLocation":542,"dataGaName":667},"/assessments/security-modernization-assessment/","security modernization",{"text":669,"config":670},"AI Modernization",{"href":671,"dataGaLocation":542,"dataGaName":672},"/assessments/ai-modernization-assessment/","ai modernization",{"title":674,"items":675},"By size",[676,681,686],{"text":677,"config":678},"Enterprise",{"href":679,"dataGaLocation":542,"dataGaName":680},"/enterprise/","enterprise",{"text":682,"config":683},"Small Business",{"href":684,"dataGaLocation":542,"dataGaName":685},"/small-business/","small business",{"text":687,"config":688},"Startups",{"href":689,"dataGaLocation":542,"dataGaName":690},"/solutions/startups/","startups",{"title":692,"items":693},"Industries",[694,699,704,709,714,719],{"text":695,"config":696},"Financial Services",{"href":697,"dataGaLocation":542,"dataGaName":698},"/solutions/finance/","financial services",{"text":700,"config":701},"Public Sector",{"href":702,"dataGaLocation":542,"dataGaName":703},"/solutions/public-sector/","public sector",{"text":705,"config":706},"Telecommunications",{"href":707,"dataGaLocation":542,"dataGaName":708},"/solutions/telecommunications/","telecommunications",{"text":710,"config":711},"Automotive",{"href":712,"dataGaLocation":542,"dataGaName":713},"/solutions/automotive/","automotive",{"text":715,"config":716},"Education",{"href":717,"dataGaLocation":542,"dataGaName":718},"/solutions/education/","education",{"text":720,"config":721},"Aerospace",{"href":722,"dataGaLocation":542,"dataGaName":723},"/solutions/aerospace/","aerospace",{"config":725,"title":726,"text":727,"link":728},{"background":636,"textColor":637},"GitLab Security Standard","Learn how to harden your software factory and let AI agents earn autonomy, without trading away security.",{"text":729,"config":730},"Explore the standard",{"href":731,"dataGaName":732,"dataGaLocation":542},"/gitlab-security-standard/","gitlab security standard",{"text":734,"config":735},"Pricing",{"href":736,"dataGaName":737,"dataGaLocation":542,"dataNavLevelOne":737},"/pricing/","pricing",{"text":739,"config":740,"menu":742},"Resources",{"dataNavLevelOne":741},"resources",{"type":564,"link":743,"columns":747,"feature":809},{"text":744,"config":745},"View all resources",{"href":746,"dataGaName":741,"dataGaLocation":542},"/resources/",[748,781],{"title":749,"items":750},"Discover",[751,756,761,766,771,776],{"text":752,"config":753},"Docs",{"href":754,"dataGaName":755,"dataGaLocation":542},"https://docs.gitlab.com/","docs",{"text":757,"config":758},"University",{"href":759,"dataGaName":760,"dataGaLocation":542},"https://university.gitlab.com/","university",{"text":762,"config":763},"Demo Series",{"href":764,"dataGaName":765,"dataGaLocation":542},"/gitlab-technical-demo-series/","demo series",{"text":767,"config":768},"Demo Hub",{"href":769,"dataGaName":770,"dataGaLocation":542},"/demo-hub/","demo hub",{"text":772,"config":773},"Services",{"href":774,"dataGaName":775,"dataGaLocation":542},"/services/","services",{"text":777,"config":778},"Well Architected",{"href":779,"dataGaName":780,"dataGaLocation":542},"/resources/well-architected/","well architected",{"title":782,"items":783},"Connect",[784,789,794,799,804],{"text":785,"config":786},"Blog",{"href":787,"dataGaName":788,"dataGaLocation":542},"/blog/","blog",{"text":790,"config":791},"Community",{"href":792,"dataGaName":793,"dataGaLocation":542},"/community/","community",{"text":795,"config":796},"Customers",{"href":797,"dataGaName":798,"dataGaLocation":542},"/customers/","customers",{"text":800,"config":801},"Partners",{"href":802,"dataGaName":803,"dataGaLocation":542},"/partners/","partners",{"text":805,"config":806},"Events",{"href":807,"dataGaName":808,"dataGaLocation":542},"/events/","events",{"config":810,"title":811,"text":812,"link":813},{"background":636,"textColor":637},"What’s new in GitLab","Stay updated with our latest features and improvements.",{"text":814,"config":815},"Read the latest",{"href":816,"dataGaName":817,"dataGaLocation":542},"/whats-new/","whats new",{"text":819,"config":820,"menu":822},"Company",{"dataNavLevelOne":821},"company",{"type":564,"columns":823},[824],{"items":825},[826,831,837,842,847,852,857,862,867],{"text":827,"config":828},"About",{"href":829,"dataGaName":830,"dataGaLocation":542},"/company/","about",{"text":832,"config":833,"footerGa":836},"Jobs",{"href":834,"dataGaName":835,"dataGaLocation":542},"/jobs/","jobs",{"dataGaName":835},{"text":838,"config":839},"Press",{"href":840,"dataGaName":841,"dataGaLocation":542},"/press/","press",{"text":843,"config":844},"Handbook",{"href":845,"dataGaName":846,"dataGaLocation":542},"https://handbook.gitlab.com/","handbook",{"text":848,"config":849},"Leadership",{"href":850,"dataGaName":851,"dataGaLocation":542},"/company/team/e-group/","leadership",{"text":853,"config":854},"Investor relations",{"href":855,"dataGaName":856,"dataGaLocation":542},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":858,"config":859},"Trust Center",{"href":860,"dataGaName":861,"dataGaLocation":542},"/security/","trust center",{"text":863,"config":864},"AI Transparency Center",{"href":865,"dataGaName":866,"dataGaLocation":542},"/ai-transparency-center/","ai transparency center",{"text":868,"config":869},"Newsletter",{"href":870,"dataGaName":871,"dataGaLocation":542},"/company/contact/#contact-forms","newsletter",{"text":873,"config":874,"menu":875},"Contact us",{"dataNavLevelOne":821},{"type":564,"columns":876},[877],{"items":878},[879,884,889],{"text":880,"config":881},"Talk to sales",{"href":882,"dataGaName":883,"dataGaLocation":542},"/sales/","talk to sales",{"text":885,"config":886},"Support portal",{"href":887,"dataGaName":888,"dataGaLocation":542},"https://support.gitlab.com/hc/en-us","support portal",{"text":890,"config":891},"Customer portal",{"href":892,"dataGaName":893,"dataGaLocation":542},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":895,"login":896,"suggestions":903},"Close",{"text":897,"link":898},"To search repositories and projects, login to",{"text":899,"config":900},"gitlab.com",{"href":556,"dataGaName":901,"dataGaLocation":902},"search login","search",{"text":904,"default":905},"Suggestions",[906,909,912,914,918,922],{"text":907,"config":908},"GitLab Duo Agent Platform",{"href":622,"dataGaName":907,"dataGaLocation":902},{"text":910,"config":911},"Code Suggestions (AI)",{"href":622,"dataGaName":910,"dataGaLocation":902},{"text":574,"config":913},{"href":576,"dataGaName":574,"dataGaLocation":902},{"text":915,"config":916},"GitLab on AWS",{"href":917,"dataGaName":915,"dataGaLocation":902},"/partners/technology-partners/aws/",{"text":919,"config":920},"GitLab on Google Cloud",{"href":921,"dataGaName":919,"dataGaLocation":902},"/partners/technology-partners/google-cloud-platform/",{"text":923,"config":924},"Why GitLab?",{"href":925,"dataGaName":923,"dataGaLocation":902},"/why-gitlab/",{"freeTrial":927,"mobileIcon":932,"desktopIcon":937,"secondaryButton":940},{"text":928,"config":929},"Start free trial",{"href":930,"dataGaName":547,"dataGaLocation":931},"https://gitlab.com/-/trials/new/","nav",{"altText":933,"config":934},"Gitlab Icon",{"src":935,"dataGaName":936,"dataGaLocation":931},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":933,"config":938},{"src":939,"dataGaName":936,"dataGaLocation":931},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":941,"config":942},"Get Started",{"href":943,"dataGaName":944,"dataGaLocation":931},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":946,"mobileIcon":950,"desktopIcon":952},{"text":947,"config":948},"Learn more about GitLab Duo",{"href":622,"dataGaName":949,"dataGaLocation":931},"gitlab duo",{"altText":933,"config":951},{"src":935,"dataGaName":936,"dataGaLocation":931},{"altText":933,"config":953},{"src":939,"dataGaName":936,"dataGaLocation":931},{"button":955,"mobileIcon":960,"desktopIcon":962},{"text":956,"config":957},"/switch",{"href":958,"dataGaName":959,"dataGaLocation":931},"#contact","switch",{"altText":933,"config":961},{"src":935,"dataGaName":936,"dataGaLocation":931},{"altText":933,"config":963},{"src":964,"dataGaName":936,"dataGaLocation":931},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":966,"mobileIcon":971,"desktopIcon":973},{"text":967,"config":968},"Back to pricing",{"href":736,"dataGaName":969,"dataGaLocation":931,"icon":970},"back to pricing","GoBack",{"altText":933,"config":972},{"src":935,"dataGaName":936,"dataGaLocation":931},{"altText":933,"config":974},{"src":939,"dataGaName":936,"dataGaLocation":931},{"title":976,"button":977,"config":981},"GitLab Orbit is generally available. Increase agent accuracy and lower token cost",{"text":641,"config":978},{"href":643,"dataGaName":979,"dataGaLocation":980},"orbit-ga-banner","global-banner",{"layout":982,"disabled":521},"release",{"data":984},{"text":985,"config":986,"items":991,"minimal":1219},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"twitter":987,"facebook":988,"youtube":989,"linkedin":990},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[992,1040,1099,1146,1187],{"title":734,"links":993,"subMenu":1009},[994,999,1004],{"text":995,"config":996},"View plans",{"href":736,"dataGaName":997,"dataGaLocation":998},"view plans","footer",{"text":1000,"config":1001},"Why Premium?",{"href":1002,"dataGaName":1003,"dataGaLocation":998},"/pricing/premium/","why premium",{"text":1005,"config":1006},"Why Ultimate?",{"href":1007,"dataGaName":1008,"dataGaLocation":998},"/pricing/ultimate/","why ultimate",[1010],{"title":1011,"links":1012},"Contact Us",[1013,1016,1018,1020,1025,1030,1035],{"text":1014,"config":1015},"Contact sales",{"href":882,"dataGaName":552,"dataGaLocation":998},{"text":885,"config":1017},{"href":887,"dataGaName":888,"dataGaLocation":998},{"text":890,"config":1019},{"href":892,"dataGaName":893,"dataGaLocation":998},{"text":1021,"config":1022},"Status",{"href":1023,"dataGaName":1024,"dataGaLocation":998},"https://status.gitlab.com/","status",{"text":1026,"config":1027},"Terms of use",{"href":1028,"dataGaName":1029,"dataGaLocation":998},"/terms/","terms of use",{"text":1031,"config":1032},"Privacy statement",{"href":1033,"dataGaName":1034,"dataGaLocation":998},"/privacy/","privacy statement",{"text":1036,"config":1037},"Cookie preferences",{"dataGaName":1038,"dataGaLocation":998,"id":1039,"isOneTrustButton":319},"cookie preferences","ot-sdk-btn",{"title":560,"links":1041,"subMenu":1057},[1042,1045,1047,1049,1051,1053],{"text":1043,"config":1044},"Explore the platform",{"href":568,"dataGaName":562,"dataGaLocation":998},{"text":620,"config":1046},{"href":622,"dataGaName":623,"dataGaLocation":998},{"text":574,"config":1048},{"href":576,"dataGaName":577,"dataGaLocation":998},{"text":625,"config":1050},{"href":627,"dataGaName":628,"dataGaLocation":998},{"text":607,"config":1052},{"href":609,"dataGaName":610,"dataGaLocation":998},{"text":1054,"config":1055},"Why GitLab",{"href":925,"dataGaName":1056,"dataGaLocation":998},"why gitlab",[1058],{"title":1059,"links":1060},"Topics",[1061,1065,1070,1074,1079,1084,1089,1094],{"text":574,"config":1062},{"href":1063,"dataGaName":1064,"dataGaLocation":998},"/topics/ci-cd/","cicd",{"text":1066,"config":1067},"GitOps",{"href":1068,"dataGaName":1069,"dataGaLocation":998},"/topics/gitops/","gitops",{"text":571,"config":1071},{"href":1072,"dataGaName":1073,"dataGaLocation":998},"/topics/devops/","devops",{"text":1075,"config":1076},"Version Control",{"href":1077,"dataGaName":1078,"dataGaLocation":998},"/topics/version-control/","version control",{"text":1080,"config":1081},"DevSecOps",{"href":1082,"dataGaName":1083,"dataGaLocation":998},"/topics/devsecops/","devsecops",{"text":1085,"config":1086},"Cloud Native",{"href":1087,"dataGaName":1088,"dataGaLocation":998},"/topics/cloud-native/","cloud native",{"text":1090,"config":1091},"AI for Coding",{"href":1092,"dataGaName":1093,"dataGaLocation":998},"/topics/devops/ai-for-coding/","ai for coding",{"text":1095,"config":1096},"Agentic AI",{"href":1097,"dataGaName":1098,"dataGaLocation":998},"/topics/agentic-ai/","agentic ai",{"title":646,"links":1100},[1101,1104,1107,1110,1113,1116,1118,1120,1122,1124,1126,1129,1131,1134,1138,1142],{"text":1102,"config":1103},"DevOps modernization",{"href":661,"dataGaName":662,"dataGaLocation":998},{"text":1105,"config":1106},"Security modernization",{"href":666,"dataGaName":667,"dataGaLocation":998},{"text":1108,"config":1109},"AI modernization",{"href":671,"dataGaName":672,"dataGaLocation":998},{"text":1111,"config":1112},"Financial services",{"href":697,"dataGaName":698,"dataGaLocation":998},{"text":1114,"config":1115},"Public sector",{"href":702,"dataGaName":703,"dataGaLocation":998},{"text":705,"config":1117},{"href":707,"dataGaName":708,"dataGaLocation":998},{"text":710,"config":1119},{"href":712,"dataGaName":713,"dataGaLocation":998},{"text":715,"config":1121},{"href":717,"dataGaName":718,"dataGaLocation":998},{"text":720,"config":1123},{"href":722,"dataGaName":723,"dataGaLocation":998},{"text":677,"config":1125},{"href":679,"dataGaName":680,"dataGaLocation":998},{"text":1127,"config":1128},"Small business",{"href":684,"dataGaName":685,"dataGaLocation":998},{"text":687,"config":1130},{"href":689,"dataGaName":690,"dataGaLocation":998},{"text":1066,"config":1132},{"href":1133,"dataGaName":1069,"dataGaLocation":998},"/solutions/gitops/",{"text":1135,"config":1136},"Software composition analysis",{"href":614,"dataGaName":1137,"dataGaLocation":998},"software composition analysis",{"text":1139,"config":1140},"Value stream management",{"href":632,"dataGaName":1141,"dataGaLocation":998},"value stream management",{"text":1143,"config":1144},"All solutions",{"href":653,"dataGaName":1145,"dataGaLocation":998},"all solutions",{"title":739,"links":1147},[1148,1153,1158,1160,1162,1164,1166,1168,1170,1172,1174,1176,1178,1180,1183],{"text":1149,"config":1150},"Install",{"href":1151,"dataGaName":1152,"dataGaLocation":998},"/install/","install",{"text":1154,"config":1155},"Quick start guides",{"href":1156,"dataGaName":1157,"dataGaLocation":998},"/get-started/","quick setup checklists",{"text":752,"config":1159},{"href":754,"dataGaName":755,"dataGaLocation":998},{"text":757,"config":1161},{"href":759,"dataGaName":760,"dataGaLocation":998},{"text":762,"config":1163},{"href":764,"dataGaName":765,"dataGaLocation":998},{"text":767,"config":1165},{"href":769,"dataGaName":770,"dataGaLocation":998},{"text":772,"config":1167},{"href":774,"dataGaName":775,"dataGaLocation":998},{"text":785,"config":1169},{"href":787,"dataGaName":788,"dataGaLocation":998},{"text":790,"config":1171},{"href":792,"dataGaName":793,"dataGaLocation":998},{"text":795,"config":1173},{"href":797,"dataGaName":798,"dataGaLocation":998},{"text":800,"config":1175},{"href":802,"dataGaName":803,"dataGaLocation":998},{"text":805,"config":1177},{"href":807,"dataGaName":808,"dataGaLocation":998},{"text":868,"config":1179},{"href":870,"dataGaName":871,"dataGaLocation":998},{"text":1181,"config":1182},"What's new",{"href":816,"dataGaName":817,"dataGaLocation":998},{"text":1184,"config":1185},"All resources",{"href":746,"dataGaName":1186,"dataGaLocation":998},"all resources",{"title":819,"links":1188},[1189,1191,1193,1195,1197,1199,1201,1203,1205,1209,1214],{"text":827,"config":1190},{"href":829,"dataGaName":821,"dataGaLocation":998},{"text":832,"config":1192},{"href":834,"dataGaName":835,"dataGaLocation":998},{"text":838,"config":1194},{"href":840,"dataGaName":841,"dataGaLocation":998},{"text":843,"config":1196},{"href":845,"dataGaName":846,"dataGaLocation":998},{"text":848,"config":1198},{"href":850,"dataGaName":851,"dataGaLocation":998},{"text":853,"config":1200},{"href":855,"dataGaName":856,"dataGaLocation":998},{"text":858,"config":1202},{"href":860,"dataGaName":861,"dataGaLocation":998},{"text":863,"config":1204},{"href":865,"dataGaName":866,"dataGaLocation":998},{"text":1206,"config":1207},"Sustainability",{"href":1208,"dataGaName":1206,"dataGaLocation":998},"/sustainability/",{"text":1210,"config":1211},"Diversity, inclusion and belonging (DIB)",{"href":1212,"dataGaName":1213,"dataGaLocation":998},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":1215,"config":1216},"Modern Slavery Transparency Statement",{"href":1217,"dataGaName":1218,"dataGaLocation":998},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":1220},[1221,1224,1227],{"text":1222,"config":1223},"Terms",{"href":1028,"dataGaName":1029,"dataGaLocation":998},{"text":1225,"config":1226},"Cookies",{"dataGaName":1038,"dataGaLocation":998,"id":1039,"isOneTrustButton":319},{"text":1228,"config":1229},"Privacy",{"href":1033,"dataGaName":1034,"dataGaLocation":998},[1231],{"id":1232,"title":7,"body":520,"config":1233,"content":1235,"description":520,"extension":1239,"meta":1240,"navigation":319,"path":1241,"seo":1242,"stem":1243,"__hash__":1244},"blogAuthors/en-us/blog/authors/darren-eastman.yml",{"template":1234},"BlogAuthor",{"name":7,"config":1236},{"headshot":1237,"ctfId":1238},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749665148/Blog/Author%20Headshots/darren_eastman.png","DarrenEastman","yml",{},"/en-us/blog/authors/darren-eastman",{},"en-us/blog/authors/darren-eastman","iXnMUFNVF56JYxVUygLV2-q6FjfdZM8UekM1NED6tu0",[1246,1254,1262],{"title":1247,"description":1248,"heroImage":1249,"category":516,"date":1250,"authors":1251,"slug":1253,"externalUrl":520},"Two front doors: Module-level access in a Django GRC app","A technical deep-dive on restructuring a Django internal tool to support two distinct GitLab teams: Security Compliance and Internal Audit.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750097663/Blog/Hero%20Images/Blog/Hero%20Images/Workflow%201800x945_2gQoQIbY9NvjLFpXtsxtXy_1750097663612.png","2026-10-05",[1252],"Donovan Felton","module-level-access-in-a-django-grc-app",{"title":1255,"description":1256,"heroImage":1257,"category":516,"date":1258,"authors":1259,"slug":1261,"externalUrl":520},"How GitLab reduced code-per-agentic-flow ratio by 45%","Learn how Flow Registry, a component-based framework that compiles YAML configurations into fully functional LangGraph flows, helped improve scalability and more.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1774465167/n5hlvrsrheadeccyr1oz.png","2026-09-22",[1260],"Mikolaj Wawrzyniak","how-gitlab-reduced-code-per-agentic-flow-ratio",{"title":1263,"description":1264,"heroImage":1265,"category":516,"date":1266,"authors":1267,"slug":1269,"externalUrl":520},"Co-Create: Building GitLab with our users","How GitLab users collaborated with us to build practical product improvements in the first half of 2026.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750099203/Blog/Hero%20Images/Blog/Hero%20Images/blog-image-template-1800x945%20%2820%29_2bJGC5ZP3WheoqzlLT05C5_1750099203484.png","2026-09-10",[1268],"Isa Huerga","co-create-h1-2026",{"header":1271,"text":1272,"button":1276,"disclaimer":1279},"Start your free\n\n30-day GitLab trial\n",[1273,1274,1275],"GitLab Duo Agent Platform access","Try our most advanced features","Automate complex tasks with AI",{"text":544,"config":1277},{"href":1278,"dataGaName":547,"dataGaLocation":788},"https://gitlab.com/-/trials/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/blog/","No credit card required.",{"header":1281,"blurb":1282,"button":1283,"secondaryButton":1288},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":1284,"config":1285},"Get your free trial",{"href":1286,"dataGaName":547,"dataGaLocation":1287},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":1014,"config":1289},{"href":882,"dataGaName":552,"dataGaLocation":1287},1794911778962]