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 Applies To: All Azure Local deployments Last Updated: 2026-03-19
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
- GitLab
- Azure DevOps
Create Repository from Template
- Navigate to the Azure Local organization on GitHub
- Open the desired template repository
- Click Use this template → Create a new repository
- Configure:
| Field | Value |
|---|---|
| Owner | Your organization |
| Repository name | <org>-azurelocal (e.g. iic-azurelocal) |
| Visibility | Private |
- Click Create repository
- Wait for repository creation to complete
Tip: If using GitHub Teams, move the repository to the appropriate team after creation via Settings → Manage access.
Create Project from Template
- Navigate to your organization's group in GitLab
- Click the + in the top-left corner → New project/repository
- Select Create from template
- Select the Group heading
- Click Use template for the Azure Local template
- Configure:
| Field | Value |
|---|---|
| Project name | <org>-azurelocal (e.g. iic-azurelocal) |
| Project URL | Your organization's group path |
| Visibility | Private |
- Click Create project
- Wait for project creation (may take a few minutes)
Create Project and Repository
- Navigate to Azure DevOps and select your organization
- Click + New project
- Configure:
| Field | Value |
|---|---|
| Project name | <org>-azurelocal (e.g. iic-azurelocal) |
| Visibility | Private |
| Version control | Git |
| Work item process | Agile (or your org standard) |
- Click Create
Initialize from Template
- In the new project, go to Repos → Files
- Click Import a repository
- Enter the Azure Local template repository URL
- 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