> ## 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.

# Git Repository

> Access a GitHub repository containing a Spring Boot microservice, VM configuration templates for Azure and GCP, and automated setup scripts.

In this guide, you’ll access the GitHub repository that houses:

* A Spring Boot microservice
* VM configuration templates for Azure and GCP
* Automated setup scripts for software installation

Follow these steps to fork or import the repo, then clone it to your local machine or a VM.

## Repository Structure

| Directory/File  | Description                                         | Path           |
| --------------- | --------------------------------------------------- | -------------- |
| Spring Boot app | Java source code and `pom.xml` for Maven build      | `/`            |
| setup/azure     | ARM templates and scripts for provisioning on Azure | `/setup/azure` |
| setup/gcp       | Deployment Manager files for GCP VM configuration   | `/setup/gcp`   |
| scripts         | Shell scripts for software installation and setup   | `/scripts`     |

<Callout icon="lightbulb" color="#1CB2FE">
  Use the `setup` templates to standardize VM provisioning across Azure and GCP, ensuring consistent security policies.
</Callout>

## 1. Fork or Import the Repository

The upstream repository is named `kubernetes-devops-security`. Forking creates a personal copy under your account:

1. Navigate to the original repo:\
   `https://github.com/<original-username>/kubernetes-devops-security`
2. Click **Fork** (top-right corner) to duplicate under your account.

Alternatively, import it as a new repository:

1. On GitHub, go to **Your repositories > Import repository**.
2. Paste the source URL:
   ```text theme={null}
   https://github.com/<original-username>/kubernetes-devops-security.git
   ```
3. Name your repo, e.g., `devsecops-k8s-demo`.
4. Click **Begin import** and wait for completion.

<Callout icon="triangle-alert" color="#FF6B6B">
  Ensure you have a GitHub account and proper permissions to fork or import repositories.
</Callout>

## 2. Clone the Repository Locally

After forking or importing, clone to your development environment. First, verify Git is installed:

```bash theme={null}
git --version
```

### 2.1 Using GitHub Desktop

1. Open **GitHub Desktop**.
2. Select **File > Clone Repository**.
3. Under the **URL** tab, enter:
   ```text theme={null}
   https://github.com/<your-username>/devsecops-k8s-demo.git
   ```
4. Choose a local folder and click **Clone**.

### 2.2 Using the Command Line

```bash theme={null}
git clone https://github.com/<your-username>/devsecops-k8s-demo.git
cd devsecops-k8s-demo
```

## 3. Explore VM Templates

Review and customize the VM provisioning templates:

* Azure: `setup/azure/`
* GCP: `setup/gcp/`

Integrate with [Azure Resource Manager](https://docs.microsoft.com/azure/azure-resource-manager/templates/) and [Google Cloud Deployment Manager](https://cloud.google.com/deployment-manager).

## Links and References

* [Spring Boot Documentation](https://spring.io/projects/spring-boot)
* [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/)
* [GCP Deployment Manager](https://cloud.google.com/deployment-manager/docs)
* [GitHub Fork a Repo](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo)
* [Git CLI Documentation](https://git-scm.com/docs)

<CardGroup>
  <Card title="Watch Video" icon="video" cta="Learn more" href="https://learn.kodekloud.com/user/courses/devsecops-kubernetes-devops-security/module/6942848d-9481-472e-a8ec-47357cf8ceaa/lesson/e3585b26-9eae-4a27-8595-9712f56db013" />
</CardGroup>
