CICD in Docker WindowServer

[SAgiKPJH]

• CICD를 Docker Windowserver에서 구성합니다.

전제조건

• 만일 dotnet 프로젝트에서 window에서만 호환되는 내용이 있을 경우 (예 Winform, WPF) 다음을 주의합니다.
• docker-linux와 docker-window가 있습니다.
• window에서만 호환되는 내용일 경우, docker-window를 사용해야 합니다.

[SAgiKPJH]

테스트를 위한 docker 이미지 조사

• https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/issues/9

[SAgiKPJH]

Docker-Linux

• docker-linux를 쓴다면, 별도의 작업을 하지 않아도 됩니다.

Docker-Window

• Docker Desktop에서 Linux -> Window 변경합니다.
  
  
  

[SAgiKPJH]

GitLab CI/CD 환경 구축

• 참조 : https://velog.io/@leesomyoung/CICD%EB%A5%BC-%EC%9C%84%ED%95%9C-gitlab-pipeline-%EA%B5%AC%EC%B6%95%ED%95%98%EA%B8%B0
• CI/CD 구축 방법은 크게 2가지가 있습니다.
  • (1) SSH 연결
  • (2) GitLab Runner 활용

GitLab Runner 활용

• Window GitLab Runner : https://docs.gitlab.com/runner/install/windows.html

1. 원하는 window 환경을 준비합니다.

2. GitLab Runner 설치 합니다.

• 이름을 gitlab-runner.exe로 변경하고 폴더 위치를 C:\GitLab-Runner에 지정합니다.
• 또한 해당 폴더와 exe파일에 쓰기권한 할당합니다. (보통 되어 있습니다.)

3. GitLab Register

• https://docs.gitlab.com/runner/register/index.html?tab=Windows
• Window의 경우 다음과 같이 Register 시도합니다.

  C:\GitLab-Runner\gitlab-runner.exe register\
  --non-interactive \
  --url "https://gitlab.com/" \
  --registration-token "$RUNNER_TOKEN" \
  --executor "docker-windows" \
  --tag-list "sampletags, windows" \
  --docker-image bitnami/dotnet-sdk:6.0.420 \
  --description "docker-runner"

  • 만일 docker가 아닌 docker-window를 사용한다면, --executor "docker-windows"로 설정합니다.
  • 예시로 --docker-image mcr.microsoft.com/windows/servercore:1809_amd64 가 있습니다.
• 내용 기입 방법은 다음을 따릅니다.
  
  
• URL은 해당 내용에서 제공하는 URL을 사용합니다.
• token은 해당 내용에서 제공하는 registration token을 입력합니다.
  • 이때, Shared runners는 비활성화합니다. (가만히 냅둡니다)
• description는 Runner 이름을 입력합니다. (예 - TestRunner)
• 등록 완료되면 다음과 같이 등록이 됩니다.
  
  
• 생성된 파일 config.toml은 다음과 같이 나타납니다.

  [[runners]]
  name = "PJH-Docker"
  url = "~~~~URL~~~~"
  id = 278
  token = "~~~token~~~"
  token_obtained_at = 2024-03-14T06:23:12Z
  token_expires_at = 0001-01-01T00:00:00Z
  executor = "docker-windows"
  shell = "pwsh"
  [runners.cache]
  MaxUploadedArchiveSize = 0
  [runners.docker]
  tls_verify = false
  image = "mcr.microsoft.com/dotnet/sdk:6.0"
  privileged = false
  disable_entrypoint_overwrite = false
  oom_kill_disable = false
  disable_cache = false
  volumes = ["c:\\cache"]
  shm_size = 0
  network_mtu = 0

4. GitLab Start

• 동작 이전 상태
  
• gitlab-runner 상태 확인

  > .\gitlab-runner.exe status
  Runtime platform                                    arch=amd64 os=windows pid=11836 revision=782c6ecb version=16.9.1
  gitlab-runner: the service is not installed

• gitlab-runner 관리자 권한으로 install

  > ./gitlab-runner.exe install
  Runtime platform                                    arch=amd64 os=windows pid=19044 revision=782c6ecb version=16.9.1

• gitlab-runner Install 후 상태 확인

  > ./gitlab-runner.exe status
  Runtime platform                                    arch=amd64 os=windows pid=13224 revision=782c6ecb version=16.9.1
  gitlab-runner: Service has stopped

• gitlab-runner 정보 확인

  > .\gitlab-runner.exe list
  Runtime platform                                    arch=amd64 os=windows pid=9616 revision=782c6ecb version=16.9.1
  Created missing unique system ID                    system_id=s_6429108e4109
  Listing configured runners                          ConfigFile=C:\GitLab-Runner\config.toml

• gitlab-runner 시작

  > ./gitlab-runner.exe start gitlab-runner
  Runtime platform                                    arch=amd64 os=windows pid=26136 revision=782c6ecb version=16.9.1

• gitlab-runner 시작 후 상태 확인

  > ./gitlab-runner.exe status
  Runtime platform                                    arch=amd64 os=windows pid=28320 revision=782c6ecb version=16.9.1
  gitlab-runner: Service is running

  

• 동작 이후 상태
  
• 만일 초록색 원이 나타나지 않으면, 다시한번 Runner를 Regist합니다.

[SAgiKPJH]

빌드 테스트 (Test 코드 포함)

• GitLab .gitlab-ci.yml파일 설정합니다.
  • 참조 : https://velog.io/@minji104/.gitlab-ci.yml-%EC%9E%91%EC%84%B1
• GitLab > Settings > CI/CD의 General
  
• 레파지토리에 바로 구성해도 좋습니다.
• ID나 Password 등 보안에 민감한 변수는 GitLab의 Settings > CI/CD 의 Variables에서 세팅해서 사용합니다.
  
• 해당하는 브랜치에 .gitlab-ci.yml 작성합니다.

  
  stages:
  - build

build: stage: build tags:

• adc60 variables: SOLUTION_PATH: ./Src/ADC/Mirero.ADC.App.sln TEST_PROJECT_PATH: ./Src/ADC/Tests/Client.Business.UnitTest/Client.Business.UnitTest.csproj script:
• dotnet restore $SOLUTION_PATH
• dotnet build $SOLUTION_PATH --configuration Release

test: stage: build image: mcr.microsoft.com/dotnet/sdk:5.0-windowsservercore-ltsc2019 variables: TEST_PROJECT_PATH: ./Src/ADC/Tests/Client.Business.UnitTest/Client.Business.UnitTest.csproj script:

• dotnet test $TEST_PROJECT_PATH --configuration Release

  
  - 이후 Commit하여 Build가 되는지 확인합니다.  
  ![image](https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/assets/66783849/fb2c6f3b-8100-4460-a996-c08d3516369c)
  - Docker에는 다음과 같이 나타납니다.  
  ![image](https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/assets/66783849/140b1c06-d3fb-4171-bce9-5a46c28b6cc2)  
  ![image](https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/assets/66783849/8337feff-9cae-4474-9242-2b0b3556d657)  
  ![image](https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/assets/66783849/d13ebfc9-c0d6-42ea-8898-ed2986db39f1)  
  ![image](https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/assets/66783849/5c728d10-0e69-44a3-830f-c629cb555c12)