CICD in WindowServer

[SAgiKPJH]

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

• ** git config --system core.longpaths true 설정을 통해 윈도우 API의 파일 경로 길이 260자 제한 해제

[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 "shell" \
  --shell "pwsh"  \
  --tag-list "sampletags, windows" \
  --description "windowlocalrunner"

• 내용 기입 방법은 다음을 따릅니다.
  
  
• URL은 해당 내용에서 제공하는 URL을 사용합니다.
• token은 해당 내용에서 제공하는 registration token을 입력합니다.
  • 이때, Shared runners는 비활성화합니다. (가만히 냅둡니다)
• description는 Runner 이름을 입력합니다. (예 - TestRunner)
• 등록 완료되면 다음과 같이 등록이 됩니다.
  
  
• 생성된 파일 config.toml은 다음과 같이 나타납니다.

  
  concurrent = 1
  check_interval = 0
  connection_max_age = "15m0s"
  shutdown_timeout = 0

[session_server] session_timeout = 1800

[[runners]] name = "Test" url = "~(URL)~" id = 241 token = "~~~~" token_obtained_at = 2024-03-13T01:48:17Z token_expires_at = 0001-01-01T00:00:00Z executor = "shell" shell = "powershell" [runners.cache] MaxUploadedArchiveSize = 0

<br>

### 4. GitLab Start

- 동작 이전 상태  
  ![image](https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/assets/66783849/d9053c46-428b-45a5-aa9b-b0e025a155d9)  
- gitlab-runner 상태 확인
```powershell
> .\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/13446cff-602d-4b8c-a83c-00a09b829ab2)  
  ![image](https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/assets/66783849/2be1d61f-0e23-4f26-9317-b1e23064686b)  
  ![image](https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/assets/66783849/d160e851-dd16-4dae-bc5b-a30bd0b31f82)

[SAgiKPJH]

dotnet sdk version 지정

• dotnet build시 sdk 버전을 지정해줍니다.
• https://github.com/SagiK-Repository/Learn-Git-Lab-CICD/issues/12

  dotnet new globaljson --sdk-version 7.0.000 --force

[SAgiKPJH]

처음부터 실행

0. gitlab-runner 설치

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

1. gitlab-runner.exe 옮기기

2. Runner 생성

3. gitlab-runner register

gitlab-runner.exe register\
--non-interactive \
--url "https://gitlab.com/" \
--registration-token "$RUNNER_TOKEN" \
--executor "shell" \
--shell "pwsh"  \
--tag-list "sampletags, windows" \
--description "windowlocalrunner"

4. 실행

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

pwsh

• pwsh가 없으면, 설치합니다.
• https://learn.microsoft.com/ko-kr/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.4#winget
• 설치 후 uninstall restart 합니다.

git 설치

• https://git-scm.com/download/win
• 설치 후 다시시작 합니다.

dotnet 설치

• https://dotnet.microsoft.com/ko-kr/download/dotnet/thank-you/sdk-8.0.303-windows-x64-installer
• https://dotnet.microsoft.com/ko-kr/download/dotnet/thank-you/sdk-7.0.410-windows-x64-installer
• https://dotnet.microsoft.com/ko-kr/download/dotnet-framework/thank-you/net472-developer-pack-offline-installer
• https://dotnet.microsoft.com/ko-kr/download/dotnet/thank-you/sdk-5.0.408-windows-x64-installer
• 설치 후 다시시작 합니다.

Devexpress 설치

• https://www.devexpress.com/ClientCenter/DownloadManager/
• dotnet 패키지 관리자 추가
  • dotnet nuget add source "C:\Program Files\DevExpress 23.2\Components\System\Components\Packages" -n "DevExpress 23.2 Local"