> ## Documentation Index > Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Customize Agent Config and Staging Environment > This guide explains how to customize GitLab Kubernetes agent configuration, set up a staging environment, and scope CI/CD variables for efficient deployments. In this guide, you'll learn how to tailor your GitLab Kubernetes agent configuration, set up a staging environment, and scope CI/CD variables to streamline deployments. By the end, your CI jobs will use `kubectl` against your cluster, and your team can view the Kubernetes dashboard directly in GitLab. ## 1. Configure the GitLab Agent First, create a `config.yaml` for your Kubernetes agent to enable GitOps workflows, CI/CD deployments, and dashboard access. Place this file in your repository’s default branch under: ```text theme={null} .gitlab/agents//config.yaml ``` Replace `` with your actual agent identifier, and ensure you commit to the branch marked as **default** in your project's **Branches** page. ![The image shows a GitLab documentation page about installing an agent for Kubernetes, with instructions on creating an agent configuration file. The sidebar lists related topics and installation steps.](https://kodekloud.com/kk-media/image/upload/v1752877183/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-kubernetes-agent-installation-guide.jpg) Check which branch is set as default (commonly **main**): ![The image shows a GitLab repository page displaying active branches, including "feature/setting-up-gitlab-cicd" and "main," with details about recent commits and branch status.](https://kodekloud.com/kk-media/image/upload/v1752877184/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-repository-active-branches.jpg) Add the following content to `config.yaml`: ```yaml theme={null} ci_access: projects: # Allow CI jobs to deploy manifests in this project - id: demos-group/solar-system user_access: access_as: agent: {} projects: # Permit users to view the Kubernetes dashboard in this project - id: demos-group/solar-system ``` Commit and push to your default branch. After the push, confirm the agent status: ![The image shows a GitLab interface displaying the status of a Kubernetes agent named "kk-gitlab-agent," which is connected and has a valid access token. The left sidebar includes various options like "Manage," "Plan," "Code," and "Kubernetes clusters."](https://kodekloud.com/kk-media/image/upload/v1752877184/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-kubernetes-agent-status.jpg) Now, CI jobs receive a `kubeconfig` context for `kubectl` commands, and users can access the Kubernetes dashboard within GitLab environments. You can verify the available contexts in any job script: ```bash theme={null} kubectl config get-contexts CURRENT NAME * vke-479a34c5-9e64-4042-aee3-8af8df9686dc ``` ## 2. Enable the Kubernetes Dashboard To visualize cluster resources, enable the Kubernetes dashboard in GitLab: [Dashboard for Kubernetes](https://docs.gitlab.com/ee/user/environment/dashboard/) ![The image shows a GitLab documentation page for the "Dashboard for Kubernetes," detailing its features and usage. It includes a sidebar with navigation options and a section on configuring and viewing the dashboard.](https://kodekloud.com/kk-media/image/upload/v1752877186/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-dashboard-kubernetes-docs.jpg) 1. In your project, go to **Operations > Environments** and click **New environment**. ![The image shows a GitLab interface for creating a new environment, with fields for the environment name, external URL, GitLab agent, and an optional Kubernetes namespace.](https://kodekloud.com/kk-media/image/upload/v1752877187/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-create-environment-interface.jpg) 2. Set the **Environment name** to `staging`, select your GitLab agent, and optionally specify a Kubernetes namespace (leave blank to display all). 3. Click **Save**. The **Overview** dashboard now lists your Kubernetes services: ![The image shows a GitLab environment dashboard displaying Kubernetes services, including details like name, namespace, type, cluster IP, external IP, ports, and age. The sidebar on the left includes navigation options such as Merge requests, Manage, Plan, Code, and more.](https://kodekloud.com/kk-media/image/upload/v1752877188/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-kubernetes-dashboard-services.jpg) 4. After deploying workloads, the dashboard reflects the live status and health: ![The image shows a GitLab environment dashboard for a project named "solar-system," displaying Kubernetes deployment details such as environment status, pod status, and service information. The environment is marked as "Healthy" with two running pods and no pending, succeeded, or failed deployments.](https://kodekloud.com/kk-media/image/upload/v1752877189/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-solar-system-kubernetes-dashboard.jpg) On paid GitLab tiers, you’ll also see the extended **Monitoring** view: ![The image shows a GitLab documentation page for the "Dashboard for Kubernetes," detailing features and configuration options for monitoring Kubernetes clusters. It includes a visual interface with status indicators for running, pending, succeeded, and failed pods.](https://kodekloud.com/kk-media/image/upload/v1752877190/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-dashboard-kubernetes-monitoring.jpg) ## 3. Scope CI/CD Variables to Staging Isolate settings for your staging environment by defining environment-scoped variables: 1. Navigate to **Settings > CI/CD > Variables**. 2. Click **Add variable**. 3. Enter your keys and values, then set **Environment scope** to `staging`: ```text theme={null} Key: NAMESPACE Value: staging Key: REPLICAS Value: "4" ``` ![The image shows a GitLab CI/CD settings page with a list of environment variables, some of which are masked. There's also a sidebar for adding a new variable with options for type, environment, and flags.](https://kodekloud.com/kk-media/image/upload/v1752877191/notes-assets/images/GitLab-CICD-Architecting-Deploying-and-Optimizing-Pipelines-Customize-Agent-Config-and-Staging-Environment/gitlab-ci-cd-settings-environment-variables.jpg) Scoped variables only apply to jobs that target the **staging** environment. Ensure your `.gitlab-ci.yml` uses the correct environment name. With these steps complete, your agent is configured, your staging environment is ready, and your CI/CD variables are scoped for targeted deployments. ## References * [GitLab Kubernetes Agent](https://docs.gitlab.com/ee/user/clusters/agents/) * [Dashboard for Kubernetes](https://docs.gitlab.com/ee/user/environment/dashboard/)