Skip to content

Latest commit

 

History

History
180 lines (142 loc) · 8.92 KB

README.md

File metadata and controls

180 lines (142 loc) · 8.92 KB

.NET Web API 앱 Rock 만들기

실습 1.1

이 디렉토리에서 rockcraft.yaml을 생성하세요.

rockcraft init

생성된 rockcraft.yaml 을 열고, 아래 값을 우선 수정 합니다.

  • name: weather-webapi 로 수정
  • base: ubuntu@24.04 로 수정
  • version: 0.1로 지정
  • summary: 컨테이너 이미지에 대한 간략한 설명으로 교체
  • description: 컨테이너 이미지에 대한 자세한 설명으로 교체

빌드 과정을 정의 해 보겠습니다. parts 에서 빌드 과정을 정의 합니다. my-part 를 weather-webapi로 바꾸고 하위 속성을 아래와 같이 추가하여 빌드 과정을 정의 합니다.

  • source-type: 빌드에 사용할 소스 유형을 지정합니다. local 로 지정해 주세요.
  • source: 소스 위치 지정. 현재 디렉토리로 지정하기 위해 . 으로 입력합니다.
  • build-environment: 빌드 단계에서 사용할 환경변수 입니다. PATH 환경변수 지정을 위해 배열 항목으로 PATH: "/usr/bin:${PATH}"를 넣어줍니다.
  • build-packages: 빌드 환경에서 필요한 우분투 패키지 입니다. .NET 빌드에 필요한 패키지인 dotnet-sdk-8.0를 배열 항목으로 넣어줍니다.
  • stage-packages: 완성된 컨테이너에 포함되어 앱 실행시 필요한 우분투 패키지 입니다. .NET 런타임 패키지인 aspnetcore-runtime-8.0를 배열 항목으로 넣어줍니다.
  • override-build: 빌드 과정에서 실행할 명령어를 재정의 합니다. 아래와 같이 수정합니다.
override-build: |
    craftctl default
    dotnet restore
    dotnet build 
    dotnet publish -c Release -o ${CRAFT_PART_INSTALL}/

plarform 및 parts 사이에 아래 내용을 추가하여 컨테이너 환경변수와 내부에서 실행할 서비스 구성을 정의 합니다. 여기서 정의한 services 의 경우 추후 컨테이너 내부에서 pebble 에 의해 실행 됩니다.

environment:
    ASPNETCORE_URLS: http://0.0.0.0:8080

services:
    weather-webapi:
        override: replace
        startup: enabled
        command: dotnet rockcraft-workshop.dll

Rock 을 빌드 해 보겠습니다. 아래 명령을 실행합니다.

rockcraft pack

빌드된 *.rock 파일을 Docker 에 이미지로 불러옵니다.

sudo rockcraft.skopeo --insecure-policy copy oci-archive:weather-webapi_0.1_amd64.rock docker-daemon:weather-webapi:0.1

컨테이너를 로컬에서 실행하고, http://localhost:8080/weatherforecast 에 접속하여 잘 작동하는지 확인 해 봅니다.

sudo docker run -p 8080:8080 weather-webapi:0.1

JSON 데이터가 잘 반환 된다면, 빌드한 Rock이 잘 작동하는 것 입니다. rockcraft.yaml 작성이 어렵다면, 완성된 예제 파일인 rockcraft-solution-1.1.yaml을 확인 해 보시기 바랍니다.

실습 1.2

앞서 생성한 rockcraft.yaml 파일은 임의로 이름을 수정(예: rockcraft-ex-1.1.yaml)하여 백업하고, 새로운 rockcraft.yaml을 생성하세요.

rockcraft init

생성된 rockcraft.yaml 을 열고, 아래 값을 우선 수정 합니다.

  • name: weather-webapi 로 수정
  • base: bare 로 수정: 컨테이너 이미지 베이스로 아무것도 없는 시스템을 사용 합니다.
  • build-base: ubuntu@24.04 로 지정하여, 빌드 시 Ubuntu 24.04 LTS 환경에서 수행 하도록 지정 합니다.
  • version: 0.2로 지정
  • summary: 컨테이너 이미지에 대한 간략한 설명으로 교체
  • description: 컨테이너 이미지에 대한 자세한 설명으로 교체

빌드 과정을 정의 해 보겠습니다. parts 에서 빌드 과정을 정의 합니다. my-part 를 weather-webapi로 바꾸고 하위 속성을 아래와 같이 추가하여 빌드 과정을 정의 합니다.

  • plugin: dotnet 플러그인을 사용하도록 지정합니다. 이 플러그인을 지정하여, 플러그인에서 .NET 앱 빌드에 필요한 구성을 자동으로 포함 시키도록 할 수 있습니다.
  • source-type: 빌드에 사용할 소스 유형을 지정합니다. local 로 지정해 주세요.
  • source: 소스 위치 지정. 현재 디렉토리로 지정하기 위해 . 으로 입력합니다.
  • dotnet-build-configuration: Release로 설정하여, .NET 앱 빌드 시 Release 구성으로 빌드 되도록 지정 합니다.
  • build-environment: 빌드 단계에서 사용할 환경변수 입니다. PATH 환경변수 지정을 위해 배열 항목으로 PATH: "/usr/bin:${PATH}"를 넣어줍니다.
  • build-packages: 빌드 환경에서 필요한 우분투 패키지 입니다. .NET 빌드에 필요한 패키지인 dotnet-sdk-8.0를 배열 항목으로 넣어줍니다.

이번에 stage-package는 Rockcraft에 통합된 Chisel 기능으로 패키지의 필요한 파일만 포함되도록 지정 해 보겠습니다. 명령줄로 아래 명령을 실행하여 패키지의 Chisel Slice 정보를 확인 합니다.

chisel info aspnetcore-runtime-8.0

아래와 같이 Chisel Slice 정보가 조회 됩니다.

2024/11/06 14:39:23 Consulting release repository...
2024/11/06 14:39:23 Cached ubuntu-24.04 release is still up-to-date.
2024/11/06 14:39:23 Processing ubuntu-24.04 release...
package: aspnetcore-runtime-8.0
archive: ubuntu
slices:
    copyright:
        contents:
            /usr/share/doc/aspnetcore-runtime-8.0/copyright: {}
    libs:
        essential:
            - aspnetcore-runtime-8.0_copyright
            - dotnet-runtime-8.0_libs
        contents:
            /usr/lib/dotnet/shared/Microsoft.AspNetCore.App/8.0*/**: {}

우리는 libs Slice에 해당하는 부분만 필요합니다. 이런 경우, stage-package 넣을 패키지 이름 끝에 _(Slice 이름)을 붙여 지정이 가능합니다. aspnetcore-runtime-8.0 패키지의 libs Slice만 필요하므로, stage-package 에 aspnetcore-runtime-8.0_libs를 넣어 줍니다.

앞선 실습에서 설정한 것과 동일하게, plarform 및 parts 사이에 아래 내용을 추가하여 컨테이너 환경변수와 내부에서 실행할 서비스 구성을 정의 합니다. 여기서 정의한 services 의 경우 추후 컨테이너 내부에서 pebble 에 의해 실행 됩니다.

environment:
    ASPNETCORE_URLS: http://0.0.0.0:8080

services:
    weather-webapi:
        override: replace
        startup: enabled
        command: dotnet rockcraft-workshop.dll

Rock 을 빌드 해 보겠습니다. 아래 명령을 실행합니다.

rockcraft pack

빌드된 *.rock 파일을 Docker 에 이미지로 불러옵니다.

sudo rockcraft.skopeo --insecure-policy copy oci-archive:weather-webapi_0.2_amd64.rock docker-daemon:weather-webapi:0.2

컨테이너를 로컬에서 실행하고, http://localhost:8080/weatherforecast 에 접속하여 잘 작동하는지 확인 해 봅니다.

sudo docker run -p 8080:8080 weather-webapi:0.2

JSON 데이터가 잘 반환 된다면, 빌드한 Rock이 잘 작동하는 것 입니다. rockcraft.yaml 작성이 어렵다면, 완성된 예제 파일인 rockcraft-solution-1.2.yaml을 확인 해 보시기 바랍니다.

두 컨테이너 비교하기

컨테이너 이미지 크기와 이미지에 포함된 파일 구성을 비교 해 보겠습니다.

먼저 docker images 명령으로, 이미지 크기를 비교 해 봅니다. 0.1이 실습 1.1에서 플러그인 및 Chisel 사용 없이 빌드 한 것, 0.2가 실습 1.2 에서 플러그인과 Chisel 및 bare base 사용하여 빌드한 것 입니다.

$ sudo docker images
REPOSITORY       TAG       IMAGE ID       CREATED          SIZE
weather-webapi   0.2       8c867c7046dd   54 minutes ago   157MB
weather-webapi   0.1       eb75f2ffdcc9   2 weeks ago      222MB

컨테이너 이미지에 포함된 파일을 비고 해 보겠습니다. 이미지에서 실행한 컨테이너 목록을 조회하고, 각 컨테이너를 tar 파일로 내보내기한 후 비교 해 봅니다.

먼저 docker ps -a로 컨테이너를 조회하고, docker export <컨테이너 이름> > <원하는 파일명>.tar 로 내보내기 합니다.

$ sudo docker ps -a
CONTAINER ID   IMAGE                COMMAND                  CREATED             STATUS                         PORTS     NAMES
3913939e3e8c   weather-webapi:0.2   "/usr/bin/pebble ent…"   48 minutes ago      Exited (0) 42 minutes ago                gifted_williams
b9f7d3b048e1   weather-webapi:0.1   "/usr/bin/pebble ent…"   25 hours ago        Exited (0) 22 hours ago                  jolly_satoshi
...
sudo docker export gifted_williams >  weather-webapi-0.2.tar
sudo docker export jolly_satoshi > weather-webapi-0.1.tar

아래 명령으로 tar파일 내부 파일 목록을 확인 합니다.

tar -tvf weather-webapi-0.2.tar
tar -tvf weather-webapi-0.1.tar