콘텐츠 대표 이미지 - DevOps와 Azure DevOps로 완성하는 CI/CD 파이프라인 구축 실전 가이드 🚀

DevOps와 Azure DevOps로 완성하는 CI/CD 파이프라인 구축 실전 가이드 🚀

현대적인 소프트웨어 개발의 핵심, 자동화된 배포 파이프라인을 마스터하자!

👋 안녕! 오늘은 개발자라면 꼭 알아야 할 DevOps와 CI/CD에 대해 이야기해볼까 해. 특히 C# 개발자라면 Microsoft의 Azure DevOps를 활용한 파이프라인 구축은 정말 필수적인 스킬이야. 코드를 작성하고 수동으로 빌드하고, 테스트하고, 배포하는 과정... 생각만 해도 피곤하지 않아? 😅


이 모든 과정을 자동화해서 개발자가 코드 작성에만 집중할 수 있게 만드는 게 바로 CI/CD 파이프라인이야. 재능넷에서도 다양한 DevOps 전문가들이 이런 자동화 구축 노하우를 공유하고 있는데, 오늘은 내가 친구처럼 편하게 설명해줄게! 🎯

DevOps가 뭐길래? 🤔

DevOps는 Development(개발)와 Operations(운영)의 합성어야. 전통적으로 개발팀과 운영팀은 서로 다른 목표를 가지고 있었어. 개발팀은 "빨리 새로운 기능을 만들자!"였고, 운영팀은 "시스템 안정성이 최우선이야!"였지. 이 둘의 충돌이 얼마나 많은 문제를 일으켰는지... 💥

📌 DevOps의 핵심 원칙

1. 협업과 소통
개발자와 운영자가 하나의 팀으로 일하며 공동의 목표를 향해 나아가는 거야. 더 이상 "내 코드는 내 컴퓨터에서 잘 돌아가는데?"라는 말은 통하지 않아! 😄


2. 자동화
반복적인 작업은 모두 자동화해서 인간의 실수를 줄이고 속도를 높이는 거지. 빌드, 테스트, 배포까지 모든 과정을 자동화할 수 있어.


3. 지속적인 개선
한 번 만들고 끝이 아니라 계속해서 피드백을 받고 개선해나가는 문화야. 실패를 두려워하지 않고 빠르게 배우는 게 중요해.


4. 측정과 모니터링
모든 것을 측정하고 데이터 기반으로 의사결정을 내려. "느낌적인 느낌"이 아니라 실제 지표를 보고 판단하는 거지.

DEV 개발팀 OPS 운영팀 DevOps 협업 · 자동화 지속적 개선 빠른 피드백 빠른 출시 안정적 운영

CI/CD가 뭐야? 🔄

CI/CD는 DevOps의 핵심 실천 방법 중 하나야. Continuous Integration(지속적 통합)과 Continuous Delivery/Deployment(지속적 전달/배포)의 약자지. 이름만 들어도 뭔가 계속 돌아가는 느낌이지? ⚙️

CI (Continuous Integration) - 지속적 통합 🔗

💡 CI는 이런 거야:


개발자들이 코드를 작성하고 Git 같은 버전 관리 시스템에 푸시하면, 자동으로 빌드되고 테스트되는 과정이야. 예전에는 여러 개발자가 작성한 코드를 합치는 "통합" 작업이 정말 고통스러웠어. 일주일 동안 각자 작업한 코드를 금요일에 합치면... 충돌의 향연! 🔥


하지만 CI를 사용하면 코드를 푸시할 때마다 자동으로 통합되고 테스트되니까, 문제를 빨리 발견할 수 있어. "작은 문제를 자주"가 "큰 문제를 가끔"보다 훨씬 낫잖아?

CI의 주요 단계

1단계: 코드 커밋
개발자가 Git 저장소에 코드를 푸시해. 이게 모든 것의 시작점이야.


2단계: 자동 빌드
CI 서버가 새로운 커밋을 감지하고 자동으로 빌드를 시작해. C# 프로젝트라면 dotnet build 명령어가 실행되는 거지.


3단계: 자동 테스트
단위 테스트, 통합 테스트 등이 자동으로 실행돼. 테스트가 실패하면? 빌드도 실패! ❌


4단계: 피드백
빌드와 테스트 결과를 개발자에게 알려줘. 이메일, 슬랙, 팀즈 등으로 바로바로 알림이 와.

CD (Continuous Delivery/Deployment) - 지속적 전달/배포 🚢

CD는 두 가지 의미로 사용돼. Continuous Delivery와 Continuous Deployment인데, 미묘하게 달라.

📦 Continuous Delivery (지속적 전달)


코드가 항상 배포 가능한 상태로 유지되는 거야. 빌드와 테스트를 통과한 코드는 언제든지 프로덕션에 배포할 수 있어. 하지만 실제 배포는 사람이 버튼을 눌러서 수동으로 진행해. 중요한 비즈니스 결정이 필요할 때 유용하지.

🚀 Continuous Deployment (지속적 배포)


한 단계 더 나아가서, 테스트를 통과한 모든 변경사항이 자동으로 프로덕션에 배포되는 거야. 사람의 개입 없이 완전 자동! 물론 이렇게 하려면 테스트가 정말정말 탄탄해야 해. 💪

Azure DevOps 소개 ☁️

자, 이제 본격적으로 Azure DevOps에 대해 알아볼까? Microsoft가 만든 이 플랫폼은 DevOps 실천을 위한 모든 도구를 제공해. C# 개발자라면 Visual Studio와의 완벽한 통합 덕분에 정말 편하게 사용할 수 있어! 🎉

🛠️ Azure DevOps의 주요 서비스


Azure Boards
작업 항목 추적, 스프린트 계획, 칸반 보드 등을 제공해. 애자일 방법론을 실천하기 좋아.


Azure Repos
Git 저장소를 호스팅해줘. GitHub처럼 사용할 수 있고, 풀 리퀘스트, 코드 리뷰 기능도 있어.


Azure Pipelines
오늘의 주인공! CI/CD 파이프라인을 만들고 실행하는 서비스야. 이게 정말 강력해.


Azure Test Plans
수동 테스트와 탐색적 테스트를 관리할 수 있어. 테스트 케이스를 체계적으로 관리하고 싶을 때 유용해.


Azure Artifacts
NuGet, npm, Maven 같은 패키지를 호스팅하고 공유할 수 있어. 팀 내부에서 사용하는 라이브러리를 관리하기 좋지.

Azure DevOps Services Boards 작업 관리 애자일 보드 Repos Git 저장소 코드 리뷰 Pipelines CI/CD 자동화 Test Plans 테스트 관리 품질 보증 Artifacts 패키지 관리 NuGet 등 통합

Azure DevOps 시작하기 🎬

이론은 이 정도면 충분해. 이제 실제로 Azure DevOps를 사용해서 CI/CD 파이프라인을 만들어보자! 💻

1단계: Azure DevOps 조직 만들기 🏢

준비물:

• Microsoft 계정 (Outlook, Hotmail 등)
• 웹 브라우저
• 약간의 열정 🔥


진행 과정:


1. dev.azure.com에 접속해
2. Microsoft 계정으로 로그인
3. "Create new organization" 클릭
4. 조직 이름 입력 (예: mycompany-devops)
5. 지역 선택 (한국이면 East Asia 추천)
6. 완료! ✅


무료 플랜으로 시작할 수 있어. 5명까지는 무료로 사용 가능하고, 빌드 파이프라인도 매달 1,800분까지 무료야. 개인 프로젝트나 소규모 팀에는 충분해!

2단계: 프로젝트 생성 📁

조직을 만들었으면 이제 프로젝트를 만들어야 해. 프로젝트는 하나의 애플리케이션이나 서비스를 관리하는 단위야.

프로젝트 생성 옵션:


• 프로젝트 이름: 의미 있는 이름을 지어줘 (예: MyAwesomeApp)
• 가시성: Private (비공개) 또는 Public (공개)
• 버전 관리: Git 추천! (TFVC는 레거시야)
• 작업 항목 프로세스: Agile, Scrum, CMMI 중 선택 (Agile이 가장 무난해)

3단계: C# 프로젝트 준비 🎯

이제 실제로 배포할 C# 프로젝트가 필요해. 간단한 ASP.NET Core Web API를 예시로 들어볼게.

로컬에서 프로젝트 생성


// .NET CLI를 사용한 프로젝트 생성
dotnet new webapi -n MyAwesomeApi
cd MyAwesomeApi

// Git 저장소 초기화
git init
git add .
git commit -m "Initial commit"

// Azure Repos에 연결
git remote add origin https://dev.azure.com/yourorg/yourproject/_git/MyAwesomeApi
git push -u origin master

💡 팁: Visual Studio를 사용한다면 Team Explorer에서 직접 Azure DevOps에 연결할 수 있어. File → Add to Source Control → Git을 선택하고, Azure DevOps 저장소를 선택하면 돼. 정말 편해! 😊

CI 파이프라인 구축하기 🔨

드디어 본격적인 파이프라인 구축 시간이야! Azure Pipelines는 YAML 파일로 파이프라인을 정의해. 코드로 인프라를 관리하는 Infrastructure as Code (IaC) 개념이지. 📝

YAML 파이프라인 기본 구조 📋

YAML은 사람이 읽기 쉬운 데이터 직렬화 형식이야. 들여쓰기가 중요하니까 주의해야 해!

기본 CI 파이프라인 예제


# azure-pipelines.yml
trigger:
  - master
  - develop

pool:
  vmImage: 'ubuntu-latest'

variables:
  buildConfiguration: 'Release'

steps:
- task: UseDotNet@2
  displayName: 'Install .NET SDK'
  inputs:
    version: '8.x'
    
- task: DotNetCoreCLI@2
  displayName: 'Restore packages'
  inputs:
    command: 'restore'
    projects: '**/*.csproj'
    
- task: DotNetCoreCLI@2
  displayName: 'Build project'
  inputs:
    command: 'build'
    projects: '**/*.csproj'
    arguments: '--configuration $(buildConfiguration)'
    
- task: DotNetCoreCLI@2
  displayName: 'Run tests'
  inputs:
    command: 'test'
    projects: '**/*Tests.csproj'
    arguments: '--configuration $(buildConfiguration) --collect:"XPlat Code Coverage"'
    
- task: DotNetCoreCLI@2
  displayName: 'Publish application'
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: true
    
- task: PublishBuildArtifacts@1
  displayName: 'Publish artifacts'
  inputs:
    PathtoPublish: '$(Build.ArtifactStagingDirectory)'
    ArtifactName: 'drop'
    publishLocation: 'Container'

와, 코드가 좀 길지? 하나씩 뜯어보자! 🔍

YAML 파일 구성 요소 설명


trigger:
어떤 브랜치에 푸시될 때 파이프라인을 실행할지 정의해. master와 develop 브랜치에 푸시되면 자동으로 빌드가 시작돼.


pool:
어떤 환경에서 빌드를 실행할지 지정해. ubuntu-latest는 최신 Ubuntu 리눅스를 사용한다는 뜻이야. Windows가 필요하면 windows-latest를 사용하면 돼.


variables:
파이프라인에서 사용할 변수를 정의해. 여기서는 빌드 구성을 Release로 설정했어.


steps:
실제로 실행될 작업들의 순서야. 각 step은 하나의 task를 실행해.

각 Task 상세 분석 🔬

1️⃣ UseDotNet@2

.NET SDK를 설치하는 task야. 버전을 지정할 수 있어. 8.x는 .NET 8의 최신 버전을 의미해.

2️⃣ DotNetCoreCLI@2 (restore)

NuGet 패키지를 복원해. dotnet restore 명령어와 같아. 프로젝트가 의존하는 모든 라이브러리를 다운로드하지.

3️⃣ DotNetCoreCLI@2 (build)

프로젝트를 빌드해. Release 구성으로 빌드하면 최적화된 코드가 생성돼. 디버그 심볼은 제거되고 성능이 향상되지.

4️⃣ DotNetCoreCLI@2 (test)

단위 테스트를 실행해. 코드 커버리지도 수집할 수 있어. 테스트가 실패하면 파이프라인도 실패해!

5️⃣ DotNetCoreCLI@2 (publish)

배포 가능한 형태로 애플리케이션을 패키징해. 모든 필요한 파일들이 하나의 폴더에 모이고, ZIP 파일로 압축돼.

6️⃣ PublishBuildArtifacts@1

빌드 결과물(아티팩트)을 Azure DevOps에 업로드해. 나중에 CD 파이프라인에서 이 아티팩트를 사용해서 배포할 수 있어.

파이프라인 실행하기 ▶️

YAML 파일을 작성했으면 이제 실행해볼 차례야!

실행 방법:


1. azure-pipelines.yml 파일을 프로젝트 루트에 저장
2. Git에 커밋하고 푸시
3. Azure DevOps 웹사이트에서 Pipelines 메뉴로 이동
4. "New Pipeline" 클릭
5. 저장소 선택 (Azure Repos Git)
6. "Existing Azure Pipelines YAML file" 선택
7. 방금 만든 YAML 파일 선택
8. "Run" 클릭! 🚀

파이프라인이 실행되면 각 step의 진행 상황을 실시간으로 볼 수 있어. 로그도 상세하게 나와서 문제가 생기면 어디서 실패했는지 바로 알 수 있지. 👀

🎨 재능넷 활용 팁: 파이프라인 구축이 처음이라 막막하다면, 재능넷에서 Azure DevOps 전문가를 찾아보는 것도 좋은 방법이야. 실무 경험이 풍부한 전문가들이 프로젝트에 맞는 최적의 파이프라인을 설계해줄 수 있어!

CD 파이프라인 구축하기 🚢

CI 파이프라인으로 빌드와 테스트를 자동화했으니, 이제 배포도 자동화해보자! CD 파이프라인은 여러 환경(개발, 스테이징, 프로덕션)에 순차적으로 배포하는 과정을 정의해. 🎯

Multi-Stage 파이프라인 🎭

Azure Pipelines는 multi-stage 파이프라인을 지원해. 빌드, 테스트, 배포를 하나의 YAML 파일에서 관리할 수 있어.

Multi-Stage 파이프라인 예제


# azure-pipelines-full.yml
trigger:
  - master

pool:
  vmImage: 'ubuntu-latest'

variables:
  buildConfiguration: 'Release'

stages:
- stage: Build
  displayName: 'Build and Test'
  jobs:
  - job: BuildJob
    displayName: 'Build Application'
    steps:
    - task: UseDotNet@2
      displayName: 'Install .NET SDK'
      inputs:
        version: '8.x'
        
    - task: DotNetCoreCLI@2
      displayName: 'Restore packages'
      inputs:
        command: 'restore'
        
    - task: DotNetCoreCLI@2
      displayName: 'Build'
      inputs:
        command: 'build'
        arguments: '--configuration $(buildConfiguration)'
        
    - task: DotNetCoreCLI@2
      displayName: 'Test'
      inputs:
        command: 'test'
        arguments: '--configuration $(buildConfiguration)'
        
    - task: DotNetCoreCLI@2
      displayName: 'Publish'
      inputs:
        command: 'publish'
        publishWebProjects: true
        arguments: '--configuration $(buildConfiguration) --output $(Build.ArtifactStagingDirectory)'
        
    - task: PublishBuildArtifacts@1
      inputs:
        PathtoPublish: '$(Build.ArtifactStagingDirectory)'
        ArtifactName: 'drop'

- stage: DeployDev
  displayName: 'Deploy to Development'
  dependsOn: Build
  condition: succeeded()
  jobs:
  - deployment: DeployDevJob
    displayName: 'Deploy to Dev Environment'
    environment: 'development'
    strategy:
      runOnce:
        deploy:
          steps:
          - task: AzureWebApp@1
            displayName: 'Deploy to Azure Web App'
            inputs:
              azureSubscription: 'Azure-Connection'
              appType: 'webApp'
              appName: 'myapp-dev'
              package: '$(Pipeline.Workspace)/drop/*.zip'

- stage: DeployStaging
  displayName: 'Deploy to Staging'
  dependsOn: DeployDev
  condition: succeeded()
  jobs:
  - deployment: DeployStagingJob
    displayName: 'Deploy to Staging Environment'
    environment: 'staging'
    strategy:
      runOnce:
        deploy:
          steps:
          - task: AzureWebApp@1
            displayName: 'Deploy to Azure Web App'
            inputs:
              azureSubscription: 'Azure-Connection'
              appType: 'webApp'
              appName: 'myapp-staging'
              package: '$(Pipeline.Workspace)/drop/*.zip'

- stage: DeployProduction
  displayName: 'Deploy to Production'
  dependsOn: DeployStaging
  condition: succeeded()
  jobs:
  - deployment: DeployProdJob
    displayName: 'Deploy to Production Environment'
    environment: 'production'
    strategy:
      runOnce:
        deploy:
          steps:
          - task: AzureWebApp@1
            displayName: 'Deploy to Azure Web App'
            inputs:
              azureSubscription: 'Azure-Connection'
              appType: 'webApp'
              appName: 'myapp-prod'
              package: '$(Pipeline.Workspace)/drop/*.zip'

이 파이프라인은 4개의 stage로 구성되어 있어:

1. Build Stage 🔨 애플리케이션을 빌드하고 테스트해. 아티팩트를 생성하지.


2. DeployDev Stage 🧪
개발 환경에 배포해. 개발자들이 최신 변경사항을 바로 확인할 수 있어.


3. DeployStaging Stage 🎬
스테이징 환경에 배포해. 프로덕션과 동일한 환경에서 최종 테스트를 진행해.


4. DeployProduction Stage 🌟
프로덕션 환경에 배포해. 실제 사용자들이 사용하는 환경이야!

Environment와 Approval 🛡️

프로덕션에 자동으로 배포되는 게 무섭다고? 걱정 마! Azure DevOps의 Environment 기능을 사용하면 승인 프로세스를 추가할 수 있어. ✋

Environment 설정 방법:


1. Azure DevOps에서 Pipelines → Environments 메뉴로 이동
2. "New environment" 클릭
3. 환경 이름 입력 (예: production)
4. "Approvals and checks" 클릭
5. "Approvals" 추가
6. 승인자 지정 (팀 리더, 운영 담당자 등)
7. 저장!


이제 프로덕션 배포 전에 지정된 사람의 승인이 필요해. 승인 요청이 오면 이메일로 알림이 가고, Azure DevOps에서 변경사항을 검토한 후 승인하거나 거부할 수 있어. 👍

⚠️ 주의사항: 프로덕션 환경에는 반드시 승인 프로세스를 설정하는 게 좋아. 실수로 버그가 있는 코드가 배포되면 큰 문제가 될 수 있거든. 안전장치는 많을수록 좋아!

Azure Web App 배포 설정 🌐

Azure Web App에 배포하려면 먼저 Azure 리소스를 만들어야 해. 간단하게 설명해줄게!

Azure Web App 생성 ☁️

Azure Portal에서 생성:


1. Azure Portal (portal.azure.com)에 로그인
2. "Create a resource" 클릭
3. "Web App" 검색 및 선택
4. 기본 정보 입력:
• Subscription: 사용할 구독 선택
• Resource Group: 새로 만들거나 기존 것 선택
• Name: 고유한 이름 (예: myapp-dev)
• Runtime stack: .NET 8 선택
• Region: Korea Central 추천
• Pricing tier: 개발용은 F1 (무료) 또는 B1
5. "Review + create" 클릭
6. "Create" 클릭!

개발, 스테이징, 프로덕션 환경을 위해 3개의 Web App을 만들어야 해. 이름을 구분하기 쉽게 지어주면 좋아 (예: myapp-dev, myapp-staging, myapp-prod). 📝

Service Connection 설정 🔗

Azure DevOps가 Azure 리소스에 접근하려면 Service Connection이 필요해. 이건 일종의 인증 정보야.

Service Connection 만들기:


1. Azure DevOps 프로젝트 설정으로 이동
2. "Service connections" 메뉴 클릭
3. "New service connection" 클릭
4. "Azure Resource Manager" 선택
5. "Service principal (automatic)" 선택 (가장 쉬워!)
6. Azure 구독 선택
7. Resource group 선택 (선택사항)
8. Service connection 이름 입력 (예: Azure-Connection)
9. "Grant access permission to all pipelines" 체크
10. "Save" 클릭!


이제 파이프라인 YAML에서 azureSubscription: 'Azure-Connection'처럼 사용할 수 있어. 🎉

고급 파이프라인 기능들 🚀

기본적인 CI/CD 파이프라인을 만들었으니, 이제 좀 더 고급 기능들을 알아보자!

Variables와 Variable Groups 📦

하드코딩된 값들을 변수로 관리하면 유지보수가 훨씬 쉬워져. 특히 비밀번호나 API 키 같은 민감한 정보는 절대 코드에 직접 넣으면 안 돼! 🔐

Variable Group 만들기


1. Pipelines → Library 메뉴로 이동
2. "+ Variable group" 클릭
3. 그룹 이름 입력 (예: Production-Variables)
4. 변수 추가:
• DatabaseConnectionString
• ApiKey
• EmailServiceUrl
5. 민감한 값은 자물쇠 아이콘 클릭해서 암호화
6. "Save" 클릭!

YAML 파이프라인에서 Variable Group을 사용하려면:

variables:
- group: Production-Variables
- name: buildConfiguration
  value: 'Release'

steps:
- script: echo "Connection string is $(DatabaseConnectionString)"
  displayName: 'Use variable'

Template 활용하기 📄

여러 파이프라인에서 공통으로 사용하는 step들이 있다면 template으로 만들어서 재사용할 수 있어. DRY (Don't Repeat Yourself) 원칙! ♻️

build-template.yml


parameters:
- name: buildConfiguration
  type: string
  default: 'Release'

steps:
- task: UseDotNet@2
  displayName: 'Install .NET SDK'
  inputs:
    version: '8.x'
    
- task: DotNetCoreCLI@2
  displayName: 'Restore'
  inputs:
    command: 'restore'
    
- task: DotNetCoreCLI@2
  displayName: 'Build'
  inputs:
    command: 'build'
    arguments: '--configuration ${{ parameters.buildConfiguration }}'
    
- task: DotNetCoreCLI@2
  displayName: 'Test'
  inputs:
    command: 'test'
    arguments: '--configuration ${{ parameters.buildConfiguration }}'

메인 파이프라인에서 template 사용:

trigger:
  - master

pool:
  vmImage: 'ubuntu-latest'

stages:
- stage: Build
  jobs:
  - job: BuildJob
    steps:
    - template: build-template.yml
      parameters:
        buildConfiguration: 'Release'

이렇게 하면 빌드 로직을 한 곳에서 관리할 수 있어. 변경이 필요하면 template만 수정하면 되니까 정말 편해! 😎

Conditional Execution 조건부 실행 🔀

특정 조건에서만 step이나 stage를 실행하고 싶을 때가 있어. 예를 들어, master 브랜치에 푸시될 때만 프로덕션에 배포한다든지.

- stage: DeployProduction
  displayName: 'Deploy to Production'
  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/master'))
  jobs:
  - deployment: DeployProdJob
    environment: 'production'
    strategy:
      runOnce:
        deploy:
          steps:
          - task: AzureWebApp@1
            inputs:
              azureSubscription: 'Azure-Connection'
              appName: 'myapp-prod'
              package: '$(Pipeline.Workspace)/drop/*.zip'

이 파이프라인은 master 브랜치에 푸시되고, 이전 stage가 성공했을 때만 프로덕션에 배포해. 안전하지? 🛡️

Parallel Jobs 병렬 실행 ⚡

여러 작업을 동시에 실행하면 파이프라인 실행 시간을 크게 줄일 수 있어. 예를 들어, 여러 플랫폼에서 동시에 빌드한다든지.

jobs:
- job: BuildWindows
  pool:
    vmImage: 'windows-latest'
  steps:
  - script: echo "Building on Windows"
  
- job: BuildLinux
  pool:
    vmImage: 'ubuntu-latest'
  steps:
  - script: echo "Building on Linux"
  
- job: BuildMacOS
  pool:
    vmImage: 'macOS-latest'
  steps:
  - script: echo "Building on macOS"

이 3개의 job은 동시에 실행돼. 시간이 3배 빨라지는 건 아니지만 (각 job마다 시간이 다르니까), 전체적으로는 훨씬 빨라져! ⚡

테스트 자동화 심화 🧪

CI/CD의 핵심은 자동화된 테스트야. 테스트 없는 CI/CD는 그냥 자동화된 배포일 뿐이야. 위험해! ⚠️

단위 테스트 (Unit Tests) 🔬

C#에서는 주로 xUnit, NUnit, MSTest를 사용해. 나는 xUnit을 선호하는데, 현대적이고 깔끔하거든.

xUnit 테스트 예제


using Xunit;

namespace MyAwesomeApi.Tests
{
    public class CalculatorTests
    {
        [Fact]
        public void Add_TwoNumbers_ReturnsSum()
        {
            // Arrange
            var calculator = new Calculator();
            
            // Act
            var result = calculator.Add(2, 3);
            
            // Assert
            Assert.Equal(5, result);
        }
        
        [Theory]
        [InlineData(1, 1, 2)]
        [InlineData(2, 3, 5)]
        [InlineData(-1, 1, 0)]
        public void Add_VariousNumbers_ReturnsCorrectSum(int a, int b, int expected)
        {
            // Arrange
            var calculator = new Calculator();
            
            // Act
            var result = calculator.Add(a, b);
            
            // Assert
            Assert.Equal(expected, result);
        }
    }
}

파이프라인에서 테스트를 실행하고 결과를 발행하면, Azure DevOps에서 테스트 결과를 시각적으로 볼 수 있어. 어떤 테스트가 실패했는지 한눈에 파악할 수 있지! 📊

코드 커버리지 📈

코드 커버리지는 테스트가 얼마나 많은 코드를 실행했는지 측정하는 지표야. 100%가 목표는 아니지만, 중요한 비즈니스 로직은 반드시 테스트해야 해.

- task: DotNetCoreCLI@2
  displayName: 'Run tests with coverage'
  inputs:
    command: 'test'
    projects: '**/*Tests.csproj'
    arguments: '--configuration $(buildConfiguration) --collect:"XPlat Code Coverage" --settings:coverlet.runsettings'
    
- task: PublishCodeCoverageResults@1
  displayName: 'Publish code coverage'
  inputs:
    codeCoverageTool: 'Cobertura'
    summaryFileLocation: '$(Agent.TempDirectory)/**/coverage.cobertura.xml'

coverlet.runsettings 파일로 커버리지 설정을 커스터마이즈할 수 있어:

<?xml version="1.0" encoding="utf-8" ?>
<RunSettings>
  <DataCollectionRunSettings>
    <DataCollectors>
      <DataCollector friendlyName="XPlat code coverage">
        <Configuration>
          <Format>cobertura</Format>
          <Exclude>[*.Tests]*,[*]*.Migrations.*</Exclude>
          <ExcludeByAttribute>Obsolete,GeneratedCode</ExcludeByAttribute>
        </Configuration>
      </DataCollector>
    </DataCollectors>
  </DataCollectionRunSettings>
</RunSettings>

통합 테스트 (Integration Tests) 🔗

통합 테스트는 여러 컴포넌트가 함께 잘 작동하는지 확인해. 데이터베이스, API, 외부 서비스 등과의 통합을 테스트하지.

public class ApiIntegrationTests : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly HttpClient _client;
    
    public ApiIntegrationTests(WebApplicationFactory<Program> factory)
    {
        _client = factory.CreateClient();
    }
    
    [Fact]
    public async Task GetProducts_ReturnsSuccessStatusCode()
    {
        // Act
        var response = await _client.GetAsync("/api/products");
        
        // Assert
        response.EnsureSuccessStatusCode();
        var content = await response.Content.ReadAsStringAsync();
        Assert.NotEmpty(content);
    }
}

통합 테스트는 실행 시간이 오래 걸릴 수 있어. 그래서 별도의 job으로 분리하거나, 특정 브랜치에서만 실행하도록 설정하는 게 좋아. ⏱️

보안과 Best Practices 🔒

CI/CD 파이프라인은 강력한 도구지만, 잘못 설정하면 보안 위험이 될 수 있어. 몇 가지 중요한 보안 원칙을 알아보자!

비밀 정보 관리 🔐

🚨 절대 하지 말아야 할 것들:


• 코드에 비밀번호, API 키 하드코딩 ❌
• YAML 파일에 민감한 정보 직접 입력 ❌
• 로그에 비밀 정보 출력 ❌
• 공개 저장소에 비밀 정보 커밋 ❌

✅ 올바른 방법:


• Azure Key Vault 사용
• Variable Groups에서 변수를 secret으로 설정
• Service Connection 활용
• 환경별로 다른 비밀 정보 사용

Azure Key Vault 통합 🗝️

Azure Key Vault는 비밀 정보를 안전하게 저장하고 관리하는 서비스야. 파이프라인에서 직접 사용할 수 있어.

- task: AzureKeyVault@2
  displayName: 'Get secrets from Key Vault'
  inputs:
    azureSubscription: 'Azure-Connection'
    KeyVaultName: 'myapp-keyvault'
    SecretsFilter: '*'
    RunAsPreJob: true

- script: |
    echo "Using database connection string"
    # $(DatabaseConnectionString) 변수로 사용 가능
  displayName: 'Use secret'
  env:
    DB_CONNECTION: $(DatabaseConnectionString)

최소 권한 원칙 👤

Service Principal이나 Service Connection에는 필요한 최소한의 권한만 부여해야 해. 예를 들어, 배포만 하는 파이프라인이라면 읽기 권한은 필요 없어.

권한 설정 예시:


• 개발 환경: Contributor (읽기/쓰기 가능)
• 스테이징 환경: Contributor (읽기/쓰기 가능)
• 프로덕션 환경: Website Contributor (웹앱 배포만 가능)

Branch Protection 🌿

중요한 브랜치(master, main, production)는 보호해야 해. 직접 푸시를 막고, Pull Request를 통해서만 변경할 수 있게 설정하자.

Branch Policy 설정:


1. Azure Repos → Branches 메뉴로 이동
2. master 브랜치 옆의 "..." 클릭
3. "Branch policies" 선택
4. 다음 옵션들 활성화:
• Require a minimum number of reviewers (최소 리뷰어 수)
• Check for linked work items (작업 항목 연결 확인)
• Check for comment resolution (코멘트 해결 확인)
• Build validation (빌드 검증 - 파이프라인 실행)
5. "Save changes" 클릭!

이제 master 브랜치에 직접 푸시할 수 없어. Pull Request를 만들고, 리뷰를 받고, 빌드가 성공해야만 머지할 수 있지. 안전해! 🛡️

모니터링과 알림 📊

파이프라인을 만들었다고 끝이 아니야. 지속적으로 모니터링하고 문제가 생기면 빠르게 대응해야 해.

파이프라인 분석 📈

Azure DevOps는 파이프라인 실행 통계를 제공해. Analytics 탭에서 다음 정보를 볼 수 있어:

• 성공률: 파이프라인이 얼마나 자주 성공하는가?
• 실행 시간: 평균 실행 시간은? 점점 느려지고 있지 않나?
• 실패 원인: 어떤 stage에서 가장 자주 실패하나?
• 트렌드: 시간에 따른 변화 추이

실행 시간이 계속 늘어난다면 뭔가 문제가 있는 거야. 캐싱을 추가하거나, 불필요한 step을 제거하거나, 병렬 실행을 고려해봐야 해. 🔍

알림 설정 🔔

파이프라인이 실패하면 즉시 알아야 해. Azure DevOps는 다양한 알림 채널을 지원해.

이메일 알림

Project Settings → Notifications에서 설정할 수 있어. 다음과 같은 이벤트에 대해 알림을 받을 수 있어:


• 빌드 실패
• 빌드 성공 (선택사항)
• 배포 실패
• Pull Request 생성/업데이트

Slack/Teams 통합

팀 채팅 도구와 통합하면 더 빠르게 알림을 받을 수 있어. Azure DevOps 앱을 Slack이나 Teams에 설치하면 돼.


# Slack 알림 예제
- task: SlackNotification@1
  condition: failed()
  inputs:
    SlackApiToken: '$(SlackToken)'
    MessageAuthor: 'Azure DevOps'
    Channel: '#deployments'
    Message: '🚨 Build failed! Check the logs.'

실전 시나리오와 문제 해결 🔧

이론은 충분히 배웠으니, 실제로 자주 마주치는 문제들과 해결 방법을 알아보자!

시나리오 1: 빌드는 성공하는데 배포가 실패해요 😰

가능한 원인들:


1. Service Connection 권한 문제
→ Azure Portal에서 Service Principal의 권한 확인
→ 필요한 리소스 그룹에 대한 접근 권한이 있는지 체크


2. 아티팩트 경로 문제
→ $(Pipeline.Workspace)/drop/*.zip 경로가 정확한지 확인
→ 빌드 stage에서 아티팩트가 제대로 발행되었는지 확인


3. Azure Web App 설정 문제
→ 앱 이름이 정확한지 확인
→ 런타임 스택이 맞는지 확인 (.NET 버전 등)

시나리오 2: 파이프라인이 너무 느려요 🐌

최적화 방법들:


1. NuGet 패키지 캐싱

- task: Cache@2
  inputs:
    key: 'nuget | "$(Agent.OS)" | **/packages.lock.json'
    restoreKeys: |
      nuget | "$(Agent.OS)"
    path: $(NUGET_PACKAGES)
  displayName: 'Cache NuGet packages'

2. Docker 레이어 캐싱
Docker를 사용한다면 레이어 캐싱으로 빌드 시간을 크게 줄일 수 있어.


3. 병렬 실행
독립적인 작업들은 병렬로 실행해. 예를 들어, 프론트엔드와 백엔드 빌드를 동시에!


4. 불필요한 step 제거
매번 실행할 필요 없는 작업들은 조건부로 실행하거나 제거해.

시나리오 3: 테스트가 로컬에서는 성공하는데 파이프라인에서는 실패해요 🤔

체크리스트:


1. 환경 변수 차이
→ 로컬과 파이프라인의 환경 변수가 다를 수 있어
→ appsettings.json 설정 확인


2. 시간대 문제
→ 파이프라인 에이전트는 UTC 시간대를 사용해
→ 날짜/시간 관련 테스트는 시간대를 명시적으로 지정


3. 파일 경로 문제
→ Windows와 Linux의 경로 구분자가 달라 (\ vs /)
→ Path.Combine() 사용 권장


4. 데이터베이스 연결
→ 통합 테스트에서 실제 DB를 사용한다면 연결 문자열 확인
→ In-memory DB나 테스트 컨테이너 사용 고려

시나리오 4: 프로덕션 배포 후 롤백하고 싶어요 🔄

롤백 전략:


1. Azure Web App Deployment Slots
배포 슬롯을 사용하면 새 버전을 스테이징 슬롯에 배포하고, 스왑으로 프로덕션에 적용할 수 있어. 문제가 생기면 다시 스왑하면 돼!


- task: AzureAppServiceManage@0
  displayName: 'Swap slots'
  inputs:
    azureSubscription: 'Azure-Connection'
    Action: 'Swap Slots'
    WebAppName: 'myapp-prod'
    ResourceGroupName: 'myapp-rg'
    SourceSlot: 'staging'
    SwapWithProduction: true

2. 이전 아티팩트 재배포
Azure DevOps는 모든 빌드 아티팩트를 보관해. 이전 버전의 아티팩트를 다시 배포하면 돼.


3. Git 태그 활용
각 프로덕션 배포마다 Git 태그를 만들어두면, 특정 버전으로 쉽게 돌아갈 수 있어.

C# 프로젝트 특화 팁 💎

C# 개발자를 위한 특별한 팁들을 공유할게! 🎁

.NET 버전 관리 🔢

프로젝트마다 다른 .NET 버전을 사용할 수 있어. global.json 파일로 버전을 명시하면 일관성을 유지할 수 있어.

{
  "sdk": {
    "version": "8.0.100",
    "rollForward": "latestMinor"
  }
}

파이프라인에서는 이 버전을 자동으로 감지하고 사용해:

- task: UseDotNet@2
  displayName: 'Use .NET SDK from global.json'
  inputs:
    useGlobalJson: true

NuGet 패키지 발행 📦

라이브러리를 개발한다면 NuGet 패키지로 발행할 수 있어. Azure Artifacts를 사용하면 팀 내부에서만 사용하는 프라이빗 패키지도 관리할 수 있지.

- task: DotNetCoreCLI@2
  displayName: 'Pack NuGet package'
  inputs:
    command: 'pack'
    packagesToPack: '**/MyLibrary.csproj'
    versioningScheme: 'byBuildNumber'
    
- task: NuGetCommand@2
  displayName: 'Push to Azure Artifacts'
  inputs:
    command: 'push'
    packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
    nuGetFeedType: 'internal'
    publishVstsFeed: 'myproject/myfeed'

Entity Framework Migrations 🗄️

데이터베이스 마이그레이션을 자동으로 적용하려면 배포 전에 스크립트를 실행해야 해.

- task: DotNetCoreCLI@2
  displayName: 'Generate migration script'
  inputs:
    command: 'custom'
    custom: 'ef'
    arguments: 'migrations script --idempotent --output $(Build.ArtifactStagingDirectory)/migration.sql'
    
- task: SqlAzureDacpacDeployment@1
  displayName: 'Apply migrations'
  inputs:
    azureSubscription: 'Azure-Connection'
    ServerName: 'myserver.database.windows.net'
    DatabaseName: 'mydb'
    SqlUsername: '$(DbUsername)'
    SqlPassword: '$(DbPassword)'
    deployType: 'SqlTask'
    SqlFile: '$(Build.ArtifactStagingDirectory)/migration.sql'

⚠️ 주의: 프로덕션 DB에 자동으로 마이그레이션을 적용하는 건 위험할 수 있어. 중요한 데이터가 있다면 수동 승인 단계를 추가하거나, 백업을 먼저 만드는 게 좋아!

Blazor 앱 배포 🎨

Blazor WebAssembly 앱은 정적 파일로 배포돼. Azure Static Web Apps나 Azure Storage를 사용할 수 있어.

- task: DotNetCoreCLI@2
  displayName: 'Publish Blazor app'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/MyBlazorApp.csproj'
    arguments: '--configuration Release --output $(Build.ArtifactStagingDirectory)'
    
- task: AzureStaticWebApp@0
  displayName: 'Deploy to Azure Static Web Apps'
  inputs:
    app_location: '$(Build.ArtifactStagingDirectory)/wwwroot'
    api_location: ''
    output_location: ''
    azure_static_web_apps_api_token: '$(StaticWebAppToken)'

팀 협업과 DevOps 문화 🤝

기술적인 부분도 중요하지만, DevOps는 결국 문화야. 팀이 함께 성장하는 게 가장 중요해! 🌱

코드 리뷰 문화 👀

Pull Request는 단순히 코드를 머지하는 과정이 아니야. 지식을 공유하고, 코드 품질을 높이고, 함께 배우는 기회지.

좋은 코드 리뷰 습관:


• 비판이 아닌 제안으로 피드백하기
• 작은 PR을 자주 만들기 (큰 PR은 리뷰하기 힘들어)
• 자동화된 체크리스트 사용하기
• 긍정적인 피드백도 잊지 않기 ("이 부분 정말 깔끔하네요!" 👍)

포스트모템 (Postmortem) 📝

배포 실패나 장애가 발생했을 때, 비난하지 말고 배우자. 포스트모템 문서를 작성해서 무엇이 잘못되었고, 어떻게 개선할지 기록해.

포스트모템 템플릿:


1. 무슨 일이 있었나?
사건의 타임라인과 영향 범위


2. 근본 원인은?
5 Whys 기법으로 깊이 파고들기


3. 어떻게 해결했나?
즉각적인 대응과 임시 해결책


4. 재발 방지 계획은?
장기적인 개선 방안과 담당자


5. 배운 점은?
팀이 얻은 교훈

지속적인 학습 📚

DevOps는 계속 진화하고 있어. 새로운 도구와 방법론이 계속 나오니까, 학습을 멈추면 안 돼!

💡 재능넷 같은 플랫폼에서 DevOps 전문가들의 경험을 배우는 것도 좋은 방법이야. 책이나 문서로는 배우기 힘든 실전 노하우를 얻을 수 있거든!

미래의 DevOps 트렌드 🔮

마지막으로 앞으로 주목해야 할 DevOps 트렌드를 살펴보자!

GitOps 🌊

Git을 단일 진실 공급원(Single Source of Truth)으로 사용하는 방법론이야. 인프라 설정, 애플리케이션 구성, 모든 것을 Git으로 관리하고, Git 커밋으로 배포를 트리거해.

AI/ML in DevOps 🤖

AI가 파이프라인을 최적화하고, 장애를 예측하고, 자동으로 문제를 해결하는 시대가 오고 있어. Azure DevOps도 AI 기능을 계속 추가하고 있지.

Platform Engineering 🏗️

개발자들이 쉽게 사용할 수 있는 내부 플랫폼을 만드는 게 트렌드야. "Self-service" 개념으로, 개발자가 직접 인프라를 프로비저닝하고 배포할 수 있게 하는 거지.

FinOps 💰

클라우드 비용을 최적화하는 것도 DevOps의 중요한 부분이 되고 있어. 파이프라인 실행 비용, 리소스 사용량을 모니터링하고 최적화하는 거야.

DevOps의 미래 GitOps Git 중심 AI/ML 자동 최적화 Platform Engineering 핵심 가치 자동화 극대화 개발자 경험 향상 보안 강화 (DevSecOps) 비용 최적화 관찰 가능성 (Observability) 클라우드 네이티브 컨테이너와 Kubernetes 서버리스 아키텍처

마무리하며 🎬

와, 정말 긴 여정이었지? 😅 DevOps와 Azure DevOps를 통한 CI/CD 파이프라인 구축에 대해 많은 걸 배웠어. 처음에는 복잡해 보이지만, 하나씩 차근차근 따라하다 보면 어느새 자동화의 마법사가 되어 있을 거야! 🧙‍♂️

🎯 핵심 요약


1. DevOps는 문화다
도구와 기술도 중요하지만, 협업과 지속적 개선의 마인드셋이 더 중요해.


2. CI/CD는 필수다
수동 배포는 이제 옛날 이야기. 자동화로 시간을 절약하고 실수를 줄이자.


3. Azure DevOps는 강력하다
특히 C# 개발자라면 Visual Studio와의 완벽한 통합으로 생산성이 크게 향상돼.


4. 보안을 잊지 말자
편리함도 중요하지만, 보안은 타협할 수 없어. 비밀 정보 관리, 권한 설정에 신경 쓰자.


5. 지속적으로 개선하자
파이프라인은 한 번 만들고 끝이 아니야. 계속 모니터링하고 최적화해야 해.

🚀 다음 단계:


1. 간단한 프로젝트로 시작해보기
2. 기본 CI 파이프라인 만들어보기
3. 테스트 추가하기
4. CD 파이프라인으로 확장하기
5. 팀과 함께 개선해나가기


혼자 하기 어렵다면 재능넷에서 멘토를 찾아보는 것도 좋은 방법이야. 경험 많은 전문가의 도움을 받으면 훨씬 빠르게 성장할 수 있어! 💪

DevOps 여정은 마라톤이야. 단거리 달리기가 아니지. 천천히, 꾸준히, 함께 나아가자. 실패를 두려워하지 말고, 실패에서 배우자. 그게 바로 DevOps의 정신이니까! 🎉

자, 이제 당신의 첫 번째 파이프라인을 만들어볼 시간이야. 화이팅! 🔥

Happy DevOps-ing! 🚀

지속적 통합, 지속적 배포, 지속적 개선!

댓글 작성

이 글에 대한 여러분의 생각을 들려주세요

댓글 0
댓글을 불러오는 중입니다.

아직 댓글이 없습니다.