Task 02: Create source control project

DOCUMENT CATEGORY: Runbook Step
SCOPE: Source control project creation
PURPOSE: Create deployment source control project from Azure Local template
MASTER REFERENCE: Source Control Project Setup Guide

Status: Active

---

Objective

Create a new source control project/repository for the deployment using the Azure Local template.

---

Prerequisites

• Bootstrap complete (Task 01)
• Source control platform access (GitHub, GitLab, or Azure DevOps)

---

Procedure

GitHub

Create Repository from Template

1. Navigate to the Azure Local organization on GitHub
2. Open the desired template repository
3. Click Use this template → Create a new repository
4. Configure:

Field	Value
Owner	Your organization
Repository name	<org>-azurelocal (e.g. iic-azurelocal)
Visibility	Private

5. Click Create repository
6. Wait for repository creation to complete

Tip: If using GitHub Teams, move the repository to the appropriate team after creation via Settings → Manage access.

GitLab

Create Project from Template

1. Navigate to your organization's group in GitLab
2. Click the + in the top-left corner → New project/repository
3. Select Create from template
4. Select the Group heading
5. Click Use template for the Azure Local template
6. Configure:

Field	Value
Project name	<org>-azurelocal (e.g. iic-azurelocal)
Project URL	Your organization's group path
Visibility	Private

7. Click Create project
8. Wait for project creation (may take a few minutes)

Azure DevOps

Create Project and Repository

1. Navigate to Azure DevOps and select your organization
2. Click + New project
3. Configure:

Field	Value
Project name	<org>-azurelocal (e.g. iic-azurelocal)
Visibility	Private
Version control	Git
Work item process	Agile (or your org standard)

4. Click Create

Initialize from Template

5. In the new project, go to Repos → Files
6. Click Import a repository
7. Enter the Azure Local template repository URL
8. Click Import and wait for completion

---

Verification

• Project/repository created successfully
• Project appears in the correct group/organization
• Project name follows your organization's naming convention
• Template content is present in the repository

---

Next Steps

Configure Project Settings

---

References

GitHub

• Creating a repository from a template

GitLab

• Create a project from a custom template

Azure DevOps

• Create a project in Azure DevOps
• Import a Git repo

---

Variables from variables.yml

Variable	Config Path	Example
Project Name	cicd.project.name	azurelocal-deployment
Organization URL	cicd.organization.url	https://dev.azure.com/contoso
Repository Name	cicd.repository.name	infrastructure

---

Toolkit Reference

Scripts for this task are located in the azurelocal-toolkit repository under scripts/deploy/ in the appropriate task folder.

---

Alternatives

The procedures in this task use the scripted methods shown in the tabs above. Additional deployment methods including Azure CLI and Bash scripts are available in the azurelocal-toolkit repository under scripts/deploy/.

Method	Description
Azure CLI	PowerShell-based Azure CLI scripts for Azure resource operations
Bash	Linux/macOS compatible shell scripts for pipeline environments

Navigation

Previous	Up	Next
← Task 01: Bootstrap	Phase 01: CI/CD Setup	Task 03: Configure Project Settings ->

---

Troubleshooting

Issue	Cause	Resolution
Repository creation fails	Insufficient permissions on source control platform	Verify account has project/repo creation rights
Template not available	Organization template restrictions	Contact platform administrator to enable templates

---

Version Control

Version	Date	Author	Changes
1.0.0	2025-03-25	Azure Local Cloud	Initial release