GitHub Repo Creator Extension

A powerful Azure DevOps extension for creating GitHub repositories directly from Azure DevOps with organization-level settings management. This extension automatically tracks the relationship between Azure DevOps projects and GitHub repositories using custom properties.

🎯 Overview

The GitHub Repo Creator extension provides a streamlined way to create GitHub repositories from Azure DevOps. It integrates with GitHub API and stores organization settings and Personal Access Tokens securely using Azure DevOps' built-in data storage service.

✨ Features

• 📁 GitHub Repository Creation: Create new GitHub repositories directly from Azure DevOps
• 🏢 Organization-Level Settings: Configure organization and template repositories at the organization level
• 🔑 Secure Token Storage: Store GitHub Personal Access Tokens securely per user
• 📝 JSON Configuration: Easy-to-use JSON editor for managing organization settings and template repositories
• 🔒 Secure: Uses Azure DevOps authentication and secure data storage

🚀 Installation

Prerequisites

• Azure DevOps organization
• GitHub account and organization
• GitHub Personal Access Token with repo creation permissions
• Extension publishing permissions
• Custom property: A custom property named ADO_PROJECT_NAME must be configured in your GitHub organization settings. This extension automatically sets this property on created repositories to store the Azure DevOps project name that created the repository

📋 Usage

Accessing the Extension

Organization Settings Page:

1. Navigate to Organization Settings in Azure DevOps
2. Look for GitHub Repo Creator in the admin menu
3. Configure your Personal Access Token and organization settings

Project-Level Page:

1. Navigate to any project in Azure DevOps
2. Go to Repos section
3. Look for Create GitHub Repo tab
4. Fill the form to create a new GitHub repository

Configuring Settings (Organization Level)

Setting up Personal Access Token

1. Go to Organization Settings → GitHub Repo Creator
2. Click ✏️ Edit next to Personal Access Token field
3. Enter your GitHub Personal Access Token which has privileges to create repository in ADO
4. Click 💾 Save

Configuring Organization Settings

1. In the JSON Editor, configure your organization details: In Organisation Name provide the org name and not the url. Under Template repository provide the name of the template repository in your organisation

   {
     "Organisation": "Your organisation Name",
     "TemplateRepository": ["Template Repo Name from your org", "No Template"]
   }
   

2. Click 💾 Save JSON
3. Use Format JSON to validate and format your configuration

Creating GitHub Repositories (Project Level)

1. Navigate to Repos → Create GitHub Repo
2. Fill in the repository details:
   • Repository Name: Name for the new GitHub repository
   • Description: Repository description
   • Visibility: Public or Private
   • Template: Select from configured templates or create from scratch.
3. Click Create Repository
4. Repository will be created on GitHub using your configured settings

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Note: This extension requires Azure DevOps organization administrator permissions to install and configure.