dotnet-gha-deploy

name	dotnet-gha-deploy
category	operations
subcategory	ci-cd
description	Deploys .NET from GitHub Actions. Azure Web Apps, GitHub Pages, container registries.
license	MIT
targets	["*"]
tags	["cicd","dotnet","skill"]
version	0.0.1
author	dotnet-agent-harness
invocable	true
claudecode	{"allowed-tools":["Read","Grep","Glob","Bash","Write","Edit"]}
codexcli	{"short-description":".NET skill guidance for cicd tasks"}
opencode	{"allowed-tools":["Read","Grep","Glob","Bash","Write","Edit"]}
copilot	{}
geminicli	{}
antigravity	{}

dotnet-gha-deploy

Deployment patterns for .NET applications in GitHub Actions: GitHub Pages deployment for documentation sites (Starlight/Docusaurus), container registry push patterns for GHCR and ACR, Azure Web Apps deployment via azure/webapps-deploy, GitHub Environments with protection rules for staged rollouts, and rollback strategies for failed deployments.

Version assumptions: GitHub Actions workflow syntax v2. azure/webapps-deploy@v3 for Azure App Service. azure/login@v2 for Azure credential management. GitHub Environments for deployment gates.

Scope

• Azure Web Apps deployment via azure/webapps-deploy
• GitHub Pages deployment for documentation sites
• Container registry push patterns for GHCR and ACR
• GitHub Environments with protection rules
• Rollback strategies for failed deployments

Out of scope

• Container orchestration (Kubernetes, Docker Compose) -- see [skill:dotnet-container-deployment]
• Container image authoring -- see [skill:dotnet-containers]
• NuGet publishing and container builds -- see [skill:dotnet-gha-publish]
• Starter CI templates -- see [skill:dotnet-add-ci]
• Azure DevOps deployment -- see [skill:dotnet-ado-unique] and [skill:dotnet-ado-publish]
• CLI release pipelines -- see [skill:dotnet-cli-release-pipeline]

Cross-references: [skill:dotnet-container-deployment] for container orchestration patterns, [skill:dotnet-containers] for container image authoring, [skill:dotnet-add-ci] for starter CI templates, [skill:dotnet-cli-release-pipeline] for CLI-specific release automation.

---

GitHub Pages Deployment for Documentation

Static Site Deployment (Starlight/Docusaurus)

Deploy a .NET project's documentation site to GitHub Pages:

name: Deploy Docs

on:
  push:
    branches: [main]
    paths:
      - 'docs/**'
      - '.github/workflows/deploy-docs.yml'
  workflow_dispatch:

permissions:
  contents: read
   
   


   
   


  
     
    
        

         
         
        
           
           
           

         
         
          

          
         
           

          
         
        
           

  
     
     
    
       
         
    
           
         
         



 

        
          
                 







   
   
  
     

     
   
      
   
    
   
  
     











  
     
    
         
    
        

           
         
        
           
             
             

          
         
         
        
           
           
               

  
     
     
    
       
       
    
           
         
  
     
     
    
       
       
    
           
         








    
   


               








   


  
     []


   
   


  
     
    
        

         
         
        
           

        
         
          
         
        
           
           

  
     
     
    
       
       
    
         
         
        
           
           

          
         
        
             
             
             

            
         
        
           
           

  
     
     
    
       
       
    
         
         
        
           
           

          
         
        
             
             
             

            
         
        
           
           









     
   
  
     
     
     

    
   
   
   
   
  
     








     
   
  
       
       
       



                 
     









  
     
    
        
             
        



 []