LuckyGg

[레드마인 플러그인] Redmine CKEditor pastebase64 (with Redmine 4.2.9)

Fri, 5 Sep 2025 23:14:37 +0900

소개

CKEditor의 pastebase 플러그인은 사용자가 클립보드에 복사한 이미지를 CKEditor 본문에 붙여 넣을 수 있도록 지원하는 플러그인입니다. CKEditor에서는 그림 첨부 형태로 이미지를 넣을 수 있는데요. PasteBase 플러그인을 설치하면 ctrl+v로 쉽게 이미지를 첨부할 수 있습니다.

설치 따라 하기

1. 플러그인 파일 다운로드하기

아래 링크에서 파일을 다운로드 하거나, 첨부된 파일을 사용합니다.

https://ckeditor.com/cke4/addon/pastebase64

pastebase64_1.0.zip

0.00MB

2. 파일 복사하기

Redmine Plugin 경로를 매핑했다면, 아래와 같이 업로드합니다.

redmine/plugins/redmine_ckeditor/assets/ckeditor-contrib/plugins

매핑된 경로에 복사하기

3. config.js 수정하기

아래와 같이 config.js 파일을 수정합니다.

redmine/plugins/redmine_ckeditor/assets/ckeditor/config.js

config.extraPlugins = 'pastebase64,base64image';

config.js 수정하기

4. init.rb 수정하기

아래와 같이 init.rb 파일을 수정합니다.

redmine/plugins/redmine_ckeditor

Loofah::HTML5::WhiteList::ALLOWED_PROTOCOLS.add('data')

init.rb 수정하기

5. 레드마인 재시작

따로 설치 명령어 없이 레드마인을 재시작하면 적용됩니다.

[레드마인 플러그인] Redmine CKEditor Codesnippet (with Redmine 4.2.9)

Fri, 29 Aug 2025 23:01:56 +0900

소개

CKEditor의 Codesnippet 플러그인은 에디터에 작성한 코드 블록을 보기 좋게 표시해 주는 플러그인으로, 다양한 프로그래밍 언어의 문법 하이라이팅을 지원합니다. 별거 아닐 수도 있지만, 단순한 텍스트 형식의 코드가 아닌, 가독성이 높고 구조적으로 구분된 코드로 보여줄 수 있어 읽는 사람으로 하여금 전문성과 편의성을 제공할 수 있습니다.

codesnippet 적용 모습

설치 따라 하기

주의

CKEditor 공식 홈페이지에서 제공하는 codesnippet 플러그인 파일을 사용하면 오류가 발생합니다. 본문에 첨부된 파일을 사용하면 설치 및 사용에 문제는 없습니다.

1. 플러그인 파일 다운로드하기

적어도 아래의 파일은 Redmine 4.2.9와 CKEditor 1.2.3 버전에서 문제가 없습니다.

2. 파일 복사하기

Redmine Plugin 경로를 매핑했다면, 아래와 같이 업로드합니다.

redmine\plugins\redmine_ckeditor\assets\ckeditor-contrib\plugins

매핑된 경로에 복사하기

3. config.js 수정하기

아래와 같이 config.js 파일을 수정합니다.

redmine/plugins/redmine_ckeditor/assets/ckeditor/config.js

config.extraPlugins = 'widgetselection';
config.extraPlugins = 'lineutils';
config.extraPlugins = 'widget';
config.extraPlugins = 'codesnippet';

config.js 수정하기

4. 레드마인 재시작

따로 설치 명령어 없이 레드마인을 재시작하면 적용됩니다.

[레드마인 플러그인] Redmine CKEditor (with Redmine 4.2.9)

Sat, 23 Aug 2025 21:42:51 +0900

소개

CKEditor는 글을 작성할 때 글자의 폰트, 색상, 스타일, 정렬, 그림 첨부, 코드 스니핏 등의 기능을 제공하는 에디터 툴이라고 생각하시면 됩니다. 레드마인은 기본적으로 마크다운을 제공하지만, 더 풍부한 기능을 사용하기 위해서는 CKEditor를 별도로 설치해야 합니다.

CKEditor 편집 화면

설치 따라 하기

1. 저장소에서 최신 버전 다운로드하기

git clone -b 1.2.3 https://github.com/a-ono/redmine_ckeditor

2. 파일 복사하기

Redmine Plugin 경로를 매핑했다면, 아래와 같이 업로드합니다.

Plugin 경로에 파일 업로드하기

만약, 매핑을 안 했다면 직접 다운로드한 파일을 Redmine plugin 경로로 복사해야 하는 번거로움이 있습니다. 차라리 셋업 과정에서 매핑을 해놓고 시작하는 게 좋습니다. 매핑 관련해서는 아래 게시물을 참고하세요.

[Container Manager] MariaDB와 레드마인 구축하는 방법, 쉽게 따라하기

이제 Docker 대신 Container Manager 시놀로지 패키지 센터에서는 도커(Docker)와 레드마인(Redmine) 패키지를 제공하는데요. 이 패키지 설치를 통해 쉽고 편하게 레드마인을 구축할 수 있습니다. 하지만

luckygg.tistory.com

3. Redmine Plugin 경로에 파일 확인 후 설치하기

아래 명령어로 플러그인 경로에 접근합니다.

cd /home/redmine/redmine/plugins/

그리고 아래 명령어로 파일 목록을 조회합니다.

ls -l

정상적으로 파일을 복사했다면 Redmine Plugin 경로에 아래와 같이 redmine_ckeditor 폴더가 있어야 합니다.

플러그인 경로에 복사한 플러그인 확인하기

설치를 위해 다시 레드마인 루트 경로로 이동합니다.

cd /home/redmine/redmine

아래 명령어를 실행합니다.

bundle install --without development test

bundle exec rails redmine:plugins:migrate RAILS_ENV=production

설치에 문제가 없었다면 레드마인을 재시작합니다.

만약, 위 설치 과정에서 여러 오류가 발생한다면, 아래 '오류에 따른 조치 방법'을 참고하세요. 그리고 다시 위의 설치 명령어를 입력하여 재시도하시기 바랍니다.

참고로, 아래 조치 사항은 여러 시도 끝에 해결된 방법입니다. 불필요한 명령어가 있거나 순서가 틀릴 수 있지만, 제 상황에서는 문제가 해결되었습니다.

※ 오류에 따른 조치 방법

mysql2 오류

mysql2 에러

위 이미지처럼, mysql2 오류가 있다면 아래의 순서대로 진행해 보세요.

sudo apt-get install -y build-essential libmysqlclient-dev

만약, 위 명령어를 실행해도 오류가 있다면 아래 명령어를 실행하세요.

sudo apt-get update

sudo apt-get install -y default-libmysqlclient-dev

이후 아래의 명령어를 실행하세요.

gem install mysql2 -v '0.5.6'

마지막으로 아래의 명령어를 실행합니다.

bundle install

ruby 2.7.0 오류

위 이미지처럼, ruby 2.7.0 오류가 있다면 아래의 순서대로 진행해 보세요.

bundle install --no-deployment

만약, sqlite3 에러가 발생한다면 아래 명령어를 실행하세요.

sqlite3 오류

sudo apt-get update

sudo apt-get install -y sqlite3 libsqlite3-dev

그리고 아래의 명령어를 실행합니다.

gem install sqlite3 -v '1.4.4'

마지막으로 아래의 명령어를 실행합니다.

bundle install

pg 오류

위 이미지처럼, pg 오류가 있다면 아래의 순서대로 진행해 보세요.

sudo apt-get update

sudo apt-get install -y postgresql postgresql-contrib libpq-dev

그리고 아래의 명령어를 실행합니다.

gem install pg -v '1.2.3'

마지막으로 아래의 명령어를 실행합니다.

bundle install

4. rich_files 연동하기

CKEditor에서 이미지를 업로드하면 rich_files 폴더에 이미지가 보관됩니다. 혹시 이미 보유하고 있는 rich_files가 있다면, 아래의 경로에 복사합니다.

/home/redmine/redmine/public/system/rich/rich_files/rich_files

또는 아래와 같이 레드마인 컨테이너 설정에서 폴더를 매핑하여 file station에서 옮기는 것도 가능합니다.

rich_files 경로 매핑하기

5. CKEditor 활성화하기

이제 모든 설치가 완료되었으니, 레드마인의 본문 형식을 CKEditor로 변경하여 저장합니다.

레드마인 본문 형식을 변경하는 방법

[레드마인 플러그인] Redmine Issue Template (with Redmine 4.2.9)

Sun, 15 Jun 2025 16:56:06 +0900

소개

이슈 템플릿(Issue Template)은 새로운 일감을 작성할 때 미리 작성된 양식을 제공하는 플러그인입니다. 아무래도 다양한 사용자가 이슈를 작성하면 자기만의 취향대로 작성하기 마련인데요. 적어도 어떤 구성으로 작성해야 하는지 가이드를 주는 기능이라고 생각하시면 되겠습니다.

템플릿 작성 예시

위 그림은 '테스트' 유형의 일감에 맞는 '테스트' 템플릿 양식입니다. 본문에 글자 크기, 모양, 색상, 그림 등 모든 속성을 지정할 수 있습니다.

템플릿 사용 예시

일감 생성 화면에서 '유형'을 선택하면 '일감 템플릿'에 템플릿 목록이 표시됩니다. 템플릿을 선택하면 에디터 본문에 미리 정의한 양식이 반영되기 때문에, 작성자는 이 틀에 맞춰 글을 작성하면 됩니다.

참고로, 해당 플러그인은 2021년 1월 23일에 보관 처리되어 더 이상 업데이트 되지 않습니다.

설치 따라 하기

1. 저장소에서 최신 버전 다운로드하기

git clone -b 1.1.0 https://github.com/akiko-pusu/redmine_issue_templates/

주의

저는 저장소의 최신 버전인 1.1.0을 그대로 사용하면 설치 과정 중 오류가 발생했습니다. 그래서 오류가 발생하지 않도록 init.rb 파일을 수정했고, 정상적으로 설치되었습니다. 아래에 수정된 init.rb 파일을 첨부했습니다.

redmine_issue_templates (init.rb 수정본).zip

0.20MB

저장소에서 다운로드하면 3번 과정으로, 위의 첨부된 파일을 다운로드하면 2번 과정으로 진행합니다.

2. 파일 복사하기

Redmine Plugin 경로를 매핑했다면, 아래와 같이 업로드합니다.

Plugin 경로에 파일 업로드하기

[Container Manager] MariaDB와 레드마인 구축하는 방법, 쉽게 따라 하기

[Container Manager] MariaDB와 레드마인 구축하는 방법, 쉽게 따라하기

luckygg.tistory.com

3. Redmine Plugin 경로에 파일 확인 후 설치하기

아래 명령어로 플러그인 경로에 접근합니다.

cd /home/redmine/redmine/plugins/

그리고 아래 명령어로 파일 목록을 조회합니다.

ls -l

정상적으로 파일을 복사했다면 Redmine Plugin 경로에 아래와 같이 redmine_issue_templates 폴더가 있어야 합니다.

플러그인 경로에 복사한 플러그인 확인하기

설치를 위해 다시 레드마인 루트 경로로 이동합니다.

cd /home/redmine/redmine

아래 명령어를 실행합니다.

bundle exec rails redmine:plugins:migrate RAILS_ENV=production

만약, 위 명령어 실행 후 오류가 발생하거나, 위 명령어 실행 후 오류는 없지만 레드마인 재시작 후 오류가 발생하면 추가로 아래의 명령어를 실행합니다. 아니면, 처음부터 아래의 명령어를 실행해도 상관은 없을 듯합니다.

bundle exec rake db:migrate RAILS_ENV=production

4. 설치 완료 후 레드마인 서버 재시작하기

설치가 완료되면 아래와 같은 출력이 표시됩니다.

설치가 완료된 모습

문제가 없다면 레드마인 서버를 재시작합니다. 그리고 관리자 계정으로 '관리 > 플러그인' 메뉴를 클릭하면 아래와 같이 표시되면 정상적으로 설치가 완료된 것입니다.

플러그인이 정상적으로 설치된 모습

[AI] OpenAI API를 사용하기 위한 기초 가이드 (노코딩 테스트 포함)

Sat, 22 Mar 2025 17:04:36 +0900

OpenAI API란?

이제는 생성형 인공 지능 서비스인 ChatGPT를 모르시는 분들이 거의 없을 텐데요. OpenAI의 ChatGPT 사이트에서 채팅하는 방법 뿐만 아니라, OpenAI에서 제공하는 GPT 모델을 API로 호출하여 사용하는 방법도 있습니다. 이 방식은 무료는 아니지만 직접 모델을 구축하는 것에 비해 훨씬 효율적입니다.

참고로, OpenAI API는 유료 서비스인 ChatGPT Plus 구독과는 다른 것입니다. GPT Plus는 월 결제 방식으로, 새로운 GPT 모델과 빠른 응답속도, 더 긴 대화를 할 수 있는 장점이 있는데요. API는 말 그대로 프로그래밍을 통해 메시지를 서버로 보내면 응답을 받는 형태로, 다양한 애플리케이션 구현이 가능해집니다.

OpenAI API에서 제공하는 기능

API는 다양한 기능을 제공하며, 개발자가 알맞은 기능을 선택하여 다양한 애플리케이션 구현이 가능합니다. 간단하게 정리하면 다음과 같습니다.

Text Generation(텍스트 생성): 사용자의 질문에 자연스러운 답변을 생성하는 기능으로, 일반적으로 사용하는 ChatGPT의 채팅 기능.
Image Generation(이미지 생성): 사용자의 프롬프트에 따라 이미지를 생성하는 기능.
Vision: 사용자의 이미지를 이해하고 분석하는 기능.
Vector Embbeddings: 사용자의 데이터를 벡터 공간으로 변환하여 수치화하고, 수치의 유사성으로 결과를 활용하는 기능.
TTS(Text To Speech): 텍스트를 음성으로 변환하는 기능.
STT(Speech To Text): 음성을 텍스트로 변환하는 기능.
Moderation: 텍스트에 유해하거나 부적절한 내용이 있는지 판단하는 기능.
Reasoning: 복잡한 문제에 대해 더 정확하고 깊이있는 대답을 생성하는 기능.

서론이 많이 길었습니다. 이제 본문에서는 Text Generation을 기준으로 API 준비 과정과 노코딩 테스트 방법 소개하겠습니다.

따라하기

1. API Key 발급 받기

아래 사이트에 접속하여 회원가입 및 로그인을 합니다.

https://platform.openai.com/

그리고 Settings > API Keys 또는 Dashboard > API Keys 메뉴를 눌러 API Keys 페이지로 이동합니다.

API Keys 화면

우측 상단의 Create new secret key 버튼을 클릭하면 아래의 화면이 표시됩니다. 이름과 프로젝트, 권한을 지정하고 생성 버튼을 클릭합니다. '프로젝트'는 애플리케이션마다 생성하여 API 키를 관리할 때 지정하면 되겠습니다. 일단 테스트를 위해 Default를 선택하세요. 이름과 권한은 나중에라도 변경할 수 있습니다.

Key 생성 화면

키가 생성되면 아래와 같이 표시됩니다. 참고로, 키는 한 번 생성되면 다시 확인할 수 없으니 관리할 수 있는 곳에 적어 놓길 권장합니다.

키가 생성된 화면

2. 크레딧 및 결제 정보 추가하기

참고로, 최초에 가입하면 무료 크레딧을 일정 금액 제공했었습니다(지금은 모르겠네요). 앞으로 API를 호출하면 크레딧이 소진하게 됩니다. 당연하지만, 크레딧이 없으면 API 호출은 불가능합니다.

청구 페이지

결제 정보를 입력하기 위해 Billing > Payment methods 메뉴를 클릭합니다. 그리고 카드 정보를 입력하고 추가 버튼을 클릭하면 쉽게 완료할 수 있습니다.

결제 정보 입력 화면

저는 처음 테스트를 위해 $5를 결제했는데요. 호출 토큰 양이 많지 않은 이상, API 테스트를 하기에는 충분하다고 생각합니다.

결제 후 화면

만약, 크레딧이 모자르면 Add to credit balance 버튼을 클릭해 충전하시면 됩니다.

크레딧 충전 화면

3. Talend API Tester에서 간단하게 테스트하기

크롬 확장 프로그램인 Talend API Tester에서 간단하게 API 테스트를 할 수 있습니다.

API 요청 화면

POST 메소드를 선택하고, API 요청 주소는 https://api.openai.com/v1/chat/completions 을 입력합니다. 그리고 헤더에는 아래의 정보를 입력합니다.

항목	값
Content-Type	application/json
Authorization	Bearer [API Key]
OpenAI-Beta	assistants=v2

그리고 BODY에는 아래의 정보를 예시로 입력합니다. 모델과 메시지는 자유롭게 선택해도 좋습니다.

{
  "model": "gpt-3.5-turbo",
  "messages": [
    {"role": "user", "content": "Hello, how are you?"}
  ]
}

Send 버튼을 클릭하면, 아래와 같은 응답을 받게 됩니다. BODY의 content에 응답한 메시지가 포함되어 있습니다.

응답 화면

이제 Dashboard > Usage 메뉴에 들어가 보면, 방금 호출한 API에 얼마의 크레딧이 소진되었는지 확인할 수 있습니다.

크레딧 사용량 화면

참고로, 선택한 모델과 토큰 양에 따른 금액은 아래 페이지에 안내되어 있습니다.

https://platform.openai.com/docs/pricing

모델 가격 표

[Container Manager] MariaDB와 레드마인 구축하는 방법, 쉽게 따라하기

Fri, 31 Jan 2025 16:39:27 +0900

이제 Docker 대신 Container Manager

시놀로지 패키지 센터에서는 도커(Docker)와 레드마인(Redmine) 패키지를 제공하는데요. 이 패키지 설치를 통해 쉽고 편하게 레드마인을 구축할 수 있습니다. 하지만, 앞으로 시놀로지 DSM 7.2 버전부터는 이 패키지를 제공하지 않습니다.

이전 버전인 DSM 6.2까지는 도커와 레드마인을 제공했지만, DSM 7.2에서는 컨테이너 매니저(Container Manager)만 제공합니다. 즉, 레드마인을 설치하려면 컨테이너 매니저를 통해 직접 설치와 DB를 연동하여 환경을 구축해야 한다는 것입니다.

직접 구축한다는 것에 부담이 있겠지만, 막상 시도해 보면 그다지 어렵지 않습니다. 본문에서는 레드마인 설치와 MariaDB 연동하는 방법을 상세히 설명하는데요. 한 단계씩 따라 하면 큰 어려움 없이 모두 설치하실 수 있을 것입니다.

참고로, 본문에서는 레드마인 4.2.9 버전을 설치하는데요. 최신 버전인 6.x 버전을 선택해도 상관은 없습니다.

MariaDB 설치 따라 하기

기존 도커의 레드마인은 MariaDB 10 패키지와 연동되어 데이터가 관리됐습니다. DSM 7.2의 패키지 센터에도 MariaDB 10 패키지가 있으나, 이상하게도 컨테이너 매니저의 레드마인에서 MariaDB 10 패키지와 연동이 제대로 안되더군요. 그래서 이를 사용하지 않고, 컨테이너 매니저에서 직접 MariaDB를 설치한 후 연동하는 방식으로 진행합니다.

컨테이너 매니저를 실행한 후 레지스트리 메뉴에서 MariaDB를 검색합니다. 그리고 검색 결과의 mariadb를 선택한 후 다운로드를 클릭하면 태그 선택 창이 표시됩니다. 특정 버전을 선택하거나 최신 버전(latest)을 선택하면 됩니다.

컨테이너 매니저의 레지스트리 메뉴 화면

mariadb의 버전 선택 화면

컨테이너 이름은 기본 값을 사용하거나 사용자 마음대로 변경해도 상관없습니다. 저는 mariadb라는 이름으로 진행했습니다.

컨테이너 이름 설정

포트 번호에는 3306으로 설정합니다. 볼륨 설정에서는 파일 스테이션의 공유 폴더와 mariadb의 특정 경로를 매핑합니다. 이렇게 매핑하면 공유 폴더에 mariadb의 정보가 동기화됩니다.

포트 및 볼륨 설정

항목	값
/docker/mariadb	/var/lib/mysql

환경 변수에는 아래의 항목을 추가합니다.

환경 변수 설정

항목	값
TZ	Asia/Seoul
MYSQL_ROOT_PASSWORD	초기 비밀번호 입력

다음 버튼을 클릭하여 설치를 진행합니다.

설치 화면

설치가 끝나면 아래와 같이 동작 상태가 표시됩니다.

MariaDB가 정상적으로 설치되어 실행되는 모습

Redmine DB 환경 설정 따라 하기

이제 레드마인이 MariaDB에 접근하여 읽고 쓰기가 가능하도록 계정을 만들고 권한을 설정해야 합니다. 이를 위해 HeidiSQL 프로그램을 활용할 겁니다.

프로그램을 받기 위해 홈페이지에 접속합니다.

https://www.heidisql.com/download.php

Download HeidiSQL

Download HeidiSQL 12.10, released on 21 Jan 2025 Installer, 64 bit ≃ Portable version (zipped): 32 bit ≃ 64 bit ≃ Stable link to latest portable version: 32 bit 64 bit Sourcecode Previous releases v12.10 (revision 7000) from 21 Jan 2025: Installer, 6

www.heidisql.com

아래 화면에서 Installer를 클릭하여 설치 파일을 받습니다.

HeidiSQL 홈페이지 화면

설치 과정에는 따로 설정할 것이 없습니다. 설치가 완료되면 HeidiSQL 프로그램을 실행합니다. 그리고 시놀로지 서버의 IP 주소와 사용자 아이디, 비밀번호, 포트 번호를 입력한 후 열기 버튼을 클릭합니다.

HeidiSQL로 MariaDB 접속하기

항목	값
호스트명 / IP	시놀로지 서버 주소
사용자	root
암호	MariaDB 설치 시 환경 변수에 입력한 비밀번호
포트	MariaDB 설치 시 포트 번호에 입력한 번호

연결이 되면 아래와 같이 기본적인 DB 4가지가 보입니다. 이제 도구 > 사용자 관리자 메뉴를 클릭합니다.

사용자 관리자 메뉴 클릭

추가 버튼을 클릭하여 아래와 같이 입력합니다.

사용자 추가하기

항목	값
사용자 이름	사용자 이름 입력
호스트에서	%
암호	암호 입력
접근 허용	전체 권한 체크

참고로, 사용자 이름과 암호는 추후 레드마인 설치 과정 중 환경 변수로 사용됩니다. 여기까지가 MariaDB 환경 구성의 전부입니다.

Redmine 설치 따라 하기

컨테이너 매니저의 레지스트리 메뉴에서 redmine을 검색합니다. 그리고 설치하고 싶은 버전을 선택합니다. 저는 특정 플러그인의 호환성 때문에 4.2.9 버전을 채택했습니다. 참고로, 4.2.9 버전은 4.x의 가장 마지막 버전입니다.

레드마인 버전 선택 화면

레드마인 버전 목록

컨테이너 이름은 자유롭게 설정합니다. 저는 sameersbn-redmine으로 지정했습니다.

컨테이너 이름 설정하기

포트 설정은 자유롭게 지정합니다. 저는 테스트로 7777을 입력했습니다. 그리고 아래 표와 같이 폴더 매핑을 지정합니다. 아래와 같이 폴더를 매핑하면, 파일 스테이션의 공유 폴더와 레드마인의 폴더가 매핑되어 동기화가 됩니다. 플러그인을 설치하기 위해 폴더를 가져다 옮기거나, CKEditor를 사용할 경우 첨부 파일을 백업할 때 매우 용이합니다.

폴더 매핑 설정

항목	값
/docker/redmine	/home/redmine/data
/docker/redmine/plugins	/home/redmine/redmine/plugins

주의

이미 레드마인을 운영하고 있는 상태에서 폴더 매핑을 지정하면 안 됩니다. 제가 알기로는, 매핑은 단방향 동기화라서 레드마인의 지정된 폴더 데이터가 공유 폴더를 따라갑니다. 즉, 공유 폴더에 새 폴더(비어있는 상태)를 생성한 후 레드마인과 매핑하면, 레드마인의 매핑된 경로가 모두 비어집니다. 어떻게 아냐고요? 기존 서버를 그렇게 했다가 모두 지워졌거든요...

환경 변수는 다음과 같이 설정합니다.

환경 변수 설정

항목	값
DB_ADAPTER	mysql2
DB_HOST	MariaDB 컨테이너 이름
DB_NAME	redmine
DB_USER	redmine DB 사용자 이름
DB_PASS	redmine DB 사용자 비밀번호
DB_PORT	MariaDB 포트 번호
TZ	Asia/Seoul

그리고 링크 설정에서 MariaDB 컨테이너를 선택합니다.

컨테이너 링크 설정

이제 컨테이너 상태를 보면 MariaDB와 레드마인이 정상적으로 동작하는 것을 확인할 수 있습니다. (정상 동작 중인 모습을 캡처하지 못했네요... 정상 동작하면 상태에 초록색이 표시됩니다.)

컨테이너 동작 상태

그리고 레드마인의 포트로 접속하면 레드마인 초기 화면이 나타납니다.

레드마인 초기 화면

관리자 아이디와 초기 비밀번호는 admin/admin입니다.

초기 비밀번호 변경

정리하며

처음에는 익숙하지 않아 어렵게 느껴지지만, 막상 몇 번 반복하다 보면 어렵지 않게 구축할 수 있습니다. 그리고 레드마인 버전이 높다고 무조건 다 좋은 것은 아닙니다. 레드마인과 함께 사용할 플러그인의 호환성이 매우 중요하며, 설치 중 문제가 생기면 지웠다 설치하기를 반복 시도하여 최적의 조건을 찾아야 합니다. 레드마인 자체의 큰 문제가 없다면 플러그인 호환성에 맞춰 버전을 선택하는 것을 권장합니다.

[.Net] 생성형 AI, C#에서 대규모 언어 모델(LLM) LLaMaSharp 사용하기(예제 포함)

Fri, 16 Aug 2024 15:45:28 +0900

생성형(Generative) AI란?

데이터를 기반으로 새로운 콘텐츠를 생성하는 기술로, 이미 존재하는 데이터를 학습하여 새로운 이미지, 텍스트, 음악 등 다양한 형태의 콘텐츠를 만들어내는 인공지능입니다.

'정의'만 들어보면 잘 와닿지 않을 텐데요. OpenAI의 ChatGPT는 잘 아실 겁니다. 이 ChatGPT는 텍스트 생성에 초점을 맞춘 생성형 AI로, 방대한 양의 데이터를 학습하여 사용자와 자연스러운 대화를 나눌 수 있는 기술을 제공합니다. 조심해야 할 부분은, ChatGPT의 답변은 100% 정답이 아니며 허상 데이터(Hallucination)를 구분할 줄 알아야 한다는 점입니다. 즉, 맹신하기보다는 의심하는 자세를 취하고 사용해야 합니다.

요즘은 대기업뿐만 아니라 스타트업 기업에서도 생성형 AI를 탑재한 서비스를 내놓고 있습니다. 저는 특히, 최근 3D 제품 제조사에서 자신들의 기술과 매뉴얼을 기반으로 생성형 AI 서비스를 출시하여, 사용자로 하여금 기술 지원 빈도를 줄이고, 원하는 답변을 매뉴얼 정보로 표시해 신뢰성을 높인 부분이 대단하다고 생각합니다. 이제 단순히 정형화된 대답만 하는 챗봇을 마주치면 싱거운 기분이 듭니다.

자, 이번 본문에서는 C# 기반인 LLaMaSharp 라이브러리를 이용하여 대규모 언어 모델(LLM)을 사용해 질문하고 답변을 얻어보려고 합니다. (사실, 나만의 LLM을 특정 데이터를 기반으로 학습시켜보고 싶지만, 깊은 지식과 고성능 하드웨어가 부족하여 도전하지 못하고 있어 아쉽네요.)

LLaMaSharp 소개

LLaMaSharp은 Meta에서 개발한 LLaMA 모델 기반의 크로스 플랫폼 라이브러리입니다. 데이터 모델과 CPU 또는 GPU를 선택하여 다양한 동작 성능을 확인할 수 있습니다.

GitHub - SciSharp/LLamaSharp: A C#/.NET library to run LLM ( LLaMA/LLaVA) on your local device efficiently.

A C#/.NET library to run LLM ( LLaMA/LLaVA) on your local device efficiently. - SciSharp/LLamaSharp

github.com

아래 데모 영상을 보면, 사용자가 질문(초록색)하면 답변(흰색)을 받을 수 있습니다. 코드 생성을 요청했는데 잘 알려주네요.

LLaMa 데모

아래는 시각적 정보를 제공하는 LLaVa의 동작 데모 영상입니다.

LLaVa 데모

따라 하기

1. CUDA 12 SDK 설치하기

LLaMaSharp을 사용하기 위해서 CUDA를 사용한다면 CUDA 11 또는 CUDA 12 SDK가 필요합니다. 저는 CUDA Toolkit 12.4를 설치했습니다.

CUDA Toolkit 12.4 설치된 모습

2. 프로젝트 생성하기

저는 Visual Studio 2022를 사용하여 콘솔(.Net Core 8.0) 프로젝트를 생성했습니다.

Visual Studio 2022 .Net 8.0 프로젝트 생성 화면

3. Nuget 설치하기

Nuget 패키지 관리에서 LLaMaSharp을 검색하고, 다음의 항목을 설치합니다.

LLaMaSharp
LLaMaSharp.Backend.Cpu (CPU 사용 시)
LLaMaSharp.Backend.Cuda11 or 12 (GPU, CUDA 11 또는 12 사용에 따라 선택)
Spectre.Console

LLaMaSharp Nuget 검색 화면

Spectre Nuget 검색 화면

4. 모델 파일 준비하기

LLM의 모델 파일에는 PyTorch 형식(.pth)과 Huggingface 형식(.bin)이 많이 사용됩니다. LLamaSharp는 GGUF 형식 파일을 사용하는데, 이 두 형식에서 변환하여 사용할 수 있습니다. 다음은 GGUF 파일을 얻기 위한 방법을 설명합니다.

4-1. Hugging Face에서 얻기

허깅 페이스(Hugging Face)는 다양한 인공지능 모델을 오픈 소스로 제공하는 사이트입니다. 이 사이트에서 '모델이름 + GGUF'로 검색하여 다운로드할 수 있습니다.

Hugging Face – The AI community building the future.

The Home of Machine Learning Create, discover and collaborate on ML better. We provide paid Compute and Enterprise solutions. We are building the foundation of ML tooling with the community.

huggingface.co

허깅페이스의 Blossom 8B 소개 화면

4-2. 직접 변환하기

PyTorch 또는 Huggingface 형식의 모델 파일을 직접 GGUF 형식으로 변환하여 사용할 수 있습니다. 아래 링크의 가이드에 따라 파이썬 스크립트로 변환이 가능합니다.

GitHub - ggerganov/llama.cpp: LLM inference in C/C++

LLM inference in C/C++. Contribute to ggerganov/llama.cpp development by creating an account on GitHub.

github.com

하지만 이러한 변환 과정이 저처럼 익숙치 않으시다면, 아쉽지만 허깅 페이스에서 제공하는 것만 찾아 쓸 수밖에 없습니다.

5. 코드 작성하기

LLaMaSharp에서 제공하는 기본 예제 코드를 참고하여 아래의 메인 코드를 준비했습니다.

using LLama;
using LLama.Common;
using LLama.Examples;

public class ChatSessionWithRoleName
{
    public static async Task Main()
    {
        string modelPath = UserSettings.GetModelPath();

        var parameters = new ModelParams(modelPath)
        {
            ContextSize = 1024,
            GpuLayerCount = 10,
            MainGpu = 0
        };
        using var model = LLamaWeights.LoadFromFile(parameters);
        using var context = model.CreateContext(parameters);
        var executor = new InteractiveExecutor(context);

        ChatSession session = new(executor);

        InferenceParams inferenceParams = new InferenceParams()
        {
            AntiPrompts = new List<string> { "User:" }
        };

        Console.ForegroundColor = ConsoleColor.Yellow;
        Console.WriteLine("The chat session has started.");

        // show the prompt
        Console.ForegroundColor = ConsoleColor.Green;
        string userInput = Console.ReadLine() ?? "";

        while (userInput != "exit")
        {
            await foreach (
                var text
                in session.ChatAsync(
                    new ChatHistory.Message(AuthorRole.User, userInput),
                    inferenceParams))
            {
                Console.ForegroundColor = ConsoleColor.White;
                Console.Write(text);
            }

            Console.ForegroundColor = ConsoleColor.Green;
            userInput = Console.ReadLine() ?? "";

            Console.ForegroundColor = ConsoleColor.White;
        }
    }
}

ContextSize, GpuLayerCount 등의 파라미터 튜닝이 가능하나, 자세히 다룰 줄 몰라 기본 값으로 적용했습니다. 전체 코드는 아래 첨부된 프로젝트 파일을 참고하세요.

ExamLLaMaSharp.zip

0.00MB

동작 화면

저는 허깅페이스에서 llama-3-Korean-Bllossom-8B-Q4_K_M.gguf 모델을 다운로드하여 대화를 시도해 보았습니다. 축구 경기의 규칙을 설명해 달라고 했는데, 그럴싸한 답변을 주다가 어느 순간부터는 이상한 답변을 주기 시작합니다.

동작 화면

모델의 문제라기보다는, 아마도 제가 사용한 파라미터 튜닝의 문제이지 아닐까 싶습니다.

정리하며

로컬 PC 기반의 LLM 사용은 어떤가 살펴보았는데요. 여러 모델을 다운로드하여 테스트해 보았지만, 하드웨어 사양 부족, 튜닝 숙지 등의 문제로 원하는 성능을 얻지는 못했습니다. 어째서인지, 답변이 끝나지 않고 이상한 내용만 주더군요.

개인적으로 만들어 보고 싶은 것이 있는데, 이에 적합한 모델을 찾는 것부터 파라미터 튜닝, 하드웨어 준비 등 생각해야 할 것들이 너무 많은 것 같습니다.

다음에는 OpenAI API와 같은 서비스를 이용하여 조금 더 쉽고 빠르게 접근이 가능한지 알아보려고 합니다.

[.Net] XML 파일 읽기와 쓰기, 그리고 직렬화(Serialization)로 객체와 연동하는 방법(예제 포함)

Mon, 13 May 2024 20:31:52 +0900

XML이란?

XML은 eXtensible Markup Language약자로, 말 그대로 '확장 가능한 마크업 언어'를 뜻하는데, 좀 더 의미를 풀자면 '데이터를 정의하는 규칙을 제공하는 마크업 언어'입니다.

XML을 몰랐을 때에는 프로그램의 설정 파일로 INI 포맷을 사용했었으나, XML을 접한 이후로는 줄곧 XML 파일만 사용하고 있습니다. 배열 형태로 나열이 가능하고, 데이터의 깊이도 자유롭게 설정이 가능하기 때문입니다. 또한, 가장 중요한 점은 직렬화(Serialization)를 사용하여 객체와 연동이 쉬워 읽고 쓰기가 아주 편리하다는 점입니다.

그럼, 본문에서는 XML 파일의 구조와 C#으로 어떻게 읽고 쓰는지를 보여주고, Serialization을 사용해 어떻게 객체화하는지 설명하겠습니다.

XML 구조

XML은 트리(Tree) 구조입니다. 하나의 노드(Node)를 요소(Element)라고 부르고, 루트(Root)부터 시작하여 하위요소가 이어집니다. 하위 요소 입장에서 상위 요소를 부모(Parent) 요소라고 부르고, 반대로는 자식(Child) 요소라고 부릅니다.

XML 트리 구조

그리고 각 요소는 속성(Attribute)을 가질 수 있습니다. 아래 이미지는 Product 노드 이름에 'index'라는 속성과 '0'이라는 값이 포함된 모습입니다.

노드에 속성이 포함된 모습

그럼 간단하게 반 별로 학생들의 개인 정보가 담긴 XML을 예시로 보겠습니다. A와 B라는 이름의 Class가 있고, Class 별로 몇 명의 학생이 포함되어 있습니다. 그리고 각 학생의 정보에는 이름과 핸드폰 번호가 담겨 있습니다.

<?xml version="1.0"?>
<Root xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Class Name="A">
	<Student Index="0">
	  <Name>철수</Name>
	  <Phone>010-xxxx-xxxx</Phone>
	</Student>  
	<Student Index="1">
	  <Name>영희</Name>
	  <Phone>010-yyyy-yyyy</Phone>
	</Student>  
  </Class>
  <Class Name="B">
	<Student Index="0">
	  <Name>짱구</Name>
	  <Phone>010-zzzz-zzzz</Phone>
	</Student>  
	<Student Index="1">
	  <Name>맹구</Name>
	  <Phone>010-xxxx-yyyy</Phone>
	</Student>  
	<Student Index="2">
	  <Name>기영</Name>
	  <Phone>010-xxxx-zzzz</Phone>
	</Student>  
  </Class>
</Root>

사실 굳이 'Index' 속성을 붙일 필요가 없습니다. 그리고 Name과 Phone 노드도 속성으로 넣으면 더욱 심플해지죠. 그럼 위 파일을 코드로 어떻게 불러올 수 있는지, 어떻게 노드의 값에 접근하는지 보겠습니다.

using System.Xml;
 
private void btnOpen_Click(object sender, EventArgs e)
{
    try
    {
        OpenFileDialog dlg = new OpenFileDialog();
        if (dlg.ShowDialog() == DialogResult.OK )
        {
            XmlDocument doc = new XmlDocument();
            doc.Load(dlg.FileName);
 
            XmlNodeList nodes = doc.SelectNodes(@"/Root/Class");
            var classes = nodes.Count; //반환 값: 2
            
            nodes = doc.SelectNodes(@"/Root/Class[@Name='B']/Student");
            var students = nodes.Count; //반환 값: 3
 
            var node = doc.SelectSingleNode(@"/Root/Class[@Name='B']/Student[@Index='1']/Name");
            var name = node.InnerText; //반환 값: 맹구
        }
    }
    catch(Exception exc)
    {
        MessageBox.Show(exc.Message);
    }
}

노드에 접근하기 위해서는 올바른 XPath(XML Path) 식을 사용해야 합니다. 위 예시처럼, 절대 경로 또는 상대 경로를 입력해야 하며, 속성에 접근하기 위해서는 노드에 [@속성='값'] 키워드를 추가해야 합니다.

만약, 불러오는 것뿐만 아니라 노드 삽입, 삭제, 값 변경 등의 편집도 원한다면 CreateElement, RemoveChild, AppendChild, CreateAttribute 등의 함수를 사용합니다.

XMLDocument의 자세한 사용법은 아래 링크를 참고하세요.

https://learn.microsoft.com/ko-kr/dotnet/api/system.xml.xmldocument?view=netframework-4.8

XmlDocument 클래스 (System.Xml)

XML 문서를 나타냅니다. 이 클래스를 사용하여 문서에서 XML 로드, 유효성 검사, 편집, 추가 및 위치 지정을 수행할 수 있습니다.

learn.microsoft.com

프로그램 운영 중 XML을 편집하길 원한다면 사용하기 쉽게 Wrapper Class를 만드는 것을 추천합니다.

XML 직렬화

직렬화(Serialize)란, 데이터를 저장이나 전송을 위해 연속적인 바이트 단위의 데이터로 가공하는 것을 의미합니다. 이렇게 직렬화된 데이터는 반대로 역직렬화(Deserialize)를 통해 다시 원래의 데이터로 되돌릴 수 있습니다. XML 직렬화는 어떤 객체를 XML 데이터로 직렬화하여 저장(또는 전송)하고, 다시 직렬화된 데이터를 객체로 되돌리는 데 사용될 수 있습니다. 위에서 예시로 보여줬던 학생 정보가 담긴 XML 구조를 객체로 표현하면 다음과 같습니다.

using System.Xml.Serialization;

namespace ExamXML
{
    [Serializable]
    [XmlRoot("Root")]
    public class School
    {
        [XmlElement("Class")]
        public List<Class> Classes { get; set; }
    }

    [Serializable]
    public class Class
    {
        [XmlAttribute("Name")]
        public string Name { get; set; }

        [XmlElement("Student")]
        public List<Student> Students { get; set; }
    }

    [Serializable]
    public class Student
    {
        [XmlAttribute("Index")]
        public int Index { get; set; }

        [XmlElement("Name")]
        public string Name { get; set; }

        [XmlElement("Phone")]
        public string Phone { get; set; }
    }
}

Serializable 키워드는 객체가 직렬화할 수 있다는 의미이고, XmlRoot와 XmlElement는 노드의 이름, 그리고 XmlAttrinute는 속성을 의미합니다.

객체를 XML 직렬화하기

학생 정보가 담긴 School 객체를 Xml 직렬화하는 코드는 다음과 같습니다.

private void btnSeiralize_Click(object sender, EventArgs e)
{
    try
    {
        var school = new School
        {
            Classes = new List<Class>
            {
                new Class
                {
                    Name = "A",
                    Students = new List<Student>
                    {
                        new Student { Index = 0, Name = "철수", Phone = "010-xxxx-xxxx" },
                        new Student { Index = 1, Name = "영희", Phone = "010-yyyy-yyyy" }
                    }
                },
                new Class
                {
                    Name = "B",
                    Students = new List<Student>
                    {
                        new Student { Index = 0, Name = "짱구", Phone = "010-zzzz-zzzz" },
                        new Student { Index = 1, Name = "맹구", Phone = "010-xxxx-yyyy" },
                        new Student { Index = 2, Name = "기영", Phone = "010-xxxx-zzzz" }
                    }
                }
            }
        };

        SaveFileDialog dlg = new SaveFileDialog();
        if (dlg.ShowDialog() == DialogResult.OK)
        {
            XmlSerializer serializer = new XmlSerializer(typeof(School));
            using (FileStream fileStream = new FileStream(dlg.FileName, FileMode.Create))
            {
                serializer.Serialize(fileStream, school);
            }
        }
    }
    catch (Exception exc)
    {
        MessageBox.Show(exc.Message);
    }
}

객체를 XML 구조로 직렬화할 것이니, 확장자는 XML로 지정합니다. 저장된 파일을 열어보면 처음에 제시한 XML 파일과 동일합니다.

XML 파일을 객체로 역직렬화하기

이번엔 반대로, XML 파일을 불러오면 School 객체로 변환이 가능합니다.

private void btnDeserialize_Click(object sender, EventArgs e)
{
    try
    {
        OpenFileDialog dlg = new OpenFileDialog();
        if (dlg.ShowDialog() == DialogResult.OK)
        {
            XmlSerializer serializer = new XmlSerializer(typeof(School));
            using (FileStream fileStream = new FileStream(dlg.FileName, FileMode.Open))
            {
                School school = (School)serializer.Deserialize(fileStream);
            }
        }
    }
    catch (Exception exc)
    {
        MessageBox.Show(exc.Message);
    }
}

위 코드를 사용해 XML 파일을 불러오면, 아래와 같이 객체를 얻을 수 있습니다.

XML 파일로부터 객체로 역직렬화한 결과

정리하기

개인적으로 XML은 주로 프로그램의 시스템 설정 값을 관리하는 용도로 사용합니다. INI보다 사용하기 편하고 직렬화를 통해 객체 관리가 더 용이한 것 같습니다. 참고로, 직렬화는 XML만 가능한 것은 아니고 어떤 객체든 직렬화/역직렬화가 가능합니다.

게다가 PropertyGrid 컨트롤과 XML 객체를 연동하면 XML 편집이 더욱 용이하고 활용성이 높아지는 장점이 있습니다. 한번 사용해 보세요.

ExamXML.zip

0.01MB

[.Net] WinForm UI 컨트롤 데이터 바인딩(Data Binding) 파헤치기(예제 포함)

Sun, 24 Mar 2024 18:09:18 +0900

데이터 바인딩(Data Binding)이란?

혹시 WinForm UI 컨트롤 중 DataGridView나 ListBox에서 DataBinding 항목을 본 적이 있나요? 데이터 바인딩은 UI 컨트롤과 데이터를 연결하는 것을 의미합니다. 데이터와 UI 컨트롤이 연결되어 있으면, 데이터가 변경될 때 UI 컨트롤이 자동으로 갱신되게 됩니다. 즉, 데이터가 변경됐을 때 사용자가 일일이 UI 컨트롤을 수정할 필요가 없는 것이죠.

DataGridView 속성 화면

데이터 바인딩을 사용할 때 또 하나의 장점이 있습니다. 대량의 데이터를 UI 컨트롤에 반영할 때 반응 속도가 빠르다는 것이죠.

본문에서 데이터 바인딩을 사용하지 않았을 때 문제점, 데이터 바인딩을 적용하면 어떤 효과를 볼 수 있는지 자세히 다뤄보도록 하겠습니다.

DataGridView 컨트롤

DataGridView는 흔히 엑셀에서 셀을 표시하는 것과 유사합니다. 제일 첫 번째 행에는 헤더 행(Header row)이 있고, 그 아래로는 데이터 행(Data row)이 추가됩니다. 그리고 제일 마지막 행에는 데이터 입력이 가능합니다.

DataGridView 컨트롤의 동작 화면

일반적인 데이터 추가 방법

아래 코드는 버튼을 클릭하면 '이름'과 '나이' 헤더에 두 개의 데이터를 추가하는 동작입니다.

private void btnCreateData_Click(object sender, EventArgs e)
{
    dataGridView1.Columns.Add("Column1", "이름");
    dataGridView1.Columns.Add("Column2", "나이");

    dataGridView1.Rows.Add("짱구", "22");
    dataGridView1.Rows.Add("철수", "33");
}

동작은 아래 그림과 같습니다. 아주 간단하죠?

코드 동작 결과

그럼 이번에는 훨씬 더 많은 5천 개의 데이터 행(Row)을 추가해 보겠습니다. 데이터 행을 추가하는 함수로 Add()가 사용됐습니다.

private void btnCreateData_Click(object sender, EventArgs e)
{
    dataGridView1.Columns.Add("Column1", "이름");
    dataGridView1.Columns.Add("Column2", "나이");

    for (int i = 0; i < 5000; i++)
    {
        dataGridView1.Rows.Add($"Name{i}", $"Age{i}");
    }
}

그리고 동작 결과는 아래와 같습니다. 버튼을 클릭하고 약 1~2초 정도의 지연 후 컨트롤에 5천 개의 데이터가 추가됐습니다.

Add 함수로 데이터 추가한 결과

데이터 바인딩 사용 방법

이번에는 데이터 바인딩을 사용하여 데이터를 연결해 보겠습니다. DataTable을 사용하여 Column을 추가하고, 이후 Rows에 데이터를 추가하면 됩니다.

private void btnDataBinding_Click(object sender, EventArgs e)
{
    DataTable dt = new DataTable();

    dt.Columns.Add("Column1");
    dt.Columns.Add("Column2");

    for (int i = 0; i < 5000; i++)
    {
        dt.Rows.Add($"Name{i}", $"Age{i}");
    }

    dataGridView1.DataSource = dt;
}

결과를 보면, 버튼을 클릭하자마자 데이터가 바로 보입니다. Add() 함수를 사용할 때 와는 다른 속도입니다.

데이터 바인딩으로 추가한 결과

이처럼, 데이터 바인딩을 사용하여 대량의 데이터를 컨트롤과 연결할 때 속도를 개선할 수 있습니다.

또한, 데이터 바인딩을 사용하면 데이터를 추가하고 삭제할 때 자동으로 컨트롤이 갱신됩니다. 아래 코드는 맨 마지막 행에 데이터를 추가하고, 맨 처음 행의 데이터를 삭제하는 동작입니다.

private void btnAdd_Click(object sender, EventArgs e)
{
    DataTable dt = (DataTable)dataGridView1.DataSource;
    dt.Rows.Add($"Name{dt.Rows.Count}", $"Age{dt.Rows.Count}");
}

private void btnDelete_Click(object sender, EventArgs e)
{
    DataTable dt = (DataTable)dataGridView1.DataSource;
    dt.Rows.RemoveAt(0);
}

데이터 추가, 삭제 동작

주의 사항

데이터 행을 추가하는 Add() 그리고 제거하는 Remove()를 사용하는 일반적인 방식과 데이터 바인딩 방식은 같이 사용될 수 없습니다. 만약, 데이터 바인딩 이후 Add()나 Remove()를 호출하게 되면 다음의 메시지가 발생합니다.

private void btnMixed_Click(object sender, EventArgs e)
{
    try
    {
        DataTable dt = new DataTable();
        dataGridView1.DataSource = dt;

        dataGridView1.Rows.Add($"Name", $"Age");
    }
    catch(Exception exc)
    {
        MessageBox.Show(exc.Message);
    }
}

오류

컨트롤이 데이터 바인딩된 경우에는 DataGridView의 행 컬렉션에 프로그래밍 방식으로 행을 추가할 수 없습니다.

따라서, 처음부터 데이터 바인딩을 사용할 것인지 아니면 프로그래밍 방식을 사용할 것인지 미리 선택한 후 개발해야 합니다.

TestDataBinding.zip

0.02MB

[AI] ChatGPT 유료 버전 Custom 챗봇 생성 방법과 사용 후기

Sat, 9 Dec 2023 18:42:23 +0900

맞춤형 데이터 기반의 AI 챗봇

OpenAI의 챗GPT(ChatGPT)는 정말 혁신적이죠. 작성일 기준, 챗GPT를 사용하면 2023년 4월까지의 학습된 정보를 기반으로 질문에 대한 답변을 받을 수 있습니다. 게다가 플러그인을 사용하면 웹 브라우저 검색으로 최신 데이터도 얻을 수 있습니다.

챗GPT를 사용하다가 문득 든 생각이, '현재 내가 갖고 있는 데이터를 기반으로 챗GPT와 같은 AI 챗봇을 만들 수 있을까?'였습니다. 회사의 업무 데이터를 기반으로 챗봇으로 만든다면, 사소하고 반복되는 업무나 과거 데이터를 찾을 때, 그리고 장기간 이어진 이슈를 요약할 때 유용하지 않을까 생각했습니다.

하지만 생각과 다르게 현실의 벽은 너무 높았습니다. 인공지능 모델에 학습하기 위한 데이터 세트를 어떻게 준비해야 할 지, 그리고 방대한 양의 데이터를 혼자서 어떻게 편집할지, 게다가 인공지능 학습에 관한 개발 환경은 어떻게 준비해야 할지 등 고민해야 할 부분이 너무 많았습니다.

그러던 와중에 ChatGPT에 Custom ChatGPT 기능이 있다는 것을 접했습니다. 이는, 사용자 데이터를 기반으로 맞춤형 챗봇을 만드는 것인데요. 다행스럽게도 프로그래밍을 할 줄 몰라도 손쉽게 만들 수 있었습니다.

이번 포스팅을 통해 어떻게 Custom ChatGPT를 만드는 지, 성능은 어떤지 알아보겠습니다.

목표

저는 특정 pdf 파일을 준비했으며, 이 내용 기반으로 챗봇을 제작하고자 합니다.

준비물

OpenAI ChatGPT 유료 버전을 구독해야 합니다. 작성일 기준, 한 달에 20$입니다. 그리고 학습할 데이터를 준비합니다.

챗GPT 구독

따라 하기

1. GPT 생성하기(자동/수동)

ChatGPT 사이트에 접속한 후 좌측 상단의 아래 화면을 확인합니다. 그리고 Explore 메뉴를 클릭합니다.

Explore 메뉴 클릭하기

아래의 화면이 표시되면, Create a GPT 메뉴를 클릭합니다.

Create a GPT 메뉴 클릭하기

이제 맞춤형 GPT를 만들기 위한 첫 단계입니다. 왼쪽은 GPT를 생성하기 위한 설정 화면이고, 오른쪽은 생성된 챗GPT를 평가하는 화면입니다.

GPT 생성 및 미리보기 화면

왼쪽화면의 상단에 Create와 Configure 메뉴가 보이는데요. Create 메뉴는 GPT Builder와 대화하면서 이름과 프로필, 업로드 파일 등을 설정하게 됩니다. 뭐가 뭔지 모르겠으면 챗GPT를 사용하듯이 GPT Builder와 질문하면서 진행해 나가면 됩니다.

만약, 능숙하게 사용할 줄 안다면 Configure 메뉴를 클릭해서 모든 설정을 직접 해서 GPT를 생성하면 됩니다.

Configure 메뉴 화면

2. GPT 설정하기

GPT Builder와 대화를 시작합니다. GPT를 어떤 목적으로 사용할 것인지 대답하면 이름과 프로필 사진을 제안해 줍니다. 만약, 영어가 답답하면 한국어로 대답해 달라고 얘기하면 됩니다.

GPT Builder와 대화하면서 설정하기

그리고 준비된 자료를 Knowledge에 첨부합니다. 테스트한 결과 약 30개 정도 첨부하면 더 이상 업로드가 되지 않더군요. 여러 파일을 많이 올리기보다는 하나로 합쳐 업로드하는 게 더 효율적인 것 같습니다. 저는 다수의 PDF 파일이 있었는데 한 개의 PDF로 합쳐서 업로드했습니다. 이렇게 해도 원하는 답변을 얻는데 문제는 없었습니다.

Knowledge에 파일 첨부하기

3. GPT 테스트 및 저장, 완료하기

이제 우측 화면에서 대화를 시도해 원하는 답변을 얻을 수 있는지 확인합니다.

GPT 학습 결과 테스트하는 화면

더이상 설정할 내용이 없다면 우측 상단의 Save 버튼을 클릭하여 저장합니다. 이렇게 만든 GPT를 다른 사람에게 공유할 순 있지만, 상대방도 Plus 구독자여야 사용이 가능합니다.

GPT 저장하기

GPT 생성이 완료됐습니다. ChatGPT 사이트 메인으로 이동하면 아래와 같이 생성한 Custom ChatGPT가 보이게 됩니다. ChatGPT를 사용하듯이 대화를 걸면 원하는 답변을 얻을 수 있습니다.

Custom GPT가 생성된 모습

Custom ChatGPT 사용 후기

1. 레드마인 티켓 학습

처음 Custom ChatGPT에 학습한 파일은 레드마인 티켓이었습니다. 처음에는 레드마인 DB를 학습해야 하나 싶었는데, 티켓을 PDF로 저장하고 학습해도 가능한 것을 확인했습니다.

하지만 티켓이 1만 개가 넘다 보니, 1만 개의 PDF를 업로드하는 것은 사실상 불가능했습니다. 그래서 이를 하나의 PDF로 합치고 학습하는 것으로 방법을 바꾸었습니다. 그래도 1만 개는 너무 많으니 100개 정도로 테스트를 진행했는데요.

어떤 이슈를 얘기하면 과거에 어떻게 진행했었는지, 티켓 번호는 무엇인지 원하는 답변을 얻을 수 있었습니다. 하지만, 항상 100% 원하는 답변은 아니었고, 일부는 없는 답변을 주기도 했습니다. 전체 티켓을 학습한다고 해도 티켓마다 내용이 거의 다르니 Custom GPT 믿고 가기에는 조금은 불안한 느낌이 들었습니다.

2. 기술 자료

이번에는 기술 자료로 테스트를 해봤습니다. 레드마인 티켓은 시간의 흐름에 따라 어떤 일들이 있었는지 구구절절 이력이 남아있는 것에 반해, 기술 자료는 '무엇을 하려면 어떻게 해야 한다'라는 내용이 명확하게 기록되어 있습니다.

이 자료 기반으로 생성된 GPT는 상당히 만족스러운 결과를 얻을 수 있었습니다. 어떤 질문을 하면 학습된 내용 기반으로 거의 완벽한 답변을 얻을 수 있었습니다.

아무래도 깔끔하게 정리가 된 자료 기반으로 학습하는 것이 답변 퀄리티가 높은 것 같습니다.

3. 도서 및 논문

인터넷에 오픈되어 있는 샘플 도서 PDF 및 논문 자료를 사용하여 학습해 보았습니다.

PDF 전체 내용을 요약하거나 특정 주제를 찾을 때, 그리고 그 내용을 구체적으로 설명을 원할 때 사용하면 아주 유용합니다. PDF가 수백 페이지가 넘어가면 특정 내용을 찾기도 어렵지만 정리하기도 힘든데요.

Custom ChatGPT로 학습하면 요약, 내용 분석, 쉬운 설명이 가능해집니다. 사실 몰랐던 부분인데, 챗GPT 말고도 PDF를 요약해주는 서비스가 여럿 있더군요.

정리

저에게는 굳이 Custom ChatGPT를 사용하기 위해 유로 서비스를 구독할 필요는 없을 것 같습니다. 누군가와 공유를 하기 위해 서비스를 만드는 게 아니라면, Knowledge를 사용한 챗GPT를 사용할 일은 없을 것 같기 때문입니다. 그저, '유료를 사용하던 와중에 이런 기능이 있어서 사용한다'라는 접근이 낫지 않을까 싶습니다.

[셀레니움/Selenium, C#] ChromeDriver 버전 자동 업데이트 적용 방법

Wed, 22 Nov 2023 22:18:29 +0900

크롬 드라이버 업데이트

크롬 브라우저 기반으로 크롤링 프로그램 개발 시 현재 시스템에 설치되어 있는 크롬 브라우저의 버전과, 실행되는 프로그램의 버전을 맞추는 작업이 참 귀찮았습니다.

만약, 버전이 맞지 않으면 드라이버 버전이 일치하지 않아 동작한다는 에러 메시지가 발생합니다. 그래서 이를 대처하는 방법을 아래의 포스팅에 올린 적이 있습니다.

[셀레니움/Selenium, C#] ChromeDriver 버전 에러 해결 방법

크롬 드라이버 버전 오류 현상 크롬 드라이버를 이용한 크롤링 프로그램 제작 시 아래의 메시지는 한 번쯤은 봤을 것입니다. session not created: This version of ChromeDriver only supports Chrome version 85 (Session

luckygg.tistory.com

최근 들어 이 방법도 잘 안통하는 것을 확인했는데요. 크롬 브라우저 버전이 최신이지만, 크롬 드라이버 다운로드 페이지에는 버전과 일치하는 파일이 없어 제대로 동작하지 않았습니다.

사실, 이보다 더 간편한 방법이 있습니다. 프로그램 실행 시 자동으로 크롬 드라이버를 업데이트하는 방법입니다. 그럼 더 이상 귀찮게 직접 다운로드할 필요가 없지요.

본문에서 차근차근 설명하겠습니다.

따라 하기

1. C# 프로젝트 생성하기

콘솔이든 WinForm이든 상관 없습니다. 사용하기 편한 프로젝트를 생성합니다. 저는 WinForm 프로젝트를 생성했습니다.

2. NuGet에서 Selenium 패키지 설치하기

프로젝트 생성 후 Visual Studio 상단 메뉴 중 도구 > NuGet 패키지 관리자 > 솔루션용 NuGet 패키지 관리 메뉴를 클릭합니다.

NuGet 패키지 관리 메뉴

찾아보기 탭에서 검색란에 selenium을 검색합니다.

selenium 패키지 검색

검색 결과에서 Selenium.WebDriver와 Selenium.Support 패키지를 프로젝트에 설치합니다. 그리고 다시 검색 란에 web driver manager를 검색합니다.

web driver manager 패키지 검색

WebDriverManager 패키지를 프로젝트에 설치합니다.

주의

만약, Selenium.WeDriver.ChromeDriver 패키지를 같이 설치하면 드라이버 충돌이 발생해 크롬 드라이버가 일치하지 않는다는 오류가 계속해서 발생합니다.

3. 코드 구현

기본적인 코드 사용 방법은 아래와 같습니다.

//기본 namespace 생략
using OpenQA.Selenium;
using OpenQA.Selenium.Chrome;
using OpenQA.Selenium.Support.UI;
using WebDriverManager;
using WebDriverManager.Helpers;
using WebDriverManager.DriverConfigs.Impl;

namespace ExamSelenium
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();

            try
            {
                ChromeDriverService driverService = null;
                ChromeOptions options = null;
                ChromeDriver driver = null;

                //크롬 드라이버 자동 업데이트
                new DriverManager().SetUpDriver(new ChromeConfig(), VersionResolveStrategy.MatchingBrowser);

                driverService = ChromeDriverService.CreateDefaultService();
                driverService.HideCommandPromptWindow = true;

                options = new ChromeOptions();
                options.AddArgument("disable-gpu");

                driver = new ChromeDriver(driverService, options);

                driver.Navigate().GoToUrl("https://www.naver.com");
            }
            catch(Exception exc)
            {
                MessageBox.Show(exc.Message);
            }
        }
    }
}

Chrome 관련 객체는 예전에 설명한 내용과 동일하고, 24번째 라인의 DriverManager() 부분이 핵심입니다. 이 코드가 실행되면 현재 시스템에 설치되어 있는 브라우저와 일치하는 크롬 드라이버가 자동으로 준비됩니다.

크롬 드라이버 업데이트 방법은 다음과 같이 여러 방법이 있습니다.

//특정 버전
new DriverManager().SetUpDriver(new ChromeConfig(), "2.25")

//특정 아키텍처
new DriverManager().SetUpDriver(new ChromeConfig(), "Latest", Architecture.X32)

//특정 버전 및 특정 아키텍처
new DriverManager().SetUpDriver(new ChromeConfig(), "2.25", Architecture.X64)

//브라우저와 일치하는 버전(Chrome, Edge, Firefox, Internet Explorer만 해당):
new DriverManager().SetUpDriver(new ChromeConfig(), VersionResolveStrategy.MatchingBrowser);

그 외 WebDriverManager에 대해 더 궁금하다면 아래 GitHub 페이지를 참고하세요.

https://github.com/rosolko/WebDriverManager.Net

GitHub - rosolko/WebDriverManager.Net: Automatic Selenium Webdriver binaries management for .Net

Automatic Selenium Webdriver binaries management for .Net - GitHub - rosolko/WebDriverManager.Net: Automatic Selenium Webdriver binaries management for .Net

github.com

[.Net] ML.NET을 이용한 딥 러닝 모델 생성하기 - 이미지 분류

Sun, 15 Oct 2023 16:36:34 +0900

인공 지능

인공 지능(AI)이라는 키워드가 어딜 가나 빠지지 않습니다. 학습 도구는 물론이고 자동차, CCTV, 검색 엔진, 챗봇, 글자 인식(OCR) 등 다양한 분야에서 인공 지능 기술이 많이 접목되었습니다.

인공 지능의 역사는 1950년대 까지 거슬러 올라간다고 하는데요. 지금까지 여러 암흑기를 거치고 지속적인 발전을 통해 오늘날 챗GPT까지 오게 됐습니다. 그 결과, AI 기술은 우리 생활과 밀접하게 연결되었고, AI 기술을 얼마나 활용하냐에 따라 업무 효율성이 달라질 정도입니다.

본 포스팅은 머신 러닝(인공 지능 분야의 하위 집합, 분야)에 대한 깊은 지식이 없더라도, C# 언어를 사용하여 간단하게 머신 러닝 라이브러리를 사용할 수 있는 방법을 소개하고자 합니다.

ML.NET

ML.NET은 마이크로소프트에서 만든 머신 러닝 프레임워크로, 무료 오픈 소스 플랫폼입니다. 앞서 얘기한 것처럼, 머신 러닝에 대한 지식이 없어도 가이드대로 라이브러리를 사용하면 원하는 결과를 얻을 수 있습니다. 주요 특징을 나열하면 다음과 같습니다.

무료 오픈 소스
C# 및 F# 지원
.NET Core 2.0 이상, .NET Framework 4.6.1 이상 지원
Windows, Linux, macOS 지원
데이터/이미지/문자열 분류, 값 예측, 개체 감지 등 지원
Visual Studio 2019, 2022

공식 홈페이지: https://dotnet.microsoft.com/ko-kr/learn/ml-dotnet/what-is-mldotnet

ML.NET란? 오픈 소스 기계 학습 프레임워크.

ML.NET은 .NET 개발자 플랫폼을 위해 Microsoft에서 만든 무료 오픈 소스 플랫폼 간 기계 학습 프레임워크입니다.

dotnet.microsoft.com

시나리오

ML.NET에서는 시나리오에 따라 모델 학습이 달라집니다. 지원하는 시나리오는 아래 그림과 같습니다.

시나리오 종류

우리가 흔히 봤던 강아지와 고양이를 구분하는 이미지 분류가 있고, 값 예측이나 논문 유사성을 비교할 수 있는 문장 유사성도 시나리오도 제공합니다.

본문에서는 강아지와 고양이를 구분하는 이미지 분류 시나리오를 선택하여 성능 및 결과를 살펴보겠습니다.

따라 하기

1. ML.NET Model Builder 설치하기

Visual Studio 구성에서 아래 그림과 같이 ML.NET Model Builder가 설치되어 있는지 확인합니다. 없다면, 체크한 후 설치를 진행합니다.

ML.NET Model Builder 설치하기

2. ML.NET Model Builder 업데이트하기

Visual Studio를 실행하고 확장 관리 메뉴를 실행합니다.

확장 관리 메뉴

업데이트 항목에 ML.NET Model Builder가 있는지 확인합니다. Model Builder를 방금 설치했어도 업데이트가 안되어 있을 수 있습니다. 버전이 낮으면 학습 단계에서 문제가 생길 수 있으므로 반드시 업데이트합니다.

Model Builder 업데이트

3. 프로젝트 생성 및 기계 학습 모델 추가

콘솔 앱(.NET Framework) 프로젝트를 생성합니다.

프로젝트 생성

그리고 프로젝트를 선택하고 기계 학습 모델 메뉴를 선택합니다.

기계 학습 모델

이름을 지정한 후 추가 버튼을 클릭합니다.

Machine Learning Model 추가

4. 기계 학습 모델 설정

시나리오를 선택합니다. 앞에서 얘기한 대로, 본문에서는 이미지를 구분하는 것이 목표이므로 이미지 분류를 선택합니다.

시나리오 선택

학습 환경으로는 되도록이면 GPU를 선택합니다. CPU를 선택하면 시간이 오래 걸리기 때문에 GPU를 선택하는 것을 권장합니다.

GPU 선택 화면

만약, GPU 호환성에 모두 초록색 표시가 아니라면 아래의 내용대로 조치해 보세요.

4-1. GPU 확장

GPU 확장이 없습니다 메시지가 표시되면 다음을 점검하세요.

GPU 인식 오류

① NVIDIA 그래픽 카드 드라이버 업데이트 확인.
② Visual Studio 확장 메뉴에서 Model Builder 업데이트 확인.

4-2. CUDA 및 cuDNN

2023년 10월 15일 자 기준, CUDA v10.1과 cuDNN v7.6.4 for CUDA 10.1을 준비해야 합니다. cuDNN의 경우, 다운로드한 파일 중 bin\cudnn64_7.dll 파일을 Program Files\NVIDIA GPU Computing Toolkit\CUDA\v10.1\bin에 복사합니다.

5. 데이터 추가

이제 학습할 데이터를 추가해야 하는데요. 저는 kaggle에서 Cats-vs-Dogs 주제의 이미지를 사용했습니다.

https://www.kaggle.com/datasets/shaunthesheep/microsoft-catsvsdogs-dataset/

Cats-vs-Dogs

image dataset for binary classification.

www.kaggle.com

다운로드한 후 동물 별로 학습용(Training) 이미지와 검사용(Inference) 이미지를 분류했습니다. 주의 사항으로, 폴더 이름이 레이블(Label)이 되므로, 폴더 이름으로 이미지가 확실히 분류되어 있어야 합니다.

폴더 구조

데이터를 추가하면 다음의 화면이 표시됩니다.

데이터가 추가된 모습

6. 학습

학습 메뉴에서 학습 시작을 누르면 학습이 바로 시작됩니다. 학습 중 글자가 표시되고, 아쉽지만 예상 시간이 표시되지 않아 마냥 기다려야 합니다.

학습

고급 학습 옵션 메뉴를 클릭하면 아래의 창이 표시됩니다. 사실 무슨 의미인지는 자세히 모르겠으나, 학습 결과가 좋지 않으면 설정 값을 변경하면서 학습을 시도합니다.

고급 학습 옵

7. 평가

약 23분 만에 학습이 완료됐습니다. 그런데 정확도가 0.4732밖에 되지 않는군요.

학습 결과

평가 메뉴에서 Inference용 이미지를 불러와 결과를 확인할 수 있습니다. 강아지 이미지를 불러오면 52% Dog 레이블이고, 고양이 이미지를 불러오면 51% Cat 레이블입니다. 학습 결과가 좋지 않습니다.

평가 결과

아마도 고급 학습 옵션에서 다른 설정을 선택하여 다시 학습을 시도해 봐야 할 것 같습니다.

8. 코드 사용

이제 사용 탭으로 넘어갑니다. 상단에는 코드 예시가 보이고, 그 아래에는 솔루션에 추가 메뉴가 있습니다. 이를 클릭하여 콘솔 앱 프로젝트를 추가합니다.

코드 사용을 위한 프로젝트 추가

예제 코드와 함께 프로젝트가 생성됩니다. 파일 경로에 Inference 이미지가 있는 경로로 변경하고 실행합니다.

모델 사용을 위한 콘솔 프로젝트

고양이 이미지를 테스트했더니 Cat 레이블 0.52%의 결과를 얻을 수 있었습니다.

Inference 결과

평가 메뉴에서 테스트한 것처럼 결과가 그다지 좋진 않습니다.

상용 라이브러리와 비교

다른 고급 옵션 설정을 변경하여 재시도 해봤지만 여전히 결과가 좋지 않더군요. 고급 옵션 외에 별다른 설정이 없어 성능을 더 높일 수 있는 방법을 찾지 못했습니다. 이 점이 너무 아쉽습니다.

추가로, ML.NET 모델의 한계인지 궁금하여 상용 라이브러리로 테스트를 진행해 보았습니다. 상용 라이브러리는 Euresys의 Open eVision 23.08을 사용했는데요. 여기서 제공하는 Deep Learning Studio는 무료로 사용이 가능하여 쉽게 검토가 가능합니다.

물론, 머신 비전에 적합한 모델이 적용되어 있겠지만 간단한 분류는 가능하지 않을까 시도해 봤습니다.

동일한 이미지로 학습을 진행했더니 약 10시간 넘게 예상 시간이 표시됐습니다. 그래서 2시간 반 정도 학습한 후 중지시키고 테스트를 해봤습니다.

학습 예상 시간

고양이 사진은 99%, 강아지 사진은 99%로 분류가 됐습니다. 상용 라이브러리로 매우 정확하게 분류할 수 있었습니다.

상용 라이브러리 분류 결과

또한, 아래처럼 Heatmap 이미지를 제공하여 모델이 어디에 집중했는지도 보여줍니다.

히트 맵 이미지

그리고 모델을 검증하던 중 Confusion Matrix에 제대로 예상하지 못한 결과가 있었습니다. 항목을 보니, Dog 폴더에 고양이와 글자, 일러스트와 같은 이미지들이 섞여 있더군요. Cat 폴더에도 마찬가지였습니다. 사람 사진도 섞여있는 것이, 아마도 ML.NET에서는 학습에 안 좋은 영향을 주지 않았나 싶습니다.

Confusion Matix 결과

[Flutter] 윈도우(Windows)에 플러터(Flutter) 환경 구축하는 방법

Wed, 23 Aug 2023 10:23:17 +0900

1. 윈도우 용 Android Studio 설치하기

Android Studio를 다운로드하기 위해 아래 사이트에 접속합니다.

https://developer.android.com/studio

Download Android Studio & App Tools - Android Developers

Android Studio provides app builders with an integrated development environment (IDE) optimized for Android apps. Download Android Studio today.

developer.android.com

위 홈페이지에 접속하면 아래와 같이 Download Android Studio Giraffe 버튼이 보입니다. 클릭하면 라이선스 동의 화면이 보이고, 동의하면 다운로드가 진행됩니다.

Android Studio 홈페이지

설치 파일을 실행하여 설치 마법사를 진행합니다. 설치 과정 중 'Android Virtual Device'는 선택하여 설치합니다. 그 외, 별다른 설정 없이 Next만 클릭하면 설치가 완료됩니다.

설치 과정

설치가 완료되면, 아래와 같이 Android Studio가 실행됩니다.

Android Studio 실행 모습

2. Flutter SDK 설치하기

이제 Android Studio에서 사용할 Flutter SDK를 설치해야 합니다. Flutter 공식 홈페이지에 접속합니다.

https://docs.flutter.dev/release/archive?tab=windows

Flutter SDK archive

All current Flutter SDK releases: stable, beta, and master.

docs.flutter.dev

Stable channel (Windows) 중 최신 버전 또는 원하는 버전의 파일을 다운로드합니다.

Flutter SDK 다운로드 화면

다운로드한 파일은 설치 파일이 아닌 압축 파일(*.zip)입니다. 압축을 풀고, C:\flutter 또는 D:\flutter과 같이 원하는 경로에 옮겨 놓습니다.

flutter 압축을 푼 모습

그리고 윈도우 환경 변수에 flutter\bin 폴더 경로를 추가합니다. 저는 C:\flutter\bin 경로를 추가했습니다.

환경 변수 추가하기

그리고 명령 프롬프트를 실행합니다.

명령 프롬프트 실행하기

아래의 명령어를 입력합니다.

flutter doctor

명령어를 입력하면 아래와 같이 !, X, V가 표시됩니다.

flutter doctor로 점검한 모습

! Some Android licenses not accepted

이 메시지는 말 그대로, 라이선스 일부가 동의되지 않았다는 의미입니다. 명령 프롬프트에서 아래의 명령어를 입력합니다.

flutter doctor --android-licenses

만약, 명령어 입력 시 에러가 발생하면 아래와 같이 Android SDK Command-line Tools를 설치합니다.

Command-line Tools 설치하기

다시 명령 프롬프트에서 명령어를 입력하고, 화면에 동의 하겠느냐는 메시지가 표시될 때마다 'y' 키를 입력하면 간단하게 해결됩니다.

X Flutter/Dart plugin not installed

해당 에러 메시지는 Android Studio에 Flutter plugin이 설치되지 않았다는 의미입니다. 아래와 같이 Android Studio의 Plugins 메뉴에서 Dart와 Flutter 항목을 선택하여 설치하면 해결됩니다.

Dart와 Flutter를 설치한 모습

! No devices available

사용 가능한 디바이스가 없다는 메시지입니다. 앱 개발 시 물리적으로 연결된 스마트폰 또는 가상 장치에서 실행하여 확인할 수 있는데요. 처음 Android Studio를 설치하면 장치가 없기 때문에 메시지가 발생한 것입니다.

가상 장치를 추가하는 방법은 아래 링크를 참고하세요.

[Flutter] 가상 디바이스(Virtual device) 추가하는 방법

Android Virtual Device(AVD) 관리하기 Android Studio에서는 물리적으로 연결된 스마트 폰에서 앱을 개발할 수도 있지만, 편리하게 가상 디바이스를 추가하여 실행하고 디버깅이 가능합니다. 가상 디바이

luckygg.tistory.com

이제 모든 조치를 다 취한 후 다시 한번 아래의 명령어를 입력합니다.

flutter doctor

아래와 같이 V 표시되고, No issues found 메시지가 보인다면 flutter를 사용하기 위한 준비가 끝난 겁니다.

모든 준비가 완료된 모습

3. Flutter Project 생성하기

Welcome 화면에서 New Flutter Project를 클릭합니다.

Flutter Project 생성하기

그리고 아래 화면과 같이 Flutter SDK path란에 처음 옮겨놨던 flutter 경로로 설정합니다.

flutter 경로 설정하기

문제가 없다면 아래 화면과 같이 Flutter 프로젝트가 생성됩니다.

Flutter 프로젝트가 생성된 모습

[Flutter] 가상 디바이스(Virtual device) 추가하는 방법

Sun, 20 Aug 2023 21:23:12 +0900

Android Virtual Device(AVD) 관리하기

Android Studio에서는 물리적으로 연결된 스마트 폰에서 앱을 개발할 수도 있지만, 편리하게 가상 디바이스를 추가하여 실행하고 디버깅이 가능합니다.

가상 디바이스를 추가하는 방법은 아주 간단한데요. 한번 따라 해 보겠습니다.

1. Virtual Device Manager 메뉴 클릭하기

처음 Welcome 화면에서 More Actions를 클릭하면 Virtual Device Manager 메뉴가 보입니다. 이 메뉴를 클릭합니다.

Virtual Device Manager 클릭하기

만약, 이미 생성한 프로젝트가 있어서 Welcome 화면이 보이지 않는다면, 아래와 같이 상단 메뉴의 아이콘을 클릭해도 동일한 화면을 볼 수 있습니다.

프로젝트 생성 후 Virtual Device Manager 클릭하기

2. Virtual Device 생성하기

아래 화면과 같이 표시되어 있는 Create virtual device 또는 Create Device 버튼을 클릭합니다.

Virtual Device 생성 버튼 클릭하

Category에서 고르거나 검색 란에 입력하여 원하는 기종을 선택할 수 있습니다. 저는 Galaxy Nexus를 선택했습니다.

기종 선택하기

이번에는 Android Version을 선택하는 화면입니다. 원하는 버전을 선택합니다.

Android Version 선택하기

Graphics 옵션에는 Hardware - GLES 2.0을 선택합니다. 가상 디바이스가 컴퓨터의 그래픽 카드를 사용하여 렌더링 속도를 향상하는 옵션입니다.

Graphics 옵션 선택하기

Finish 버튼을 클릭하면 가상 디바이스 생성이 완료됩니다. 아주 간단하죠?

3. Virtual Device 실행하기

아래 표시한 Actions 부분의 실행 아이콘을 클릭합니다.

실행 아이콘 클릭하기

Android Emulator 창이 표시되고, 스마트 폰과 같이 익숙한 UI가 보입니다.

Virtual Device가 실행된 모습

Virtual Device 추가하기가 모두 완료됐습니다. 정말 간단하죠?

[DirectX] .Net WinForm에서 GDI+와 SharpDX 사용하기 (예제 포함)

Sat, 10 Jun 2023 10:11:43 +0900

SharpDX vs GDI+

지난 포스팅에서 DirectX와 GDI+의 기본적인 차이점과 SharpDX가 무엇인지 알아보았습니다.

[.Net] DirectX와 GDI+의 차이점, 그리고 SharpDX 이해하기

[DirectX] DirectX와 GDI+의 차이점, 그리고 SharpDX 이해하기

DirectX와 GDI의 차이점 SharpDX를 설명하기 전에, DirectX가 무엇인지 그리고 GDI와 무슨 차이가 있는지부터 알아보겠습니다. 우리가 흔히 알고 있는 GDI(Graphics Device Interface)는 윈도우 운영 체제의 그래

luckygg.tistory.com

간단하게 요약하자면, 2D 이미지 렌더링 기준으로 하드웨어 가속을 지원하냐의 차이점이 있다고 보면 되겠습니다. 이번 포스팅에서는 WinForm 프로젝트에서 SharpDX를 어떻게 사용하는지, 그리고 GDI+ 대비하여 어떤 차이가 있는지 알아보도록 하겠습니다.

따라 하기

예제 코드는 Visual Studio 2022 환경으로 제작했습니다. WinForm에 Picture Box를 추가했고, 선택한 방식(GDI+ 또는 DirectX)에 따라 Picture Box에 이미지를 어떻게 렌더링 하는지 보여줍니다.

WinForm 프로젝트 생성하기

ExamDirectX 이름으로 Windows Forms 앱(.NET Framework)를 생성합니다.

WinForm 프로젝트 생성하기

UI Control 배치하기

아래 그림처럼, UI는 Picture Box와 버튼, 라디오 버튼으로 구성했습니다.

UI 배치

SharpDX NuGet 패키지 설치하기

NuGet 패키지 관리에서 SharpDX를 검색하고 아래의 패키지들을 설치합니다.

NuGet 패키지 설치하기

SharpDX 구현하기

본문 하단에 첨부된 예제 코드에는 MyDirectX.cs 파일이 있습니다. 이 파일에 SharpDX 라이브러리를 어떻게 초기화하고, 파일을 불러오고, 대상 컨트롤에 렌더링 하는지 코드가 구현되어 있습니다. 코드에도 주석으로 설명을 남겨 놓았지만 본문에서도 설명하겠습니다.

각 객체 별 용도

Picture Box는 GDI+ 기반의 컨트롤입니다. DirectX 객체로 해당 컨트롤에 렌더링 하기 위해 아래의 기본 객체들이 사용됩니다.

//DirectX 2D 그래픽 렌더링에 필요한 리소스를 제공
SharpDX.Direct2D1.Factory2 _factory2D = null;

//GPU 하드웨어에 접근하는 인터페이스를 제공
SharpDX.Direct3D11.Device _device = null;

//백 버퍼와 프론트 버퍼를 스왑(ex: 더블 버퍼링)해주는 기능
SharpDX.DXGI.SwapChain _swapChain = null;

//렌더링이 수행되는 타겟
SharpDX.Direct2D1.RenderTarget _renderTarget2D = null;

//DirectX 2D 비트맵
SharpDX.Direct2D1.Bitmap _bitmap = null;

PictureBox 컨트롤과 연동하여 초기화하기

일반적으로 화면에 이미지를 부드럽게 렌더링 하기 위해 더블 버퍼링을 사용합니다. 화면에 보이는 버퍼(프런트 버퍼)와 보여주기 위해 처리하는 버퍼(백 버퍼) 두 개를 의미합니다. 스왑 체인(Swap Chain)은 이 백 버퍼와 프론트 버퍼를 스왑 하여 사용자에게 부드러운 화면을 보여주도록 합니다.

아래의 코드를 수행하면 _renderTarget2D는 PictureBox와 연동됩니다.

public void InitializeControl(PictureBox control)
{
    //스왑 체인에 대한 설정
    var desc = new SwapChainDescription()
    {
        BufferCount = 1, //스왑 체인에 사용될 버퍼의 수
        ModeDescription = new ModeDescription(control.Width, control.Height, new Rational(60, 1), Format.R8G8B8A8_UNorm),
        //Rational: 화면 갱신 속도 1/60
        IsWindowed = true, //스왑 체인이 창 모드에서 동작하도록 설정
        OutputHandle = control.Handle, //출력이 이루어질 창의 핸들
        SampleDescription = new SampleDescription(1, 0), //멀티샘플링의 수준
        SwapEffect = SwapEffect.Discard, //스왑 체인의 스왑 효과. Discard: 스왑 이후 백 버퍼 삭제
        Usage = Usage.RenderTargetOutput //GPU가 이 자원에 그래픽 데이터를 직접 쓸 수 있음을 의미
    };

    _targetWindowSize.Left = 0;
    _targetWindowSize.Top = 0;
    _targetWindowSize.Right = control.Width;
    _targetWindowSize.Bottom = control.Height;

    SharpDX.Direct3D11.Device.CreateWithSwapChain(DriverType.Hardware, DeviceCreationFlags.BgraSupport, desc, out _device, out _swapChain);

    //DirectX 2D 그래픽 렌더링에 필요한 리소스를 만들기 위한 기능을 제공
    _factory2D = new SharpDX.Direct2D1.Factory2();

    //Surface는 그래픽 데이터를 저장하고 그리기 작업을 수행하는 데 사용되는 클래스
    var backBuffer = Surface.FromSwapChain(_swapChain, 0);
    var properties = new RenderTargetProperties(new SharpDX.Direct2D1.PixelFormat(Format.Unknown, SharpDX.Direct2D1.AlphaMode.Premultiplied));

    _renderTarget2D = new RenderTarget(_factory2D, backBuffer, properties);
}

파일로부터 SharpDX 비트맵 생성하기

WIC(windows Imaging Component)를 사용하여 이미지 파일을 불러온 후 렌더링 타깃에 사용할 수 있는 Direct2D 비트맵으로 생성합니다.

public void LoadBitmap(string filename)
{
    //Bitmap 디코더/인코더, 포맷 변경, 스케일러 등 지원
    var wicFactory = new SharpDX.WIC.ImagingFactory2();

    //파일로부터 이미지 불러오기
    var wicDecoder = new SharpDX.WIC.BitmapDecoder(wicFactory, filename, SharpDX.WIC.DecodeOptions.CacheOnDemand);

    //파일로부터 불러온 디코더의 첫 프레임 가져오기
    //이미지 파일은 하나의 프레임이지만, GIF의 경우 여러 프레임
    var wicFrame = wicDecoder.GetFrame(0);

    //포맷 컨버터 생성 및 초기화
    var converter = new SharpDX.WIC.FormatConverter(wicFactory);
    converter.Initialize(wicFrame, SharpDX.WIC.PixelFormat.Format32bppPRGBA);

    //변환된 이미지 데이터를 Direct2D 비트맵으로 변환
    _bitmap = SharpDX.Direct2D1.Bitmap.FromWicBitmap(_renderTarget2D, converter);

    //객체 소멸
    converter.Dispose();
    wicFrame.Dispose();
    wicDecoder.Dispose();
    wicFactory.Dispose();
}

화면에 그리기

화면에 그리기 위해 아래의 코드가 수행됩니다. 특히 마지막 라인의 코드가 중요한데요. Present 함수를 호출해야 화면에 보입니다. 첫 번째 인자는 모니터의 리프레시 속도(VSync)와 동기화하는 인자입니다. 0은 즉시 화면에 표시하고, 1은 모니터의 갱신 속도와 동기를 맞춥니다. 두 번째 인자는 VSync와 관련하여 동작을 설정하는 플래그입니다. 특정 효과를 얻고 싶다면 플래그를 설정하면 되지만 성능 저하나 오류가 발생할 수 있으니 잘 알고 사용해야 합니다.

public void Render()
{
    //렌더링 작업 시작
    _renderTarget2D.BeginDraw();

    //렌더링 화면 비우기(특정 색상 채우기 가능)
    _renderTarget2D.Clear(new SharpDX.Mathematics.Interop.RawColor4(1.0f, 1.0f, 1.0f, 1.0f));

    //1:1 비율로 그리기
    //_renderTarget2D.DrawBitmap(_bitmap, 1.0f, SharpDX.Direct2D1.BitmapInterpolationMode.Linear);

    //렌더링 타겟에 채워서 그리기
    _renderTarget2D.DrawBitmap(_bitmap, _targetWindowSize, 1.0f, SharpDX.Direct2D1.BitmapInterpolationMode.Linear);

    //렌더링 작업 종료
    _renderTarget2D.EndDraw();

    //스왑 체인의 렌더링 이미지를 화면에 표시하는 역할
    _swapChain.Present(1, PresentFlags.None);
}

객체 소멸

더 이상 사용하지 않는 객체는 소멸합니다.

public void Dispose()
{
    _renderTarget2D?.Dispose();
    _renderTarget2D = null;

    _swapChain?.Dispose();
    _swapChain = null;

    _device?.Dispose();
    _device = null;

    _factory2D?.Dispose();
    _factory2D = null;

    _bitmap?.Dispose();
    _bitmap = null;
}

버튼 동작

라디오 버튼으로 GDI+ 또는 DirectX를 선택한 후 실행 버튼을 클릭하면 각 방식 별 렌더링을 위한 스레드 함수가 동작합니다. CPU 및 GPU 사용율을 확인하기 위해 500회 반복하도록 구현했습니다.

private void btnLoad_Click(object sender, EventArgs e)
{
    try
    {
        OpenFileDialog dlg = new OpenFileDialog();
        if(dlg.ShowDialog() == DialogResult.OK)
        {
            Thread thread = null;
            if (rbtnDirectX.Checked == true)
            {
                _directX.LoadBitmap(dlg.FileName);
                thread = new Thread(threadFuncDirectX);
            }
            else
            {
                _bitmap = new Bitmap(dlg.FileName);
                //...

                thread = new Thread(threadFuncGDI);
            }
            thread.Start();
        }
    }
    catch (Exception exc)
    {
        MessageBox.Show(exc.Message);
    }
}

private void threadFuncDirectX()
{
    for (int i = 0; i < 500; i++)
    {
        Thread.Sleep(30);
        _directX.Render();
    }
}

private void threadFuncGDI()
{
    for (int i = 0; i < 500; i++)
    {
        Thread.Sleep(30);
        _graphics.DrawImage(_bitmap, new Rectangle(0, 0, pbView.Width, pbView.Height));
    }
}

동작 결과

인터넷에서 고해상도 이미지를 다운받습니다. 저는 24MB의 고해상도 이미지를 사용했습니다.

GDI+로 동작하면 CPU 부하가 약 10%까지 증가합니다. GPU는 사용하지 않으므로 따로 사용량이 없습니다.

GDI+ 동작 성능

반면, DirectX로 동작하면 CPU 부하가 거의 없으며 GPU 사용량이 증가합니다.

DirectX 동작 성능

전체 코드는 아래 첨부된 예제 파일을 참고하세요.

ExamDirectX.zip

12.28MB

[DirectX] DirectX와 GDI+의 차이점, 그리고 SharpDX 이해하기

Tue, 6 Jun 2023 14:44:06 +0900

DirectX와 GDI의 차이점

SharpDX를 설명하기 전에, DirectX가 무엇인지 그리고 GDI와 무슨 차이가 있는지부터 알아보겠습니다.

우리가 흔히 알고 있는 GDI(Graphics Device Interface)는 윈도우 운영 체제의 그래픽 라이브러리로, 도형(직선, 사각형, 원형 등) 또는 문자열, 이미지 등을 그릴 수 있습니다. 그리고 이보다 더 진보된 기술이 GDI+이며, GDI보다 더 다양한 그래픽 렌더링 기능을 지원합니다. 주요 특징으로, GDI는 CPU에서 수행되다 보니 하드웨어 가속을 지원하지 않습니다.

DirectX는 게임, 멀티미디어 및 그래픽 응용 프로그램에서 사용되는 라이브러리입니다. 기본적인 입력 장치(키보드, 마우스 등)와 사운드 출력, 2차원뿐만 아니라 3차원 렌더링 기능도 지원합니다. 또한 GDI와 다르게 하드웨어 가속을 지원하여 높은 품질의 그래픽 렌더링이 가능합니다.

두 라이브러리의 계층적인 차이를 보면 다음과 같습니다.

GDI와 DirectX 계층

GDI는 커널 모드에서, DirectX는 사용자 모드에서 실행됩니다. 일반적으로 커널 모드에서 실행되는 코드가 하드웨어와 직접적으로 상호작용하여 사용자 모드보다 더 빠르게 실행됩니다. 단순히 이미지 자체만 렌더링 한다면 GDI가 더 빠를 수 있지만, 특수한 조건(좀 더 복잡한 그래픽 처리)에서는 DirectX의 성능이 높을 수 있습니다. 따라서, 어떤 목적으로 그래픽을 처리할 것인가에 따라 적절한 라이브러리를 선택해야 합니다.

DirectX 구성 요소

DirectX가 여러 분야로 지원하다 보니, DirectX에는 다양한 구성 요소가 있습니다. 그중 대표적인 것 몇 개만 나열하면 다음과 같습니다.

Direct2D: 2D 그래픽을 위한 API(기존 GDI/GDI+ 대체)
Direct3D: 3D 그래픽을 위한 API
DirectWrite: 텍스트 렌더링을 위한 API

SharpDX란?

이제 본론으로 왔습니다. SharpDX란, DirectX API를 .Net에 사용할 수 있도록 래핑 된 라이브러리입니다. 즉, C#에서 DirectX를 쉽게 사용하기 위한 라이브러리라고 이해하면 되겠습니다.

http://sharpdx.org/

Home | SharpDX

SharpDX is an open-source managed .NET wrapper of the DirectX API. NOTE: As of 29 Mar 2019, SharpDX is no longer being under development or maintenance SharpDX has been around for almost 9 years, the project is relatively stable and has been used by many p

sharpdx.org

SharpDX에서 제공하는 API 종류는 다음과 같습니다.

3D 그래픽: Direct3D9+, Direct3D11+, Direct3D12+
2D 그래픽: Direct2D1+, DirectWrite+, WIC
그래픽 코어: DXGI+, MediaFoundation, DirectComposition, DirectManipulation, Animation
사운드: DirectSound, XAudio, X3DAudio
입력: DirectInput, RawInput, XInput

참고로, SharpDX는 2019년 3월 29일부로 더 이상 개발 및 유지 관리가 되지 않습니다. 기술 리더와 커뮤니티 참여가 부족하여 더 이상 개발되지 않는다고 하는군요. 하지만 NuGet에서는 다운로드가 가능하며, 여전히 사용하는 데에는 문제가 없습니다. 만약, 최신 버전의 DirectX를 .Net에서 사용하고 싶다면 직접 래핑하여 사용해야 합니다.

다음 포스팅에서는 .Net WinForm 프로젝트에서 SharpDX를 어떻게 사용하는지, 그리고 GDI+와 비교하여 얼마나 성능 차이가 나는지 알아보겠습니다.

메모리와 CPU 부하율을 모니터링하는 Process Manager v2023.05.31, 무료 배포합니다!

Wed, 31 May 2023 22:35:51 +0900

프로그램을 개발하고 나면 정상적으로 동작하는지, 문제는 없는지, 에러가 발생하더라도 예외처리가 되는지 등의 검증은 꼭 필요합니다. 그리고 배포 후 문제가 발생하더라도 어느 부분이 문제였는지 추적이 가능해야 합니다. 최소한의 검증도 없이 배포하면 유지보수 시 정말 골치가 아파집니다. 그런데 메모리 누수 또는 불필요하게 CPU 부하율이 높아지지는 않는지도 점검하고 있나요?

사실 저는 메모리 누수와 CPU 부하율까지 꼼꼼하게 점검하지는 않았습니다. 당연히 문제없겠지 하고 너무 간과한 부분이죠. 그런데 가끔 특정 프로그램의 메모리 누수와 CPU 부하율을 점검해야 하는 일이 있곤 합니다. 그럴 때마다 하는 방법이 작업 관리자를 열고, 특정 프로세스의 상태(메모리, CPU)를 주기적으로 캡처하는 것입니다. 또는 퇴근하기 전에, 출근한 후 캡처하여 비교하는 것이죠. 여간 귀찮은 일이 아닙니다.

그래서 만든 것이 Process Manager 프로그램입니다. 실행 중인 특정 프로세스의 메모리 사용 상태와 CPU 부하율을 주기적으로 확인하여 로그를 남기는 것이죠. 별거 아니지만 막상 사용해 보면 정말 편리합니다.

프로그램 소개

동작 화면

프로그램 특징

시스템의 모든 프로세스 정보 표시
모니터링이 필요한 다수의 프로세스 등록 지원
등록된 프로세스의 메모리 사용량과 CPU 부하율 점검
- 작업 집합: 전체 사용 중인 메모리 양
- 최고 작업 집합: 작업 집합 중 최대 치
- 메모리(개인): 다른 프로세스와 공유할 수 없는 메모리 양
특정 시간(2초~6시간, 또는 지정된 분 단위)을 주기로 점검
CSV 및 스크린 샷 저장 지원
CPU 사용량 및 메모리 사용량을 시각화하기 위한 그래프 기능 지원

프로그램 다운로드

OneDrive로 파일을 첨부했습니다. 아래 링크에서 다운로드하세요.

★★다운로드(OneDrive 링크)★★

업데이트 이력

업데이트 이력은 아래 '더보기' 버튼을 클릭하여 확인할 수 있습니다.

v2023.05.31

그래프 기능이 추가됐습니다.
다수의 프로세스를 등록하면, 선택된 프로세스에 따라 데이터와 그래프가 표시됩니다.

v2023.03.21

결과 저장 시 열이 어긋나는 증상을 해결했습니다.

v2022.12.6

버전 표기 방식이 변경됐습니다.
CPU 사용량 체크가 안정화 됐습니다.
메모리 표기가 잘못된 점을 개선했습니다.
자동 스크롤 기능을 추가했습니다.
모니터링 작업 중 CSV 결과를 저장할 수 있도록 수정했습니다.
프로그램을 최적화 했습니다.

v1.3

모니터링 주기 10분 설정 시 프로그램 종료되는 버그 수정.

v1.2

모니터링 중 프로세스가 종료되었을 경우, 모니터링이 중단되도록 수정했습니다.
모니터링 중 작업을 중단할 경우, 즉시 중단되도록 수정했습니다.
모니터링 결과를 실시간으로 저장할 수 있도록 저장 옵션을 추가했습니다.
모니터링 화면을 실시간으로 캡쳐할 수 있도록 저장 옵션을 추가했습니다.

v1.1

모니터링 시작 시 현재 프로세스 목록에 등록된 모니터링 프로세스가 존재하는지 확인하는 기능을 추가했습니다.

v1.0

정식 버전 배포.

프로그램 사용 방법

프로그램 사용 방법은 아래 '더보기' 버튼을 클릭하여 확인하세요.

프로세스 등록하기

특정 프로세스를 모니터링하기 위해 프로세스 등록 과정이 필요합니다. 아래 그림처럼 프로세스 목록에서 모니터링이 필요한 프로세스의 이름을 입력합니다. 리스트에 필터링된 프로세스를 선택하고 '등록' 버튼을 클릭합니다.

모니터링 주기 설정

'옵션...' 버튼을 클릭하면 모니터링 주기 옵션 창이 표시되며, 이곳에서 주기를 설정할 수 있습니다.

아래 이미지와 같은 창이 표시되면 5초~6시간 또는 기타를 선택하여 분 단위로 입력할 수 있습니다.

모니터링 시작과 종료

화면 중간에 있는 '시작' 버튼과 '종료' 버튼을 클릭하여 모니터링을 시작, 종료할 수 있습니다.

모니터링 결과 CSV로 저장하기

모니터링이 끝나면 화면에 보이는 결과를 CSV 파일로 저장할 수 있습니다. 아래에 표시한 '결과 저장' 버튼을 클릭합니다.

옵션에 지정된 저장 경로에 모니터링 결과가 자동으로 저장됩니다.

저장이 완료되면 아래와 같이 알림 창이 표시됩니다.

결과는 아래와 같이 표시됩니다.

CSV 저장 결과

모니터링 결과 실시간으로 저장하기

옵션 창에서 모니터링 기록의 저장하기를 체크하면, 정해진 주기마다 지정된 파일이름으로 모니터링 기록이 저장됩니다. 주기는 30초부터 6시간까지 또는 사용자가 지정한 시간(분 단위)으로 설정할 수 있습니다.

모니터링 저장 옵션

모니터 화면을 실시간으로 저장하기

옵션 창에서 화면 캡처 저장의 저장하기를 체크하면, 정해진 주기마다 프로세스 또는 전체 화면이 저장됩니다. 주기는 30초부터 6시간까지 또는 사용자가 지정한 시간(분 단위)으로 설정할 수 있습니다.
프로세스의 경우, 모니터링 목록에 등록된 모든 프로세스가 캡처됩니다.

화면 캡쳐 저장 옵션

그래프 보기

시간이 지남에 따라 CPU 부하와 메모리 사용량이 엑셀처럼 표시됩니다. 하지만 너무 많이 쌓이면 추이를 보기가 어려운 단점이 있습니다. 이를 해결하기 위해 그래프 기능을 추가했습니다.

아래와 같이 그래프 보기 항목을 체크합니다.

그래프 보기 옵션

그래프에는 시간의 흐름에 따른 데이터가 표시되어 추이를 한눈에 볼 수 있습니다. 해당 그래프는 ScottPlot이라는 오픈 소스 라이브러리를 사용했습니다.

그래프 표시 화면

프로그램 주의 사항

프로그램 실행 시 프로세스 정보를 불러오는 과정에서 조금 시간이 걸릴 수 있습니다.
데이터 표시 부분은 1초 간격으로 갱신됩니다. 데이터 표시 부분의 스크롤 이동이나 키보드 방향 이동 시 갱신과 겹치면 버벅거리는 것처럼 느껴질 수 있습니다.
그래프도 1초 간격으로 갱신됩니다. 그래프 조작(확대, 축소, 이동 등) 중 갱신이되면 첫 모습으로 돌아가기 때문에 동작이 충돌됩니다. 이 경우에는 일시 중지 항목을 체크하여 업데이트를 잠시 멈추고 조작하면 되겠습니다.

그래프 갱신 일시 중지하기

버그 신고 또는 개선 사항 요청 방법

프로그램 사용 중 문제가 발생하면 댓글로 신고 부탁드립니다. 또는 개선 사항을 요청하셔도 좋습니다.

[OpenCV] VTK 9.0.0과 OpenCV 4.4.0으로 viz 모듈 포함하여 빌드하기!

Sat, 15 Apr 2023 19:23:56 +0900

viz 모듈이란

OpenCV에서 제공하는 3D 가시화(Visualization) 라이브러리를 의미합니다. 또한, 위젯을 표시하는 데 사용되며 위젯과 상호 작용하는 여러 함수들을 제공합니다. 예를 들면, 선, 포인트, 바운딩 박스, 문자열 등을 그리는 작업이 가능합니다.

그런데 OpenCV는 기본적으로 viz를 제공하지 않습니다. 사용자가 직접 VTK 라이브러리를 사용하여 viz 모듈이 포함된 OpenCV 라이브러리를 생성해야 합니다. 이 과정이 꽤 시간이 걸리고 복잡한데요.

이번 포스팅을 통해 어떻게 viz 모듈이 포함된 OpenCV 라이브러리를 빌드하는지 소개하겠습니다.

준비 사항

1. VTK 8.2.0 또는 9.0.0 Source 파일을 준비합니다.
다운로드 링크: vtk.org/download/ 또는 https://github.com/Kitware/VTK/releases

2. OpenCV 4.4.0 Source 파일을 준비합니다.
다운로드 링크: https://opencv.org/releases/

3. OpenCV-contrib 4.4.0 source 파일을 준비합니다.
다운로드 링크: https://github.com/opencv/opencv_contrib/releases

4. CMake 설치 파일을 준비합니다.
다운로드 링크: https://cmake.org/download/

CMake는 라이브러리 소스 파일을 빌드하여 개발 환경에 맞는 라이브러리를 생성하는 용도입니다. CMake 설치방법은 아래 글을 참고해주세요.

[CMake] CMake 설치하기

CMake는 사용자가 원하는 개발환경의 라이브러리 생성을 도와주는 오픈 소스 도구입니다. OpenCV나 VTK 혹은 각 제조사에서 제공하는 SDK를 개발환경에 따라 라이브러리를 새로 생성할 때 사용됩니��

luckygg.tistory.com

주의

OpenCV-contrib를 사용하여 viz 모듈을 생성할 수 있는데요. OpenCV-contrib viz 모듈은 VTK 8.90.0 까지만 호환되는 것 같습니다. 만약, 공식적인 버전으로 빌드하고 싶다면 VTK 8.2.0을, VTK 9.0.0이 괜찮다면 본문의 순서대로 따라 하면 되겠습니다.

1. VTK 빌드하기

VTK 라이브러리부터 빌드를 시작합니다. VTK 8.2.0 또는 9.0.0 source 파일을 준비하고 압축을 해제합니다. 본문에서는 VTK 9.0.0을 사용했습니다.

CMake에서 VTK 경로 설정

항목	설명
Where is the source code	VTK의 소스 파일 경로를 지정합니다.
Where to build the binaries	빌드 된 바이너리 파일들이 생성되는 경로를 지정합니다. 본문에서는 vtk_bin이라는 폴더를 생성해서 지정했습니다.

Configure 버튼을 클릭하면 아래와 같이 개발 환경을 선택하는 창이 표시됩니다. 컴파일러 버전과 OS 비트 버전을 선택합니다.

개발 환경 선택 화면

Finish 버튼을 클릭하면 라이브러리 생성을 위한 준비 과정이 시작됩니다. 조금 기다리고 나면 아래와 같은 화면이 표시됩니다.

빌드 옵션 선택 화면

기본적인 옵션은 다음과 같습니다.

항목	설명
VTK_BUILD_EXAMPLE	예제 프로그램 생성 선택 옵션입니다. 해제합니다.
BUILD_SHARED_LIBS	공유 또는 정적 라이브러리 생성 선택 옵션입니다. 필요한대로 선택합니다.
VTK_BUILD_TESTING	VTK_BUILD_EXAMPLE과 더불어 해당 옵션을 해제하면 빌드 속도가 향상됩니다. 굳이 체크하지 않아도 됩니다.

그리고 Generate 버튼을 클릭하면 binaries 경로에 아래와 같은 파일들이 생성됩니다.

생성된 바이너리 파일

~~OpenCV viz 모듈을 생성하기 위해서 VTK는 여기까지 진행하면 됩니다. 만약, VTK 라이브러리를 생성하고 싶다면 아래 링크를 참고하세요.~~

VTK 라이브러리도 아래를 참고하여 빌드를 완료해 주세요.

[VTK] VTK 8.2 및 Visual Studio 2015 환경 구성

VTK를 사용하기 위해서는 준비 과정이 다소 길고 복잡합니다. 본 글에서는 차례차례 쉽게 따라 할 수 있도록 정리해 보았습니다. ※ 2019년 7월 3일 추가 혹시 아래 빌드 과정이 안 되는 분들을 위��

luckygg.tistory.com

2. OpenCV-contrib 수정하기

앞에서 얘기한대로, OpenCV-contrib 4.4.0은 VTK 8.90.0까지 호환되는 것으로 보입니다. 그 이유로는, 아래 경로의 파일에 VTK 버전이 8.90.0으로 표기돼있습니다.

opencv_contrib-4.4.0\modules\viz\CMakeList.txt

CMakeList에 표기되어 있는 VTK 버전

이게 정확히 8.90.0까지만 호환된다는 의미인지는 모르겠습니다만, 강제로 아래와 같이 변경하면 VTK 9.0.0으로 viz 모듈을 생성할 수 있습니다.

CMakeList에 VTK 버전을 수정

같은 방법으로 VTK 9.0.1도 해봤으나 CMake에서 빌드 시 에러가 발생합니다. 여기까지 수정이 완료되면 OpenCV-contrib 준비도 끝납니다.

3. OpenCV 빌드하기

이제 본격적으로 CMake에서 OpenCV를 빌드합니다. VTK와 마찬가지로 OpenCV 4.4.0 source 파일을 준비하고 binary 파일이 생성되는 경로도 지정합니다.

OpenCV source 및 binary 경로 지정

Configure 버튼을 클릭하여 개발 환경을 입력합니다.

개발 환경 선택 화면

Finish 버튼을 클릭하면 라이브러리 생성을 위한 준비 과정이 시작됩니다. 조금 기다리고 나면 아래와 같은 화면이 표시됩니다.

빌드 옵션 선택 화면

이제 다음의 옵션들을 입력해야 합니다.

항목	설명
OPENCV_EXTRA_MODULES_PATH	opencv_contrib-4.4.0\modules 경로를 설정합니다.
BUILD_SHARED_LIBS	공유 또는 정적 라이브러리 생성 선택 옵션입니다. 본문에서는 체크하여 공유 라이브러리로 생성했습니다.
VTK_DIR	~~VTK binary 경로를 설정합니다. 본문에서는 vtk_bin 폴더에 이미 생성했습니다.~~ 빌드된 VTK 라이브러리 경로를 설정합니다.
WITH_VTK	체크합니다.

Generate 버튼을 클릭하고 나면 아래와 같이 화면이 표시됩니다.

Generate 이후 모습

Binary 생성 경로를 보면 아래와 같이 파일들이 생성되어 있습니다.

생성된 바이너리 파일

이제 Binary 폴더의 OpenCV.sln 파일을 실행합니다. 주의할 점은 반드시 Visual Studio를 관리자 권한으로 실행해야 합니다.

OpenCV.sln 실행 모습

ALL_BUILD와 INSTALL을 차례대로 빌드합니다. 빌드가 끝나면 opencv_bin/install 경로에 라이브러리 파일이 생성되어 있습니다. Debug 및 Release 모드로 같은 방식으로 빌드합니다.

debug\include\opencv2에 viz 폴더가 있고, 그 안에 viz 관련 코드가 생성된 것을 확인할 수 있습니다.

생성된 viz 모듈

결론

저는 처음에 며칠동안 헤매고 인터넷에서 온갖 정보를 참고하여 결국에 OpenCV viz 모듈 생성에 성공했습니다. 편하게 누군가가 제공해주면 쉽겠지만, 이렇게 시도해 본 것도 좋은 경험인 것 같습니다. 이 글이 누군가에게 도움이 되었으면 하네요.

[.Net] 지연(Delay) 함수들의 특징과 차이점 정리

Mon, 9 Jan 2023 21:30:29 +0900

지연(Delay) 함수

프로그램을 개발하다 보면 단발성으로 실행하는 스레드 함수가 있고, 프로그램이 시작된 후 종료되기 직전까지 실행되는 스레드 함수가 있습니다. 그리고 후자의 경우에는 스레드 함수 내에 반복문을 넣어서 구현됩니다. 그런데 이 반복문에 지연(Delay) 함수를 넣지 않으면 과도한 연산으로 인해 CPU 부하가 증가하게 됩니다.

CPU 부하를 낮추기 위해 스레드 함수의 반복문 안에는 Sleep() 함수를 사용하는 것이 일반적입니다. 사실 꼭 스레드 함수의 반복문에만 해당하는 것은 아닙니다. 과도한 반복문 내에는 지연 함수를 사용하지 않으면 CPU 부하가 높아지기 때문입니다.

그런데 지연을 위한 함수로는 Sleep() 뿐만 아니라 AutoResetEvent.WaitOne()도 있고 Task.Delay()도 있습니다. 본문에서는 각 지연 함수에 따른 차이점을 정리해 보았습니다.

지연 함수의 종류

1. Thread.Sleep() 함수

가장 많이 사용하는 함수이죠. 사용하는 방법이 정말 간단합니다. 함수 인자로 밀리미터 시간 또는 TimeSpan 시간을 입력하면 해당 시간만큼 지연됩니다.

public static void Sleep (int millisecondsTimeout);

사용 예시는 다음과 같습니다.

using System;
using System.Threading;

class Example
{
    static void Main()
    {
        for (int i = 0; i < 5; i++)
        {
            Console.WriteLine("Sleep for 2 seconds.");
            Thread.Sleep(2000);
        }

        Console.WriteLine("Main thread exits.");
    }
}

/* 예제 실행 결과:

Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Sleep for 2 seconds.
Main thread exits.
 */

MSDN 문서는 아래 링크를 참고하세요.

https://learn.microsoft.com/ko-kr/dotnet/api/system.threading.thread.sleep?view=net-7.0

Thread.Sleep 메서드 (System.Threading)

지정된 시간 동안 현재 스레드를 일시 중단합니다.

learn.microsoft.com

2. WaitHandle.WaitOne() 함수

이 함수는 WaitHandle이 Set()이 될 때까지 스레드를 차단하는 동작을 합니다. 함수 인자는 Sleep() 함수와 마찬가지로, 밀리미터 시간 또는 TimeSpan 시간을 입력합니다.

하지만 동작은 Sleep()과 다릅니다. 타임아웃 시간 내에 WaitHandle이 Set이 되면, 타임아웃까지 기다리지 않고 바로 다음 코드를 실행합니다.

public virtual bool WaitOne ();

예제 코드도 보겠습니다.

using System;
using System.Threading;

class WaitOne
{
    static AutoResetEvent autoEvent = new AutoResetEvent(false);

    static void Main()
    {
        Console.WriteLine("Main starting.");

        ThreadPool.QueueUserWorkItem(
            new WaitCallback(WorkMethod), autoEvent);

        // autoEvent가 Set이 될 때까지 기다림
        autoEvent.WaitOne();
        Console.WriteLine("Work method signaled.\nMain ending.");
    }

    static void WorkMethod(object stateInfo) 
    {
        Console.WriteLine("Work starting.");

        //랜덤한 시간 대기
        Thread.Sleep(new Random().Next(100, 2000));

        //대기 후 autoEvent를 Set 합니다
        Console.WriteLine("Work ending.");
        ((AutoResetEvent)stateInfo).Set();
    }
}

MSDN 문서는 아래 링크를 참고하세요.

https://learn.microsoft.com/ko-kr/dotnet/api/system.threading.waithandle.waitone?view=net-7.0

WaitHandle.WaitOne 메서드 (System.Threading)

현재 WaitHandle이(가) 신호를 받을 때까지 현재 스레드를 차단합니다.

learn.microsoft.com

3. Task.Delay() 함수

이 함수는 비동기 함수로, Task와 async/await 키워드와 같이 설명하기에는 내용이 너무 많으므로, Delay() 함수에 대해서만 다루겠습니다.

기본적으로 해당 함수의 형태는 다음과 같습니다. 인자로 밀리미터 시간을 입력하는 것이 모두 비슷합니다.

public static System.Threading.Tasks.Task Delay (int millisecondsDelay);

코드 예시는 다음과 같습니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine($"{DateTime.Now.ToString("T")} Wait 시작!");
            Task.Delay(5000).Wait();
            Console.WriteLine($"{DateTime.Now.ToString("T")} Wait 종료!");
        }
    }
}

Task.Delay().Wait()를 사용하면 해당 코드 부분에서 설정된 시간만큼 지연됩니다. 해당 함수의 MSDN 문서는 아래 링크를 참고하세요.

https://learn.microsoft.com/ko-kr/dotnet/api/system.threading.tasks.task.delay?view=net-7.0

Task.Delay 메서드 (System.Threading.Tasks)

시간 지연 후 완료되는 작업을 만듭니다.

learn.microsoft.com

정리

각 지연 함수의 인자로 밀리미터 시간을 넣어 사용한다는 측면에서는 모두 동작이 동일해 보입니다. 그럼 어느 상황에서 어떻게 사용해야 하는 걸까요?

1. 대략적인 시간으로 지연하고 싶을 때

Sleep() 함수는 높은 정밀도를 갖고 있지 않습니다. 하지만 초 단위 이상으로 대략적인 지연이 필요하거나 CPU 부하를 억제하기 위함이라면 Sleep() 함수를 사용합니다.

2. 비동기적으로 시퀀스에 따라 지연하고 싶을 때

제어를 위한 시퀀스 루프 내에서 동기화를 위한 지연이 필요하다면 WaitHandle을 사용합니다.

예를 들어, 외부에서 전기적 신호가 입력되면 스테이지를 이동해야 하는 상황을 가정하겠습니다. 만약, 시퀀스 루프 내에 Sleep()을 사용하면 지정된 시간만큼 블러킹 되어 응답이 늦어질 수 있습니다. 하지만 WaitHandle.WaitOne()을 사용한다면 이벤트가 Set이 되어 즉각 반응할 수 있습니다.

물론 이 예시도 여러 조건에 따라 적합하냐는 따져봐야 하지만, 기본적으로 Sleep()과 WaitHandle 중 어느 것을 사용할 것인지 판단하는 기준이 될 수 있습니다.

참고 자료

https://blog.rogatnev.net/posts/2017/10/Sleep-well.html

[Wireshark] PcapPlusPlus로 실시간 패킷 감지하기(예제 포함)

Wed, 4 Jan 2023 22:29:00 +0900

PcapPlusPlus를 사용하기 위한 준비 단계는 아래 링크를 참고하세요.

[Wireshark] Visual Studio에서 PcapPlusPlus 사용을 위한 준비 단계와 예제 코드 실행하기

예제 프로젝트 목표

본문의 예제 프로젝트의 목표는 다음과 같습니다. 항목 별로 차근차근 구현해 보겠습니다.

실시간 감지가 필요한 네트워크 어댑터를 선택하기
선택된 네트워크 어댑터로 들어오는 실시간 패킷을 콘솔 창에 보여주기
해당 패킷을 pcapng 파일로 저장하기

1. 네트워크 어댑터 목록 얻기

와이어샤크를 실행하면 제일 먼저 보이는 것이 어댑터 목록입니다. 어댑터를 선택하고 열게 되면 캡처가 시작되지요.

와이어샤크의 캡쳐 목록

PcapPlusPlus로 네트워크 목록을 얻는 방법은 아주 쉽습니다.

#include <PcapLiveDevice.h>
#include <PcapLiveDeviceList.h>

std::cout << "===== Device List =====" << std::endl;
int index = 0;
//auto 타입은 std::vector<pcpp::PcapLiveDevice*> 입니다.	
auto list = pcpp::PcapLiveDeviceList::getInstance().getPcapLiveDevicesList();
for (const auto& dev : list)
{
	std::cout << "[" << index++ << "] " << dev->getDesc() << std::endl;
}

위와 같이 사용하여 얻어진 목록을 콘솔 창에 출력하면 다음과 같습니다.

PcapPlusPlus로 얻어진 네트워크 목록

2. 어댑터 열고 닫기

목록에서 얻어진 PcapLiveDevice 객체의 open() 함수로 어댑터를 열 수 있습니다. 만약, 타임아웃이나 버퍼 크기, 무차별모드(Promiscuous mode) 등을 설정하기 원한다면, DeviceConfiguration을 인자로 넘겨 설정과 동시에 열 수 있습니다.

pcpp::PcapLiveDevice* dev;
//Select capture device
dev->open();
//or
pcpp::PcapLiveDevice::DeviceConfiguration config;
config.mode = pcpp::PcapLiveDevice::DeviceMode::Promiscuous;
config.packetBufferTimeoutMs = 1000;
dev->open(config);

캡처가 끝났다면, 간단하게 close()를 호출하여 닫을 수 있습니다.

dev->close();

3. 캡처 시작하고 멈추기

어댑터를 열었다면, 패킷을 획득하기 위해 캡처 시작을 해야 합니다. 캡처를 시작하는 함수는 startCapture()로, 4개의 오버로딩 함수를 지원합니다. 특별한 목적이 없다면, 사용하기 쉬운 기본형을 선택합니다. 패킷이 캡처될 때마다 콜백 함수가 호출되는 동작입니다.

startCapture 기본 함수

캡처를 정지하려면 간단하게 stopCapture()를 호출하면 됩니다.

//어댑터에서 패킷이 획득될 때 콜백 함수가 호출됩니다.
void packetArrives(pcpp::RawPacket* rawPacket, pcpp::PcapLiveDevice* dev, void* cookie)
{
	//rawPacket에는 획득된 정보가 담겨있습니다.
}

//...
dev->startCapture(packetArrives, nullptr);

//...
dev->stopCapture();

4. 캡처된 패킷 분석하기

캡처된 RawPacket에는 와이어샤크에서 보이는 모든 정보가 동일하게 담겨있습니다. pcpp::Packet 객체로 변환하여 각 레이어의 정보를 얻을 수 있습니다.

void packetArrives(pcpp::RawPacket* rawPacket, pcpp::PcapLiveDevice* dev, void* cookie)
{
    pcpp::Packet packet(rawPacket);
}

예를 들어, 다음의 정보를 얻을 수 있습니다.

패킷의 총길이
프로토콜 타입
Source IP, Destination IP Address 및 Port
체크섬 계산
Payload 데이터
TCP Flag 등

이 외에 직접 데이터 편집이 필요하다면, Data Pointer를 얻어 확인할 수 있습니다.

5. 패킷 기록하기(Dump)

PcapPlusPlus도 와이어샤크처럼 캡처된 패킷을 pcap 또는 pcapng 파일로 저장할 수 있습니다.

#include <PcapFileDevice.h>

pcpp::PcapFileWriterDevice dumper("test.pcapng");
dumper.open();

//...
dumper.writePacket(rawPacket);
//...

dumper.close();

만약, 이미 저장된 파일을 불러와 기록된 패킷을 꺼내고 싶다면 다음의 예제 코드를 참고하세요. pcap과 pcapng 파일의 읽고 쓰기 예시입니다.

//pcap 파일 불러오기
pcpp::PcapFileReaderDevice pcapReader("input.pcap");
pcapReader.open();

//pcapng 파일 생성하기
pcpp::PcapNgFileWriterDevice pcapNgWriter("output.pcapng");
pcapNgWriter.open();

//raw packet 객체
pcpp::RawPacket rawPacket;

//pcap 파일의 패킷을 읽어들인 후 pcapng 파일에 쓰기
while (pcapReader->getNextPacket(rawPacket)) {
  pcapNgWriter.writePacket(rawPacket);
}

pcapNgReader.close();
pcapNgWriter.close();

예제 프로젝트 설명

본문의 예제 프로그램은 네트워크 어댑터에 연결한 후 100개의 패킷을 획득하고 pcapng 파일로 저장하는 동작을 보여줍니다. 용량 문제로, 첨부된 파일에는 npcap과 pcapplusplus 라이브러리 파일은 제외하고 프로젝트 파일만 있습니다.

ExamPcapPlusPlus.zip

0.00MB

예제 프로그램 실행 화면

정리하며

본문에서는 기본적인 사용 방법을 다뤄봤습니다. Pcap++ 라이브러리를 사용하면 패킷 캡처 라이브러리를 자세히 모르더라도 아주 쉽게 접근할 수 있다는 것을 알게 됐습니다. 필요한 기능만 잘 구현한다면 와이어샤크 못지않은 패킷 모니터링이 가능하겠죠?

[Wireshark] Visual Studio에서 PcapPlusPlus 사용을 위한 준비 단계와 예제 코드 실행하기

Mon, 2 Jan 2023 11:12:06 +0900

패킷 캡처를 위한 라이브러리인 Pcap++의 전반적인 소개는 아래 링크를 참고하세요.

[Wireshark] 네트워크 패킷 모니터링은 PcapPlusPlus로 쉽게!

Pcap++ 라이브러리 네트워크 패킷 감지를 위한 라이브러리로는 Unix의 libpcap, Windows의 Npcap과 WinPcap이 대표적입니다. PcapPlusPlus(Pcap++)는 네트워크 패킷을 감지하고 파싱하기 위한 멀티 플랫폼 C++ 라

luckygg.tistory.com

준비 단계

Pcap++를 사용하기 위해서는 몇 가지 준비 단계가 있습니다. 다운로드가 필요한 파일은 링크를 추가했으니 해당 링크를 참고하세요.

1. Visual Studio 버전

Pcap++는 22.11 버전 기준으로 Visual Studio 2015, 2017, 2019를 지원합니다. 이에 맞는 Visual Studio를 준비합니다.

2. WinPcap or Npcap SDK

WinPcap 또는 Npcap SDK를 준비합니다. WinPcap은 지원이 끝났으므로, 본문에서는 Npcap SDK 1.13을 사용했습니다.

3. Visual Studio 2010 재배포 패키지

Microsoft Visual C++ 2010 재배포 패키지를 설치합니다.

4. Pcap++ 라이브러리 및 예제 프로젝트

PcapPlusPlus Github에서 Visual Studio 버전에 맞는 파일을 다운로드합니다. Release 페이지에서 스크롤을 조금 내리면 각 개발환경에 맞는 파일이 있습니다.

PcapPlusPlus Release 화면

개발환경 별 라이브러리 파일

예제 프로젝트 실행하기

본문의 개발 환경은 Windows와 Visual Studio 2019를 사용했습니다. 위 Release 페이지에서 pcapplusplus-22.11-windows-vs2019.zip을 다운로드합니다. 그리고 압축을 해제한 후 pcapplusplus-22.11-windows-vs2019\ExampleProject 경로를 보면 PcapPlusPlusPropertySheet.props 파일이 보입니다.

예제 프로젝트 파일 구성

이 파일을 텍스트 에디터로 불러온 후 다음과 같이 수정합니다.

속성 시트 변경하기

항목	설명
PcapPlusPlusHome	예제 코드가 위치한 경로
PcapSdkHome	준비단계 2에서 다운로드한 WinPcap 또는 Npcap SDK가 위치한 경로

이렇게 저장한 후 ExampleProject.sln 파일을 실행하면 프로젝트가 정상적으로 로드됩니다. 만약, 경로가 다르면 빌드 중 에러가 발생하는데, 위와 같이 속성 시트를 변경하거나 직접 include, lib 경로를 수정해도 상관없습니다.

main.cpp의 예제 코드를 보면 다음과 같습니다.

#include <iostream>
#include <IPv4Layer.h>
#include <Packet.h>
#include <PcapFileDevice.h>

int main(int argc, char* argv[])
{
	// open a pcap file for reading
	pcpp::PcapFileReaderDevice reader("1_packet.pcap");
	if (!reader.open())
	{
		std::cerr << "Error opening the pcap file" << std::endl;
		return 1;
	}

	// read the first (and only) packet from the file
	pcpp::RawPacket rawPacket;
	if (!reader.getNextPacket(rawPacket))
	{
		std::cerr << "Couldn't read the first packet in the file" << std::endl;
		return 1;
	}

	// parse the raw packet into a parsed packet
	pcpp::Packet parsedPacket(&rawPacket);

	// verify the packet is IPv4
	if (parsedPacket.isPacketOfType(pcpp::IPv4))
	{
		// extract source and dest IPs
		pcpp::IPv4Address srcIP = parsedPacket.getLayerOfType<pcpp::IPv4Layer>()->getSrcIPv4Address();
		pcpp::IPv4Address destIP = parsedPacket.getLayerOfType<pcpp::IPv4Layer>()->getDstIPv4Address();

		// print source and dest IPs
		std::cout
			<< "Source IP is '" << srcIP << "'; "
			<< "Dest IP is '" << destIP << "'"
			<< std::endl;
	}

	// close the file
	reader.close();

	return 0;
}

코드만 봐도 동작이 아주 간단합니다. 1_packet.pcap 파일을 불러온 후 packet을 읽어내고, IPv4 타입이라면 Source IP와 Destination IP를 출력하는 것이 다입니다. 한번 실행해 볼까요?

동작 결과

Source IP is '10.0.0.138'; Dest IP is '10.0.0.1'이라는 문자열이 출력되어 있습니다. 와이어샤크로 1_packet.pcap 파일을 열어보면, 실제로 Source IP와 Destination IP가 일치합니다. 즉, 잘 동작했다는 것을 알 수 있습니다.

와이어샤크로 pcap 파일을 열어본 모습

[Wireshark] 네트워크 패킷 모니터링은 PcapPlusPlus로 쉽게!

Fri, 30 Dec 2022 22:48:45 +0900

Pcap++ 라이브러리

PcapPlusPlus

네트워크 패킷 감지를 위한 라이브러리로는 Unix의 libpcap, Windows의 Npcap과 WinPcap이 대표적입니다. PcapPlusPlus(Pcap++)는 네트워크 패킷을 감지하고 파싱하기 위한 멀티 플랫폼 C++ 라이브러리이며, libpcap, Npcap과 같은 널리 사용되는 패킷 처리 엔진을 사용하기 쉽게 C++ Wrapper로 제공하는 것입니다.

참고로, Windows의 WinPcap은 2013년을 마지막으로 더 이상 개발되지 않습니다. 이후로는 Npcap 라이브러리만 지원되며 이에 대한 내용은 아래 링크를 참고하시면 되겠습니다.

https://npcap.com/vs-winpcap.html

Npcap vs WinPcap"

Docs Download Licensing Windows 11 WinPcap WinPcap has been the de facto standard library for packet capture and link-layer packet injection for over a decade. Many open source and commercial network tools use WinPcap for network access and filtering, but

npcap.com

주요 특징

Pcap++ 라이브러리의 주요 특징을 나열해 보겠습니다.

다양한 플랫폼 지원(Windows, Linux, Apple, FreeBSD, Android)
빠른 속도와 적은 오버헤드(벤치마크 자료: https://pcapplusplus.github.io/docs/benchmark)
다양한 프로토콜 지원(목록: https://pcapplusplus.github.io/docs/features#supported-network-protocols)
PCAP 및 PCAPNG 파일 읽기/쓰기 지원
Unlicense 라이선스
Visual Studio 2015~2019 지원(지원 환경: https://pcapplusplus.github.io/docs/platforms)

예시

아래 그림은 특정 네트워크 어댑터에서 캡처되는 실시간 패킷을 보여주고 있습니다. 일반적으로는 Npcap 라이브러리를 사용하여 패킷을 직접 분석해야 하지만, Pcap++ 라이브러리를 사용하면 깊은 지식 없이 바로 패킷 분석이 가능합니다. 그만큼 개발 시간을 줄일 수 있는 장점이 있습니다.

실시간 패킷 모니터링 예시

[C#] 솔루션 탐색기에서 Form이 사라지는 현상 해결 방법

Tue, 27 Dec 2022 21:36:49 +0900

Form이 사라지는 현상

C# WinForm 프로젝트를 사용하던 중 Form이 사라지는 현상이 발생했습니다. 어떻게 사라진다는 건지 한번 보겠습니다. 아래 그림을 보면, Form1.cs 왼쪽에 사각형 아이콘이 보입니다. 그런데 오른쪽과 같이 C# 아이콘으로 변경되었습니다.

솔루션 탐색기에서 아이콘이 변경된 모습

이 상태에서 Form1.cs를 더블 클릭하면 디자인 탭이 보이지 않고 소스 코드만 보입니다. 심지어 이 상태에서는 소스 코드 창에서 '디자이너 보기' 메뉴도 사라집니다.

디자이너 보기 메뉴가 사라진 모습

참 답답하죠? 심지어 비주얼 스튜디오를 재실행하든, 컴퓨터를 재부팅해도 해결되지 않습니다. 하지만 해결 방법은 생각보다 간단합니다.

해결 방법

문제가 있는 프로젝트의 csproj 파일을 텍스트 편집기(메모장)로 엽니다. 그리고 문제가 있는 파일(본문은 Form1.cs)을 찾습니다. 이 파일이 정상이라면 파일 이름 아래에 Form 속성이 있어야 합니다.

<SubType>Form</SubType>

하지만 이 속성이 빠져있으면 본문과 같은 문제가 생기는 것입니다. 결론은, 아래와 같이 파일 이름 아래에 Form 속성을 추가해주면 바로 해결됩니다.

Form 속성을 추가한 모습

문제가 발생한 이유는 모르겠으나, 이렇게 간단하게 해결이 가능합니다. 괜한 시간 낭비하지 마세요~!

손목과 어깨 통증 보호를 위한 새로운 키보드, 마우스 배치 방법

Sun, 25 Dec 2022 22:06:09 +0900

직업병 관리, 1년 동안 효과는?

딱 작년 이맘때 거북목과 손목 통증 관리에 대한 저만의 노하우를 공개한다는 포스팅을 했었습니다.

개발자 직업병 거북목과 손목 통증 관리, 저만의 노하우를 공개합니다

본문 중간에 실제로 구입한 제품이 공개됩니다. 광고가 아니며 공유 차원에서 작성한 것이니 참고하세요. 본문의 건강 지식 관련 내용은 출처를 남겼으며, 자신의 건강 상태는 반드시 전문 병원

luckygg.tistory.com

지난 1년 동안 증상은 어땠을까요? 이런저런 시도를 해봤지만 결과적으로 몸 상태가 더 안 좋아졌습니다 :)

손목은 여전히 아프고, 이제는 가슴 근육과 견갑골까지 통증이 생겨버렸습니다. 역시나 병원에서 CT든 X-Ray든 어떤 검사를 해도 전~혀 문제가 없다고 하는군요.

그렇다면, 결국 1년 동안 관리한 것은 모두 헛수고냐? 그건 아니라고 생각합니다.

어쨌든 컴퓨터에 계속 앉아서 작업하는 시간은 꾸준하고, 이렇게나마 관리를 안 했으면 몸 상태는 지금보다 더 나빠지지 않았을까 생각합니다. 그래도 지난 1년 동안은 운동을 꾸준히 하고, 잦은 스트레칭과 휴식을 취하면서 관리에 힘썼습니다. 이런 노력조차 하지 않았다면 아마 지금보다 더 골병이 들지 않았을까 싶네요.

아무튼, 잡설이 길었습니다. 지난 포스팅에서 언급한 키보드와 마우스를 사용하면서 단점이 확인되었고, 이번 포스팅을 통해 조금 더 개선된 방법을 공유하고자 합니다.

키보드 두 개 활용 방법의 단점

지난 포스팅에서 아래와 같이 키보드 두 개를 활용한 배치를 공유했었습니다.

키보드 두 개를 활용한 방법

이렇게 배치하면 아래 그림처럼, 양 팔의 간격이 자연스럽게 어깨너비로 위치할 수 있습니다. 거기다가 윈도우 자판 배열을 변경하여 단축키 사용 시 양손을 활용하는 방법도 공유했었습니다.

어깨 너비의 양손 키보드

그런데, 이 모든 방법에 단점이 있었습니다.

1. 오른쪽 견갑골 통증

위와 같이 키보드 두 개를 사용하면 양 팔이 어깨너비만큼 벌어진다고 했습니다. 그런데 마우스는 어디에 있을까요? 저는 오른손잡이라 마우스가 오른쪽에 있습니다. 즉, 오른쪽 키보드 옆에 붙어있는데요. 아무리 키보드를 가운데로 당겨놓아도 마우스가 조금 먼 거리에 있습니다.

마우스를 사용하기 위해 오른팔이 조금 더 뻗어진 채로 사용하다 보니, 오른쪽 견갑골이 당기는 통증이 생기더군요. 키보드만 사용하면 자세가 편한데, 마우스를 사용하려니 불편한 통증이 느껴집니다.

2. 불편한 윈도우 자판 배열

윈도우 자판 배열을 변경하면, 사용하는 본인은 익숙해 질지 모르지만 다른 사람은 그렇지 않습니다. 즉, 개인 PC는 괜찮지만 누군가 같이 사용하는 공용 PC는 변경하면 안 되겠죠.

회사 개인 PC는 변경했지만 집에 있는 PC는 와이프랑 같이 사용하다 보니 기본 값을 사용하고 있습니다. 게다가 회사 공용 PC까지 사용하다 보면 키보드 배열이 너무 헷갈리게 됩니다. 이도 저도 안 되는 상황이 되다 보니 결국 자판 배열은 기본 값을 사용하게 됐습니다.

새로운 키보드와 마우스 배치

위의 단점을 겪고 난 후 키보드와 마우스를 새로 구입하여 배치를 변경했습니다. 사진을 볼까요?

키보드 & 마우스 배치 2.0

키보드 두 개를 사용하던 것을 분리형 키보드로, 일반 마우스를 트랙볼 마우스로 변경했습니다.

1. 분리형 키보드 Mistel MD770

분리형 키보드는 각 키보드가 USB 케이블로 연결됩니다. 그리고 PC로 연결되는 USB 케이블이 있습니다. 블루투스 모델도 있다고 하던데, 저는 유선 모델을 사용하고 있습니다.

사실, 애초에 분리형 키보드를 샀어도 되는 거지만 가격과 키보드 B의 위치 때문에 고민을 많이 했었습니다.

웬만한 분리형 키보드는 거의 20만 원으로 가격이 상당히 비싼 편입니다. 그런데 직장 동료가 사용하던 분리형 키보드를 저렴하게 판다기에, 좋은 금액으로 좋은 키보드를 얻게 되었습니다.

그리고 B 키의 위치가 상당히 걱정됐습니다. 제가 찾아본 분리형 키보드의 B 키는 모두 왼쪽에 있었는데요. 우리나라는 B(ㅠ) 키를 입력할 때 보통 오른손 손가락으로 타이핑을 하기 때문에, 분리형 키보드를 사용하면 계속 오른손 손가락이 저절로 책상 위를 치고 있더군요. 하지만 걱정과 달리 바로 익숙해지더군요. 이제는 B 키를 누를 때 자연스럽게 왼손 손가락이 움직여 불편함을 느끼진 못하고 있습니다. 혹시 B 키 때문에 분리형 키보드 구입에 고민이 된다면 괜한 고민이라고 말씀드릴 수 있겠습니다.

2. 트랙볼 마우스 켄싱턴 SlimBlade

트랙볼 마우스의 끝판 왕이라는 켄싱턴 SlimBlade입니다. 가격도 비싸고, 불편하면 끝내 적응하지 못하고 중고로 판매하게 된다고 하는군요. 다행히도, 저에게는 너무나 잘 맞아서 사용하고 있습니다.

이 마우스의 장점은 마우스 커서를 움직이기 위해 손가락만 사용하면 된다는 것입니다. 일반 마우스는 커서를 많이 움직일 때 팔이 같이 움직이게 되는데요. 트랙볼 마우스는 손가락으로 트랙볼을 굴리면 되기 때문에 팔이 움직일 일이 없습니다.

게다가 굴리는 속도에 따라 커서 속도가 결정되므로, 먼 거리의 커서를 움직일 때 더욱 편리합니다.

그리고 트랙볼을 수평 방향으로 굴리면 화면의 스크롤을 제어하게 되는데요. 이것 역시 굴리는 속도에 따라 스크롤을 움직일 수 있어 편리합니다. 게다가 켄싱턴 특유의 '디리리릭' 소리가 더욱 매력적입니다.

이 마우스에 대한 후기는 아래 링크를 참고하세요.

[제품 후기] 켄싱턴 트랙볼 마우스, 슬림 블레이드(Slim Blade) 사용 후기

트랙볼 마우스? 볼 마우스? 트랙볼 마우스는 볼(Ball)을 굴려서 커서를 조작하는 마우스입니다. 그런데 볼을 굴린다고 해서 오래전에 사용하던 볼 마우스와는 다릅니다. 과거의 볼 마우스는 마우

luckygg.tistory.com

새로운 배치의 장점

분리형 키보드 사이에 트랙볼 마우스를 배치했더니, 두 손의 이동 반경이 상당히 줄었습니다. 두 팔을 어깨너비로 벌려서 키보드를 치고, 마우스를 사용하려면 가운데로 옮겨서 조작만 하면 됩니다. 팔을 뻗을 필요도 없고, 팔과 어깨도 움직이지 않아도 돼 자세가 편안해졌습니다.

정리하며

컴퓨터를 장시간 사용한다면 아이템 투자에 아끼지 마세요. 편안한 작업 환경을 조성해야 건강하게 오래오래 일을 할 수 있습니다. 저는 부디 이번 투자로 오랫동안 사용할 수 있길 바라고 있습니다. 또 새로운 시도를 하게 되면 여러분께 공유하겠습니다.

[제품 후기] 켄싱턴 트랙볼 마우스, 슬림 블레이드(Slim Blade) 사용 후기

Sat, 24 Dec 2022 22:46:37 +0900

트랙볼 마우스? 볼 마우스?

트랙볼 마우스는 볼(Ball)을 굴려서 커서를 조작하는 마우스입니다. 그런데 볼을 굴린다고 해서 오래전에 사용하던 볼 마우스와는 다릅니다.

과거의 볼 마우스는 마우스 밑면에 볼이 살짝 튀어나와 있어서, 마우스를 움직이면 바닥에 닿은 볼의 움직임에 따라 커서가 조작되었습니다. 이와 달리 트랙볼 마우스는 볼이 많이 튀어나와 있고, 손가락으로 볼을 움직여 커서를 조작하는 방식입니다.

트랙볼 마우스를 선택한 이유

일반적인 마우스는 손으로 마우스를 쥐고 손목을 지탱하여 손가락만 살짝 폈다가 오므리면서 조작이 가능합니다. 그런데 마우스의 위치에 따라 팔이 펴지는 각도가 달라지고, 각도가 과하게 커지면 팔이 뻗어지게 됩니다. 이렇게 장시간 사용하다 보면 견갑골에 통증이 생기기도 합니다.

저는 그동안 마우스의 크기가 작은 것, 큰 것, 인체 공학, 유선, 무선 등 다양한 종류의 광마우스를 사용해 왔습니다. 하지만 결론은 손목은 아프지 않지만 견갑골이 너무 아프더군요. 마우스를 잡는 위치가 너무 오른쪽에 치우쳐 있어, 오랜 시간 작업을 하면 통증이 많이 느껴집니다. 그리고 마우스를 놓고 잠시 쉬면 통증이 바로 가라앉습니다. 즉, 자세에 문제가 있다는 것이 확실하더군요.

그래서 어떻게 해야 팔을 뻗지 않고 올바른 자세를 유지한 채 키보드, 마우스 작업이 가능할까 고민하던 끝에 트랙볼 마우스를 선택하게 됐습니다. 트랙볼 마우스는 마우스 자체의 이동이 필요하지 않고, 손가락으로만 볼을 굴리면 되기 때문에 불필요한 이동이 없다는 것이 장점입니다. 그래서 트랙볼 마우스의 끝판왕이라는 켄싱턴 마우스를 선택하게 됐습니다.

켄싱턴 트랙볼 마우스, 슬림 블레이드

마우스를 찾기 전까지는 몰랐지만, 켄싱턴 트랙볼 마우스는 정말 유명하더군요. 슬림 블레이드(Slim Blade)는 출시된 지 오래됐지만 여전히 많이 찾고 여전히 가격이 비싼 제품입니다. 하지만 그만큼 좋으니 오래가고 오랫동안 찾는 거겠죠.

켄싱턴 트랙볼 마우스 SlimBlade

편리한 커서 이동

손가락으로 볼을 살며시 밀면 마우스 커서가 부드럽게 이동합니다. 이동거리가 많으면 손가락에 힘을 줘 볼을 세게 굴리면 됩니다. 아래 동영상처럼, 두 손가락만으로도 쉽게 이동이 가능하니 힘이 덜 들고 손의 부담이 덜해 편안합니다.

마우스 커서 이동하기

처음에는 미세 조정이 불편했으나, 적응되면 볼마우스가 훨씬 편안합니다. 이제는 일반 광마우스를 사용하면 광마우스가 더 불편한 느낌이 들 정도입니다.

충분한 4개의 버튼과 2개의 특수 버튼

이 마우스는 4개의 버튼이 2x2 배열로 배치되어 있습니다. KensingtonWorks 소프트웨어를 사용하면 각 버튼에 키를 매핑하여 유용하게 사용할 수 있습니다. 위의 2개 버튼과 아래의 2개 버튼을 동시에 누르는 것도 매핑을 할 수 있습니다.

프로그램은 아래 링크에서 다운로드할 수 있습니다.

https://www.kensington.com/software/kensingtonworks/

KensingtonWorks Customization Software

KensingtonWorks™ is a software for personalizing your experience with Kensington® trackballs, mice and presenters.

www.kensington.com

저는 아래 그림처럼 키를 매핑했습니다.

켄싱턴 키 매핑

각 버튼은 일반적인 동작(왼쪽 클릭, 오른쪽 클릭, 뒤로 가기, 앞으로 가기)을 수행합니다. 저는 그보다 두 키를 동시에 누르는 기능이 특히나 마음에 듭니다.

아래 두 키를 누르면 'Ctrl + W'를 동작하도록 설정했습니다. 이는 일반적으로 '창 닫기'를 수행합니다. 웹 브라우저의 탭을 닫거나 윈도우 탐색기의 창을 닫을 수 있습니다.

위 두 키를 누르면 'Ctrl + Shift + T'를 동작하도록 설정했습니다. 이는 웹 브라우저의 '닫힌 창 다시 열기'를 수행합니다. 실수로 창을 닫은 경우, 위 두 키를 누르면 다시 생성할 수 있어 아주 편리합니다.

그동안 'Ctrl + W'와 'Ctrl + Shift + T' 키를 누르기 위해 왼쪽 손이 아팠는데, 손의 부담이 덜해졌습니다.

하지만 아쉬운 건 버튼의 클릭감이 좋진 않습니다. 버튼을 누르면 투박한 소리가 나고, 촉감도 껍데기를 누르는 기분이 드는 단점이 있습니다.

버튼 클릭 소리

재밌는 스크롤 움직임

특히 이 마우스는 스크롤을 움직일 때 재밌습니다. 아래와 같이 볼을 횡으로 움직이면 스크롤 동작을 수행합니다.

횡 이동으로 스크롤 수행

그런데 볼을 횡으로 움직이면 '디리리릭'하는 소리가 발생하는데, 자꾸 들어보면 중독성 있습니다.

스크롤 동작하기

KensingtonWorks 소프트웨어

위에서 언급한 소프트웨어를 설치하면 마우스 포인터의 속도와 가속 사용, 관성 스크롤, 키 매핑 등을 설정할 수 있습니다.

소프트웨어 옵션

유일한 단점, 청소가 필요

볼 마우스를 사용할 때는 관리가 필수입니다. 볼이 움직이면서 먼지가 쌓여 움직임이 자연스럽지 않아 지기 때문입니다. 아래 사진을 보면, 빨간색으로 표시한 부분에 먼지가 쌓여있습니다(왼쪽 사진). 휴지나 물티슈로 닦아내면 깔끔하게 지워집니다(오른쪽 사진).

청소 전, 후 모습

처음에는 왜 이리 뻑뻑하게 움직이나 싶었는데 먼지가 쌓여서 그런 것 이더군요. 보통 청소 주기는 보름에 한 번씩 관리하고 있습니다. 아무리 깨끗하게 사용한다고 해도 이상하게 계속 쌓이네요.

결론

결론은 강력하게 추천합니다! 마우스 사용을 위해 팔을 뻗을 필요도 없고, 버튼 활용으로 단축키 조작도 편해졌습니다. 가격이 조금 비싸긴 하지만 한번 투자할만한 가치가 있다고 생각합니다.

참고로, 최근 켄싱턴 Pro Trackball 제품이 출시됐는데 이 제품은 무선 기능을 지원합니다. 구매하실 의향이 있다면 아래 제품 설명을 꼭 확인하세요.

https://www.kensington.com/p/products/electronic-control-solutions/trackball-products/slimblade-pro-trackball/

SlimBlade™ Pro Trackball | Trackballs | Trackball Mouse | Kensington

Professional reviewers and ergonomists agree that finger-operated trackballs are superior to thumb-based trackballs when it comes to precision and hand comfort. At the same time, professional users prefer the convenience of wireless controllers. Kensington

www.kensington.com

[Wireshark] 패킷 분석의 시작, 와이어샤크! 기본 사용법 정리

Thu, 15 Dec 2022 19:21:32 +0900

와이어샤크(Wireshark)란?

와이어샤크는 네트워크 패킷을 감시 및 분석하는 프로그램으로, 이름이 가장 널리 알려진 소프트웨어입니다. 네트워크 장비뿐만 아니라 머신 비전 카메라를 사용하는 경우에도 어떠한 문제가 있다면 와이어샤크로 패킷을 분석하고 문제점을 찾는데 도움이 됩니다.

또한, TCP 통신으로 장치와 명령어를 주고받으면서 패킷의 데이터 형태는 어떠한지 학습하는 데에도 유용하게 사용됩니다.

와이어샤크의 주요 특징은 다음과 같습니다.

GNU GPLv2 라이선스(자유 소프트웨어)
크로스 플랫폼(Windows, Linux, Mac 등 지원)
패킷 분석을 위한 GUI 제공
무차별 모드(promiscuous mode) 지원
Loopback 뿐만 아니라 시스템의 네트워크 어댑터도 분석 가능
파일 형태로 기록 가능

와이어샤크 다운로드하기

와이어샤크 공식 홈페이지에 접속한 후 사용하는 운영체제에 맞는 파일을 다운로드합니다.

https://www.wireshark.org/#download

Wireshark · Go Deep.

What is SharkFest? SharkFest™, launched in 2008, is a series of annual educational conferences staged in various parts of the globe and focused on sharing knowledge, experience and best practices among the Wireshark® developer and user communities. Shar

www.wireshark.org

와이어샤크 설치하기

프로그램을 설치하는 과정은 아주 간단합니다. 웬만한 옵션은 건들지 말고 Next 버튼만 클릭하여 설치하면 됩니다. 참고로, 설치 중간에 아래와 같이 Npcap 드라이버 설치 과정이 있습니다. 해당 드라이버가 있어야 캡처가 가능하므로 반드시 체크를 해야 합니다.

저는 Npcap 드라이버를 별도로 설치했으므로, 설치 과정 중에 설치가 필요 없다는 메시지가 표시됐습니다.

Npcap 드라이버 설치하기

이 외에 USB 트래픽을 캡처하고 싶다면 체크 박스를 선택하고 설치를 진행합니다.

USB 캡쳐 설치 옵션

그러면 설치가 완료됩니다.

설치가 완료된 모습

와이어샤크 기본 사용 방법

1. 패킷 분석을 위한 어댑터 연결하기

설치된 Wireshark를 실행하면, 아래와 같이 패킷 수집이 가능한 네트워크 어댑터 목록이 표시됩니다. 만약, 루프백 테스트를 하는 경우에는 'Adapter for loopback traffic capture'를 선택하면 됩니다.

네트워크 어댑터 목록

어댑터 목록 중 하나를 더블 클릭하면, 아래와 같이 패킷 수집이 시작됩니다. 저는 루프백 어댑터를 선택했습니다.

패킷이 수집된 모습

2. 패킷 분석 시작과 중지, 캡처된 패킷 저장하기

프로그램 좌측 상단의 중지(Stop) 버튼을 클릭하면 캡처가 중지됩니다.

패킷 캡쳐를 중지하는 방법

다시 캡처를 시작하려면 좌측 상단의 시작(Start) 버튼을 클릭하면 됩니다.

패킷 캡쳐를 시작하는 방법

이미 캡처된 패킷이 있다면 시작 버튼을 클릭했을 때 저장 여부 안내 창이 표시됩니다. 저장이 필요하면 '저장' 버튼을, 필요 없다면 'Continue without Saving' 버튼을 클릭합니다.

패킷 저장 여부 안내 창

또는 좌측 상단의 File 메뉴 중 Save, Save As 메뉴를 클릭하여 저장할 수 있습니다.

패킷 저장하기 메뉴

만약, 다시 캡처를 원한다면 다시 시작(Restart) 버튼을 클릭합니다.

패킷 캡쳐 다시 시작하기

3. 필터 사용하여 원하는 패킷만 보기

툴바 아래에 IP 주소나 포트 번호, 그 외의 조건을 설정하여 원하는 패킷만 볼 수 있습니다.

필터 적용하여 원하는 패킷만 수집하기

자주 사용하는 필터 조건은 다음과 같습니다. 주로 보내는 IP 주소와 목적지 IP 주소 정보로 주고받는 패킷만 보고 싶을 때 사용합니다. 그리고 논리 연산자를 사용하여 AND, OR와 같은 조건도 같이 사용할 수 있습니다.

항목	설명
ip.src	보내는 IP 주소
ip.dst	받는(목적지) IP 주소
tcp.srcport	보내는 TCP 포트 번호
tcp.dstport	받는(목적지) TCP 포트 번호

보내는 IP 주소를 필터링한 모습

[네트워크] iPerf3로 네트워크 부하 테스트 쉽게 하기

Sun, 11 Dec 2022 16:00:28 +0900

네트워크 부하

프로그램을 만들고 나면 안정성 테스트가 필요합니다. 장기적인 동작에 문제가 없는지, 낮은 사양의 PC에서도 잘 동작하는지, CPU 부하가 높은 상태에서도 잘 동작하는지 등의 예시가 있습니다.

네트워크 부하도 마찬가지입니다. 네트워크 관련 프로그램을 만든다면 네트워크 부하에 따른 테스트도 필요합니다. 일반적인 상황에서는 문제가 없으나 순식간에 많은 양의 네트워크 패킷이 들어오면 프로그램이 버벅거리는 상황을 볼 수 있습니다.

iPerf3 특징

여기, 네트워크 부하를 테스트하기 위한 편리한 프로그램이 있습니다. 바로 iPerf3입니다.

https://iperf.fr/iperf-download.php

iPerf - Download iPerf3 and original iPerf pre-compiled binaries

iPerf - The ultimate speed test tool for TCP, UDP and SCTPTest the limits of your network + Internet neutrality test Table of contents : Download iPerf for Windows Download iPerf3 for Android Download iPerf3 for iPhone / iPad Download iPerf3 for Apple macO

iperf.fr

주요 특징은 다음과 같습니다.

TCP/ SCTP/ UDP 프로토콜 지원
다양한 운영체제 지원(Windows, Linux, Android, MacOS 등)
다수의 클라이언트, 서버 연결 가능
초당 데이터 전송 량 또는 지정된 시간 동안 전송 옵션 설정 가능
콘솔 명령어로 쉬운 제어 가능

iPerf3 사용 방법

다운로드 페이지에서 운영체제에 맞는 항목을 다운로드합니다. 파일은 아주 간단하게 dll 파일과 exe 파일로 구성되어 있습니다.

iPerf3 구성

그리고 명령 프롬프트(cmd)를 실행합니다.

명령 프롬프트 실행하기

아래 명령어를 입력하여 iperf3.exe가 위치한 폴더로 이동합니다.

cd C:\Users\User\Downloads\iperf-3.1.3-win64

서버 구동하기

아래 명령어를 입력하여 서버로 구동합니다.

iperf3 -s

서버로 구동된 모습

클라이언트 구동하기

아래 명령어를 입력하여 클라이언트로 구동합니다. 아래 명령어는 클라이언트(-c)이며 127.0.0.1에 접속하고, 5초 동안 전송(-t 5)한다는 의미입니다.

iperf3 -c 127.0.0.1 -t 5

5초 동안 패킷이 전송된 모습

또는, 1초 동안 N Byte를 전송하는 명령어도 있습니다. 아래 명령어는 1초 동안 10MB를 전송한다는 의미입니다.

iperf3 -c 127.0.0.1 -n 10M

1초 동안 10MB가 전송된 모습

Batch 파일로 반복하기

아쉬운 점은 -t와 -n 옵션을 같이 사용할 수 없습니다. -h 명령어를 입력하면 iperf3을 실행하기 위한 도움말이 보이는데요. -t와 -n옵션은 동시에 사용되지 않고, 서로 대체되어 사용이 가능하다고 되어 있습니다.

저는 초당 10MB를 반복적으로 전송하고 싶었는데, -t와 -n을 같이 사용할 수 없으니 고민이 되더군요. 그래서 다음과 같은 배치 파일을 만들어 보았습니다.

@echo off

:1

iperf3 -c 127.0.0.1 -n 10M

timeout -t 1 /nobreak

goto 1

아쉬운 대로, 10MB/s 전송을 1초마다 계속해서 반복하여 실행하는 것이지요. 이렇게 하면 나름 10MB/s로 데이터를 계속 전송하여 부하 테스트가 가능합니다.

10MB/s가 반복 동작하는 모습

그 외 명령어

아래의 명령어를 입력하면 iPerf3을 사용하기 위한 명령어 목록이 보입니다.

iperf3 -h

iperf3 명령어 도움말

정리

위에서 언급한 명령어들을 편리하게 사용할 수 있는 배치 파일을 아래 파일에 업로드했습니다.

iperf-3.1.3-win64 with Batch files.zip

1.32MB

필요한 조건에 맞게 메모장으로 편집하여 실행해도 됩니다. 이 외에 인터넷 웹 브라우저를 접속하거나 유튜브에 접속하여 동영상을 재생하는 방법도 있으니 참고하세요.

[C#] WinForm 도구 상자에 컨트롤이 추가되지 않는 경우 해결 방법

Sat, 29 Oct 2022 23:49:12 +0900

도구 상자에 컨트롤이 추가되지 않는 문제

C# WinForm에서 기본으로 제공되는 컨트롤 외에, 내가 필요로 하는 기능의 컨트롤이 없는 경우에는 사용자 컨트롤(Custom control)로 직접 만들어야 합니다. 또는 NuGet이나 누군가 만든 컨트롤 dll을 사용해도 됩니다.

그런데 이렇게 외부 컨트롤을 폼(Form) 디자이너에서 사용하려면 도구 상자(Tool box)에 추가되어야 하는데요. 하필이면 Visual Studio 버그인지 모르겠으나, 도구 상자에 컨트롤을 추가하다가 Visual Studio가 종료되는 버그가 발생할 수도 있습니다.

[Visual Studio] VS2015 도구 상자(ToolBox) 종료 현상 해결 방법

최근 Visual Studio 2015에서 C# Windows Form 작업이 있었는데요. Custom Control을 제작하여 윈 폼 프로젝트에 추가하는 과정에서 문제가 발생했습니다. 마침 여분의 PC가 더 있어서 확인해 보았는데, PC 1대

luckygg.tistory.com

그런데 문제는 위 링크의 조치 사항을 적용해도 여전히 Visual Studio 버전에 상관없이 종료되는 경우가 있습니다. 참 골치 아픈 문제인데요.

본문에서는 도구 상자에 컨트롤을 추가하지 않고, 직접 코드 편집으로 컨트롤을 추가하여 사용하는 방법을 알려드립니다.

도구 상자 없이 컨트롤 추가하기

우선 추가하고자 하는 컨트롤의 dll을 참조로 추가합니다. 저는 예시로 ImageGlass.ImageBox dll을 사용했습니다.

참조 dll 추가하기

그리고 버튼(Button)과 같은 아무 컨트롤이나 추가합니다.

Button 컨트롤이 추가된 모습

이제 Form의 디자이너인 Form1.Designer.cs 파일을 더블 클릭합니다.

Form1.Designer.cs 파일을 연 모습

기존 코드에서 Button과 관련된 모든 코드를 사용하고자 하는 컨트롤로 변경합니다. 저는 ImageGlass의 ImageBox로 모두 교체했습니다. 컨트롤에서 지원되지 않는 속성은 지우셔도 상관없습니다.

새로운 컨트롤 이름으로 모두 변경한 모습

이제 Form1.cs를 더블 클릭해서 디자이너를 보겠습니다. 처음에 있던 버튼은 사라지고 교체한 컨트롤이 존재합니다.

새로 추가한 컨트롤로 교체된 모습

참고로, 빌드 플랫폼이 x64인 경우에는 빌드에는 문제가 없지만 디자이너를 열면 아래와 같은 에러가 발생합니다.

x64 디자이너 오류

정확한 이유는 모르겠습니다만, 64bit에서 생성된 컨트롤은 빌드 플랫폼이 x64일 때 디자이너에서 오류가 발생합니다. 그래서 AnyCPU나 x86으로 빌드하면 디자이너가 정상적으로 열립니다. 만약, x64용 dll만 있다면 빌드는 되지만 디자이너가 열리지 않아 난감한 상황에 직면하긴 합니다.

아무튼, 컨트롤이 도구 상자에 정상적으로 추가되지 않는다면 본문과 같이 디자이너 코드 편집으로 직접 추가하는 방법이 있다는 것을 알고 계시면 꽤 유용합니다.

[C#] WinForm의 Form 디자이너가 사라지는 문제 해결 방법

Tue, 25 Oct 2022 18:30:53 +0900

Form 디자이너가 사라지는 현상

아주 가끔 C# WinForm 프로젝트를 사용하다가 Form 디자이너가 사라지는 현상이 생깁니다. 정상적이라면 아래와 같이 Form.cs 파일의 아이콘이 폼(Form)이어야 합니다. 그리고 더블 클릭하면 오른쪽과 같이 UI 꾸미기가 가능한 디자이너 창이 표시되어야 하죠.

Form 디자이너가 정상적으로 보이는 모습

그런데 어느 순간부터 폼 아이콘이 사라지고 C# 아이콘이 생기면서 디자이너가 더 이상 보이지 않는 현상이 있습니다.

Form 디자이너가 보이지 않는 모습

이상하다 싶어 프로젝트를 다시 열어도, PC를 재부팅해도, 이름을 바꿔도 도저히 돌아오지 않습니다. 이런 현상이 발생했을 때 아주 간단하게 조치하는 방법을 알려드리겠습니다.

csproj 파일을 수정하여 해결하기

이 문제는 프로젝트 파일을 수정하여 쉽게 해결이 가능합니다. 아래 그림처럼, *.csproj 파일을 메모장과 같은 편집기로 불러옵니다.

csproj 파일

파일을 열어보면, 폼 디자이너가 보이지 않는 파일을 찾습니다. 본문의 예제 파일은 Form1.cs 입니다. 아래 그림을 보면 Designer.cs 파일도 보이고 문제가 없어 보이는데요. 사실 정상적이지 않은 모습입니다.

에디터 편집기로 csproj 열기

아래와 같이 되어있다면,

<Compile Include="Form1.cs" />
<Compile Include="Form1.Designer.cs">
  <DependentUpon>Form1.cs</DependentUpon>
</Compile>

이렇게 수정해야 합니다. 즉, SubType이 사라져 생긴 문제입니다.

<Compile Include="Form1.cs">
	<SubType>Form</SubType>
</Compile>
<Compile Include="Form1.Designer.cs">
  <DependentUpon>Form1.cs</DependentUpon>
</Compile>

참고로, 수정할 때 <Compile>~</Compile>이 한 쌍이어야 합니다. 기존 내용에서 <Compile ... /> '슬래시(/)'를 지웠는지 꼭 확인하세요. 슬래시가 남아있으면 계속 적용이 안됩니다.

이렇게 저장한 후 다시 프로젝트 파일을 열면 정상적으로 폼 디자이너가 보이기 시작합니다. 이게 Visual Studio 버그인지는 모르겠으나, 또 발생하면 똑같이 수정하면 해결되므로 알고 있으면 유용합니다.

[C++] C++에서 구조적 예외 처리(SEH) 사용하는 방법

Tue, 18 Oct 2022 21:40:59 +0900

구조적 예외 처리와 C++ 예외 처리

구조적 예외 처리는 Microsoft Windows의 기본 예외 처리 메커니즘이며, 소프트웨어와 하드웨어 예외를 처리할 수 있다고 설명했었습니다. 이러한 내용은 아래 링크를 참고하세요.

구조적 예외 처리(SEH, Structured Exception Handling) 기초 이야기

구조적 예외 처리(SEH)란? 구조적 예외 처리(이하 SEH)는 하드웨어와 소프트웨어 예외를 모두 처리하는 Microsoft Windows의 기본 예외 처리 메커니즘입니다. 하드웨어 예외는 예외가 발생한 주체가 CPU

luckygg.tistory.com

그리고 C++ 예외 문법인 try, catch, throw는 내부적으로 구조적 예외 처리(이하 SEH, Structured Exception Handling) 기능을 이용하여 구현되어 있다는 내용도 언급했습니다. 어쨌든, 특별한 이유가 없다면 C++ 언어에서는 C++ 예외 처리 문법을, C#에서는 C# 예외 처리 문법을 사용하면 됩니다.

본문에서는 C++ 언어에서 SEH를 사용하는 방법을 설명하겠습니다.

C++에서 SEH 사용하기

간단한 테스트를 위해 Visual Studio 2019에서 콘솔 앱 프로젝트를 생성합니다.

C++ 콘솔 앱 프로젝트 생성하기

그리고 아래 링크의 기본 예제 코드를 참고하여 설명하겠습니다.

https://learn.microsoft.com/ko-kr/cpp/cpp/structured-exception-handling-c-cpp?view=msvc-170

Structured Exception Handling (C/C++)

Microsoft C/C++의 구조적 예외 처리 개요입니다.

learn.microsoft.com

예제 코드는 다음과 같습니다.

#include <stdio.h>
#include <Windows.h>
#include <exception>

class TestClass
{
public:
    ~TestClass()
    {
        printf("Destroying TestClass!\r\n");
    }
};

__declspec(noinline) void TestCPPEX()
{
#ifdef CPPEX
    printf("Throwing C++ exception\r\n");
    throw std::exception("");
#else
    printf("Triggering SEH exception\r\n");
    volatile int *pInt = 0x00000000;
    *pInt = 20;
#endif
}

__declspec(noinline) void TestExceptions()
{
    TestClass d;
    TestCPPEX();
}

int main()
{
    __try
    {
        TestExceptions();
    }
    __except(EXCEPTION_EXECUTE_HANDLER)
    {
        printf("Executing SEH __except block\r\n");
    }

    return 0;
}

해당 예제 코드를 실행하면 다음과 같은 결과가 표시됩니다.

Triggering SEH exception //24번 째
Executing SEH __except block //44번 째

프로그램을 실행하면 CPPEX가 정의되어 있지 않아 24번째 메시지가 출력되고, 잘못된 메모리 주소에 접근을 시도하게 됩니다. 그리고 __except 필터에 의해 44번째 메시지가 출력되는 동작입니다. 여기서, TestClass 객체의 소멸자가 정의되어 있는데 호출되지 않은 것을 알 수 있습니다.

만약, 프로젝트 속성의 명령줄에 /DCPPEX를 추가하면 결과는 달라집니다.

C++ 명령줄에 옵션 추가하기

아래와 같이 14번째 줄의 메시지가 출력됩니다.

Throwing C++ exception
Destroying TestClass! //14번 째
Executing SEH __except block

/DCPPEX 명령줄을 추가하면 CPPEX가 정의되어 C++ 예외인 throw가 호출되면서 소멸자가 호출되기 때문입니다.

마지막으로, C++ 예외와 SEH를 같이 사용하고 싶다면 C++ 예외 처리 가능 옵션을 /EHa로 변경하면 됩니다.

C++ 예외 처리 옵션 변경

이렇게 옵션을 변경하면 명령줄에 /DCPPEX가 있든 없든 상관없이, 소멸자가 정상적으로 호출됩니다.

Throwing C++ exception
Destroying TestClass! //14번 째
Executing SEH __except block

프로그램에서 일반적인 예외 처리(Exception Handling)하는 방법

Sat, 15 Oct 2022 17:59:03 +0900

예외 처리가 왜 필요할까요?

프로그램의 예외 처리는 아주 중요합니다. 내가 만든 프로그램이 모든 상황에서 항상 잘 동작할 것이라는 보장을 할 수 없기 때문이죠. 아무리 잘 만들었다고 해도, 막상 사용자가 사용하는 환경이나 조작 방법에 따라 무슨 문제가 발생할지는 알 수가 없습니다.

그래서 프로그래밍 관련 서적(기초 언어 문법을 다루는 책뿐만 아니라, 프로그램 설계, 프로그래밍 기법 등)을 보면, 거의 대부분 예외 처리의 중요성을 강조하고 있습니다. 예외 처리가 잘 되어 있어야 안정적인 프로그램을 만들 수 있기 때문이죠.

참고로, 제가 언급하는 예외 처리는 나중에 소개할 에러 처리(Error Handling)와 예외 처리(Exception Handling) 모두를 통칭하는 표현입니다.

예외를 처리하는 방법

예외(또는 오류)를 처리하는 방법은 일반적으로 다음의 세 가지가 있습니다. 앞으로 언급할 세 가지 외에도 또 다른 방법이 있을 수도 있고, 어떤 방법이 옳고 그르다기보다는 아주 보편적이다라는 의미로 소개합니다.

1. 오류 무시하기

다소 황당할 수도 있는 방법이지만, 은연중에 그렇게 사용하고 있을 수도 있습니다. 예를 들어, 문자열을 출력하는 다음 함수를 보겠습니다.

int printf_s(
   const char *format [,
   argument]...
);

https://docs.microsoft.com/ko-kr/cpp/c-runtime-library/reference/printf-s-printf-s-l-wprintf-s-wprintf-s-l?view=msvc-170

printf_s, _printf_s_l, wprintf_s, _wprintf_s_l

자세한 정보: printf_s, _printf_s_l, wprintf_s, _wprintf_s_l

docs.microsoft.com

이 함수는 출력된 문자 수 또는 오류가 발생하면 음수를 반환합니다. 그런데, 해당 함수를 사용하면서 매번 반환 값이 음수인지, 출력된 문자 수와 같은지 확인할까요? 사실 이 함수가 음수를 반환할 가능성은 아주 상당히 낮습니다. 웬만하면 거의 정상적으로 동작할 겁니다.

이처럼, 사소하다고 생각하는 것들은 그냥 '무시'하는 것도 방법이긴 합니다만, 판단하는 기준이 모호하고 견고한 프로그램 만드는 방법과는 다소 거리감이 있습니다.

2. 에러 코드(Error Code) 반환하기 - Error Handling

특정 함수를 호출하면 성공 여부를 정수로 반환하는 방식을 많이 접해봤을 텐데요. 에러 코드 반환하기가 바로 그런 방법입니다. 함수 호출 성공 여부를 boolean으로 반환할 수도 있고, int나 에러를 정의한 struct로 반환하는 방법이 있습니다.

하지만, 이러한 코드는 지저분한 코드를 야기합니다. 대부분의 서적에서도 언급하는 내용인데요. 항상 함수를 호출하고 if-else 문으로 에러를 확인하기 때문이죠.

int result = doSomething();
if (result == 0)
{
    //동작 성공
}
else if (result == -1)
{
    //에러1
}
else if (result == -2)
{
    //에러2
}
//...

물론, 보통은 다음과 같이 사용하기도 합니다.

int result = doSomething();
if (result != 0)
{
    //오류 보고
}
//...

이 방법론의 핵심은, 매번 오류 코드를 확인해야 하는 번거로움과 반환 코드에 따라 if-else문이 많아지면 유지보수에 까다로움이 있다는 것이죠.

3. 예외(Exception) 사용하기 - Exception Handling

어느 서적이나 예외를 소개하는 파트가 있다면, 다들 예외를 사용하라고 권장합니다(물론, 항상 좋은 점만 있는 것은 아니죠). 코드가 간결해지고, 예외가 발생했을 때 오류를 보고하고 조치하기가 간편하며 예외를 발생시킨 원인에 따라 다른 작업을 수행하도록 코드를 작성할 수 있습니다.

예외를 사용하기 위한 C++ 문법은 아주 간단합니다(본문에서는 문법에 대해 상세히 설명하지 않습니다).

//C++
void doSomething()
{
    //...
    thorw std::exception("예외 메시지");
}

int main()
{
    try
    {
        doSomething();
    }
    catch(const std::exception &e)
    {
        //e.what();
    }
}

특정 함수에서 작업을 수행하다가 문제가 발생하면 예외를 던집(throw)니다. 던져진 예외는 가장 가까운 try-catch 블록까지 자동으로 전파되고, catch된 예외에서 오류 메시지를 확인할 수 있습니다.

특히 C#에서는 Exception 객체의 StackTrace를 통해 어디서 예외가 던져졌는지 확인할 수 있습니다.

static void doSomething()
{
    throw new Exception("예외 발생!");
}

static void Main(string[] args)
{
    try
    {
        doSomething();
    }
    catch(Exception exc)
    {
        Console.WriteLine(exc.StackTrace);
        Console.WriteLine(exc.Message);
    }
}

위 코드를 실행하면 StackTrace를 통해 예외 메시지와 예외가 던져진 소스 코드의 위치를 알 수 있습니다.

참고

C++ For Game Programmers - Second Edition, Michale J. Dickheiser

예외 스택 풀기(Stack Unwinding)와 프로그램 성능 영향

Wed, 12 Oct 2022 17:44:12 +0900

스택 풀기(Stack Unwinding)란?

예외가 발생한 함수에서 예외가 처리되지 않으면, 상위 함수로 돌아가 예외가 처리되기를 시도합니다. 만약, 상위 함수에도 없다면 다시 그 위의 상위 함수로 돌아가며 반복하게 됩니다. 만약, 예외가 발생했는데 어느 곳에서도 try-catch 문이 없다면 프로그램은 종료되고 맙니다.

이렇게 이전에 호출된 함수로 계속 돌아가는 것을 스택 풀기(Stack Unwinding)라고 합니다. 다음의 예제 코드를 보겠습니다.

namespace ExamException
{
    class Program
    {
        static void func1()
        {
            func2();
        }

        static void func2()
        {
            func3();
        }

        static void func3()
        {
            throw new Exception("예외 발생!");
        }

        static void Main(string[] args)
        {
            func1();
        }
    }
}

Main 함수에서 func1()을 호출하면, func2(), func3()이 차례대로 호출되고, func3()에서 예외가 발생하는 코드입니다. 예외가 발생하는 지점에 Break point를 지정하고, 디버깅을 실행한 후 비주얼 스튜디오의 호출 스택(Call Stack) 창을 열어보겠습니다.

호출 스택 화면

호출 스택 맨 아래에 Main 함수를 시작으로, 차례대로 func1(), func2(), func3()이 기록되어 있습니다. 이것이 스택에 쌓여있는 함수의 호출 목록이며, func3()에서 예외가 발생했으니 try-catch에 도달할 때까지 func2(), func1(), Main 함수까지 돌아가는 것이죠. 이것을 스택 풀기라고 합니다.

스택이 쌓이고 풀리는 과정

예외와 프로그램 성능 영향

위에서 언급한 대로, 스택을 푸는 과정에서 Stack Trace와 같은 예외 정보를 가지다 보니, 예외가 발생하면 오버헤드(Overhaed)가 발생하게 됩니다. 그리고 이를 예외 비용(Exception cost)이라고도 부릅니다.

그런데 여기서 오해의 소지가 있는데요. 예외 처리를 사용하면 항상 오버헤드가 발생하는 것이 아닙니다. 즉, try-catch 블록을 사용한다고 항상 성능에 영향을 미치는 것이 아니라는 뜻입니다.

사실 try-catch 블록을 사용하더라도 예외가 발생하지 않으면 성능 저하가 거의 없다고 볼 수 있습니다. 이에 대한 성능 검증은 구글링을 통해 쉽게 찾아볼 수 있습니다.

https://pspdfkit.com/blog/2020/performance-overhead-of-exceptions-in-cpp/

Investigating the Performance Overhead of C++ Exceptions | PSPDFKit

C++ exceptions have their place, but using an alternative is recommended for general program flow control.

pspdfkit.com

https://yesarang.tistory.com/371

C++ 이야기 서른두번째: 예외가 성능에 미치는 영향

2009/09/25 - [S/W개발/C++ 이야기] - C++ 이야기 서른한번째: 왜 예외를 쓰는 게 좋을까요? 에서 왜 예외를 쓰는 것이 좋은지에 대해 얘기를 해 봤습니다. 정리해서 말씀드리자면 결함내성 특성(fault-tol

yesarang.tistory.com

결론

분명히 try-catch 문을 사용한 예외 처리가 에러 코드 반환형 보다는 더 가독성 있고 견고한 프로그램을 만들 수 있습니다. 하지만 그렇다고 무분별하게 모든 곳에 try-catch를 사용했다간 성능 저하를 겪게 됩니다. 따라서, 예상이 되는 곳에는 조건 문으로 예외를 처리하고, 예상이 되지 않는 곳에 try-catch를 복합적으로 사용하는 것이 좋습니다.

[VTK] CMake 빌드 및 Visual Studio 환경 구성

Mon, 10 Oct 2022 16:19:28 +0900

VTK 라이브러리

VTK 라이브러리를 사용하기 위해서는 사용자의 환경에 맞춰 직접 CMake로 빌드해야 합니다. 예를 들어, Visual Studio 버전이라든가, 32bit 또는 64bit에 맞는 환경으로 빌드해야 합니다.

이전에도 VTK CMake 빌드와 Visual Studio 프로젝트 환경 설정 방법에 대해 다룬 글이 있는데요. VTK와 Visual Studio 버전이 낮아 좀 더 상위 버전에 맞춰 포스팅을 새로 하게 됐습니다. 이전 글은 아래 링크를 참고하세요.

[VTK] VTK 8.2 및 Visual Studio 2015 환경 구성

VTK를 사용하기 위해서는 준비 과정이 다소 길고 복잡합니다. 본 글에서는 차례차례 쉽게 따라 할 수 있도록 정리해 보았습니다. ※ 2019년 7월 3일 추가 혹시 아래 빌드 과정이 안 되는 분들을 위

luckygg.tistory.com

[VTK] Visual Studio 2015 MFC에서 VTK 사용 준비하기

이번 포스팅에서는 Visual Studio 2015 MFC 환경에서 VTK SDK를 사용하는 방법을 소개하고자 합니다. 먼저, VTK를 준비하는 방법은 아래 링크를 참고해주세요. [VTK] VTK 8.2 및 Visual Studio 2015 환경 구성 1...

luckygg.tistory.com

VTK 준비하기

1. CMake 설치하기

VTK를 빌드하기 위해 CMake 프로그램을 설치해야 합니다. 거의 대부분의 오픈 소스는 이 CMake 프로그램을 사용하여 라이브러리를 빌드할 수 있습니다.

[CMake] CMake 설치하기

CMake는 사용자가 원하는 개발환경의 라이브러리 생성을 도와주는 오픈 소스 도구입니다. OpenCV나 VTK 혹은 각 제조사에서 제공하는 SDK를 개발환경에 따라 라이브러리를 새로 생성할 때 사용됩니

luckygg.tistory.com

2. VTK 라이브러리 소스 다운로드하기

VTK 홈페이지에 접속하여 최신 버전을 다운로드합니다.

VTK 소스 다운받기

3. Visual Studio 설치하기

사용하려는 버전의 Visual Studio를 준비합니다. 본문에서는 Visual Studio 2019를 설치했습니다.

VTK 라이브러리 CMake 빌드하기

CMake 프로그램을 관리자 권한으로 실행합니다. 그리고 Source code와 build 경로를 지정합니다.

Source와 Build 경로 지정하기

항목	설명
Where is the source code	VTK-X.Y.Z.tar.gz 압축 해제된 폴더의 경로
Where to build the binaries	Binary 파일이 생성될 비어있는 경로

좌측 하단의 Configure 버튼을 클릭합니다. 그리고 아래의 창이 표시되면 사용하려는 Visual Studio의 버전과 Platform(bit 수)을 선택합니다.

CMake 빌드 환경 선택하기

Finish 버튼을 클릭하면 아래와 같이 무언가 진행이 됩니다. PC 사양마다 다르지만, 약 3분 정도 소요됩니다.

Configure 이후

이후 아래와 같은 화면이 표시됩니다. VTK 예전 버전에서는 옵션 선택이 상당히 많았는데요. 9.2.2 기준으로는 옵션이 상당히 줄어들었습니다. 특별한 이유가 없다면 기본값 그대로 진행해도 문제는 없습니다.

저의 경우에는 빌드된 VTK 라이브러리의 Debug/Release 경로를 구분하기 위해 아래와 같이 변경했습니다.

C:/Program Files/VTK/${BUILD_TYPE}

CMake 옵션 선택 화면

옵션 선택이 끝났다면 Generate 버튼을 클릭합니다. 이 작업은 금방 끝나며, Open Project 버튼이 활성화가 됩니다. 이 버튼을 클릭하거나, Visual Studio를 관리자 권한으로 실행한 후 Binary 경로에 있는 VTK.sln 파일을 엽니다.

VTK.sln 열고 빌드하기

Visual Studio에서 VTK.sln 파일이 열리면 INSTALL 프로젝트를 빌드합니다. 이 작업은 다소 시간이 걸립니다. 제 경우 약 15분이 걸렸습니다. Debug 모드의 빌드가 끝나면 Release 모드로 변경하여 마저 빌드합니다.

빌드가 완료되면 CMake에서 지정한 경로에 다음과 같이 Debug/Release 각 폴더에 VTK 라이브러리 파일이 생성되어 있습니다.

라이브러리 파일이 생성된 모습

Visual Studio에서 VTK 라이브러리 환경 설정하기

Visual Studio를 실행하고 C++ 콘솔 앱 프로젝트를 생성합니다. 프로젝트 속성 > 디버깅 > 환경에 dll이 위치한 bin 폴더의 경로를 입력합니다.

C:\Program Files\VTK\Debug\bin

프로젝트 속성의 환경

프로젝트 속성 > C/C++ > 일반 > 추가 포함 디렉터리에 VTK 라이브러리의 include 경로를 입력합니다.

프로젝트의 include 경로

프로젝트 속성 > 링커 > 일반 > 추가 라이브러리 디렉터리에 VTK 라이브러리의 lib 경로를 입력합니다.

프로젝트의 lib 경로

마지막으로 프로젝트 속성 > 링커 > 일반 > 입력 > 추가 종속성에 VTK 라이브러리의 lib 파일 목록을 입력합니다.

프로젝트의 lib 파일 목록

lib 파일 목록을 쉽게 얻는 방법은 아래 링크를 참고하세요.

[MFC] lib, dll 폴더의 파일 목록 쉽게 얻는 방법

가끔 외부 Library를 사용하다 보면 lib, dll 파일을 프로젝트 설정에 입력해야 하는 경우가 있는데요. OpenCV의 경우에는 파일이 몇 가지 없지만, VTK의 경우에는 수 십개의 파일이 존재하다 보니 일일

luckygg.tistory.com

VTK Hello World 실행하기

이제 Visual Studio에 VTK 라이브러리 환경 설정이 모두 끝났습니다. VTK 공식 예제 코드인 Hello World를 실행해 보겠습니다. 전체 코드는 아래와 같습니다.

#pragma once
#include <vtkAutoInit.h>

#define vtkRenderingCore_AUTOINIT 3(vtkRenderingOpenGL2,vtkInteractionStyle, vtkRenderingFreeType)
#define vtkRenderingContext2D_AUTOINIT 1(vtkRenderingContextOpenGL2)

#include <vtkActor.h>
#include <vtkCamera.h>
#include <vtkCylinderSource.h>
#include <vtkNamedColors.h>
#include <vtkNew.h>
#include <vtkPolyDataMapper.h>
#include <vtkProperty.h>
#include <vtkRenderWindow.h>
#include <vtkRenderWindowInteractor.h>
#include <vtkRenderer.h>

#include <array>

int main(int, char* [])
{
    vtkNew<vtkNamedColors> colors;

    // Set the background color.
    std::array<unsigned char, 4> bkg{ {26, 51, 102, 255} };
    colors->SetColor("BkgColor", bkg.data());

    // This creates a polygonal cylinder model with eight circumferential facets
    // (i.e, in practice an octagonal prism).
    vtkNew<vtkCylinderSource> cylinder;
    cylinder->SetResolution(8);

    // The mapper is responsible for pushing the geometry into the graphics
    // library. It may also do color mapping, if scalars or other attributes are
    // defined.
    vtkNew<vtkPolyDataMapper> cylinderMapper;
    cylinderMapper->SetInputConnection(cylinder->GetOutputPort());

    // The actor is a grouping mechanism: besides the geometry (mapper), it
    // also has a property, transformation matrix, and/or texture map.
    // Here we set its color and rotate it around the X and Y axes.
    vtkNew<vtkActor> cylinderActor;
    cylinderActor->SetMapper(cylinderMapper);
    cylinderActor->GetProperty()->SetColor(
        colors->GetColor4d("Tomato").GetData());
    cylinderActor->RotateX(30.0);
    cylinderActor->RotateY(-45.0);

    // The renderer generates the image
    // which is then displayed on the render window.
    // It can be thought of as a scene to which the actor is added
    vtkNew<vtkRenderer> renderer;
    renderer->AddActor(cylinderActor);
    renderer->SetBackground(colors->GetColor3d("BkgColor").GetData());
    // Zoom in a little by accessing the camera and invoking its "Zoom" method.
    renderer->ResetCamera();
    renderer->GetActiveCamera()->Zoom(1.5);

    // The render window is the actual GUI window
    // that appears on the computer screen
    vtkNew<vtkRenderWindow> renderWindow;
    renderWindow->SetSize(300, 300);
    renderWindow->AddRenderer(renderer);
    renderWindow->SetWindowName("Cylinder");

    // The render window interactor captures mouse events
    // and will perform appropriate camera or actor manipulation
    // depending on the nature of the events.
    vtkNew<vtkRenderWindowInteractor> renderWindowInteractor;
    renderWindowInteractor->SetRenderWindow(renderWindow);

    // This starts the event loop and as a side effect causes an initial render.
    renderWindow->Render();
    renderWindowInteractor->Start();

    return EXIT_SUCCESS;
}

실행 결과는 다음과 같습니다.

Hello World 예제 실행 결과

어때요, 잘 따라 하셨나요? 여기까지 문제없이 따라 하셨다면, 이제 VTK 예제 코드를 실행하는데 문제가 없을 것입니다.

구조적 예외 처리(SEH, Structured Exception Handling) 기초 이야기

Sun, 28 Aug 2022 22:08:06 +0900

구조적 예외 처리(SEH)란?

구조적 예외 처리(이하 SEH)는 하드웨어와 소프트웨어 예외를 모두 처리하는 Microsoft Windows의 기본 예외 처리 메커니즘입니다. 하드웨어 예외는 예외가 발생한 주체가 CPU와 같은 하드웨어라는 것이고, 소프트웨어 예외는 사용자가 작성한 소프트웨어 및 운영체제가 예외의 주체라는 의미입니다.

좀 더 쉬운 예를 들자면, 어떤 수를 0으로 나누는 연산이나 접근할 수 없는 메모리에 접근을 시도하는 명령어를 실행한다면 하드웨어 예외가 발생하고, 유효하지 않은 인자에 값을 지정할 때 소프트웨어 예외가 발생할 수 있습니다.

이처럼, 하드웨어와 소프트웨어 예외를 모두 처리하는 메커니즘이 SEH입니다.

https://docs.microsoft.com/ko-kr/windows/win32/debug/structured-exception-handling

구조적 예외 처리 - Win32 apps

예외는 프로그램을 실행하는 동안 발생하는 이벤트로, 정상적인 제어 흐름 외부의 코드를 실행해야 합니다.

docs.microsoft.com

사실 일반 응용 프로그램 개발자라면 SEH에 대해 깊게 알 필요는 없다고 생각합니다. SEH는 주로 운영체제를 안정적으로 개발하기 위한 예외 처리로, 일반 응용 프로그램 개발자는 언어에서 지원하는 예외 처리를 잘 다뤄야 합니다. 예를 들어, C++ 프로그램은 C++ 문법인 try-catch, throw를 이용하여 예외를 다루면 됩니다. 물론, SEH를 사용해도 무방합니다.

참고로, C++ 예외 처리는 내부적으로 컴파일러와 윈도우가 지원하는 SEH 기능을 이용하여 구현되었습니다.

SEH 기본 문법

SEH는 두 가지 주요 기능으로 구성되어 있습니다. 바로, 종료 처리기와 예외 처리기입니다. 각 처리에 대해 차례대로 알아보겠습니다.

1. 종료 처리기(Termination Handler)

종료 처리기는 __try 블록 내의 제어가 어떻게 빠져나오든 __finally 블록의 코드가 반드시 수행될 것이라는 것을 보장합니다. 아래 예제는 종료 처리기 SEH 구문입니다.

__try
{
	//...
}
__finally
{
	//종료 처리기
	//...
}

운영 체제와 컴파일러는 항상 종료 처리기의 코드가 수행되도록 보장합니다. 단, ExitProcess, ExitThread, TerminateProcess, TerminateThread와 같은 함수를 호출하여 프로세스나 스레드가 종료되는 경우는 제외합니다. 이러한 상황을 제외하곤, __try 블록 내에서 return, goto와 같은 문을 호출하더라도 종료 처리기는 항상 호출됩니다.

그런데, 어떻게 종료 처리기인 __finally 블록이 항상 호출되는 것일까요? 이는, 컴파일러가 __try 블록 내에서 빠져나가기 전에 __finally 블록을 반드시 수행될 수 있도록 추가적인 코드를 생성하기 때문입니다. 이를 로컬 언와인드(Local Unwind)라고 합니다.

로컬 언와인드(Local Unwind)

앞서 설명한 대로, 시스템이 __try 블록을 빠져나가기 전에 __finally 블록을 먼저 수행해야 하는 코드를 추가로 생성하는 것을 의미합니다. 그런데 '코드를 추가로 생성한다'라는 조건이 눈에 띄는데요. 추가적인 코드를 생성한다는 것은 결국 비용이 발생한다는 것입니다. 그리고 발생한 비용은 프로그램 수행 성능에도 좋지 않은 영향을 줄 수 있습니다.

따라서, 로컬 언와인드가 발생하지 않도록 제어의 흐름을 자연스럽게 작성해야 합니다. __try 블록을 수행하고 자연스럽게 __finally 블록을 수행하는 것이 비용을 최소화하는 방법입니다.

또 하나의 주의 사항으로, __try 블록에서는 서둘러서 빠져나가는 코드를 작성하지 않는 것을 권장합니다. 예를 들어, return, goto, continue, break와 같은 문장을 사용하지 않는 것이 가장 좋은 방법입니다. 컴파일러가 로컬 언와인드와 같은 작업을 수행하지 않아도 되기 때문에, 좀 더 작은 코드를 생성할 수 있고 이는 최소한의 비용으로 코드를 좀 더 빠르게 동작하도록 할 수 있기 때문입니다.

__leave 키워드

__try 블록 내에서 __leave 키워드를 사용하면 __try 블록의 가장 마지막으로 이동하게 됩니다. 이렇게 하면 앞에서 설명한 것처럼, 코드 수행 흐름이 자연스럽게 __try 블록에서 __finally 블록으로 이동하기 때문에 어떠한 추가 비용이 발생하지 않습니다.

2. 예외 처리기(Exception Handler)

예외 처리기는 __try 블록의 코드를 수행하던 중 예외가 발생하면 __except 문에서 필터를 평가하여 추가 동작을 수행하게 됩니다. 아래 예제는 예외 처리기 SEH 구문입니다.

__try
{
	//...
}
__except (예외 필터)
	//예외 처리기
	//...
}

예외 처리기의 예외 필터에 대해 설명할 내용이 더 있습니다. 깊게 들어가기 전에, SEH 문법에 대해 잠깐 정리하고 설명을 이어가겠습니다.

SEH 문법 중간 정리

SEH 문법인 __try 블록을 만들면 반드시 종료 처리기인 __finally 블록 또는 예외 처리기인 __except 블록이 따라와야 합니다. __try 블록은 __finally 블록과 __except 블록을 동시에 가질 수 없습니다. 그리고 여러 개의 __except 블록도 가질 수 없습니다.

하지만 __try-__finally 블록 내에 __try-__except 블록을 포함시키거나 또는 그 반대로 구성하는 것은 가능합니다.

3. 예외 필터

계속해서 예외 처리기의 예외 필터에 대해 설명하겠습니다. 예외 필터는 총 세 가지를 제공하며, 각 필터마다 서로 다른 동작을 수행하게 됩니다.

3-1. EXCEPTION_EXECUTE_HANDLER

__try
{
	//...
}
__except(EXCEPTION_EXECUTE_HANDLER)
{
	//예외 처리 수행
    //...
}

글로벌 언와인드(Global Unwind)를 수행한 후 __except 블록을 수행하게 됩니다. __except 블록의 코드가 모두 수행되고 나면 __except 바로 다음의 코드를 수행하게 됩니다.

글로벌 언와인드(Global Unwind)

앞에서 종료 처리기를 설명할 때 로컬 언와인드를 설명했었습니다. 이름이 비슷한 글로벌 언와인드를 왜 지금 언급했냐면, 글로벌 언와인드는 예외 필터가 EXCEPTION_EXECUTE_HANDLER 일 때 동작하기 때문입니다. 예외 필터가 EXCEPTION_EXECUTE_HANDLER로 평가되면 __try-__except 블록 내의 모든 __try-__finally 블록을 수행하는 것을 글로벌 언와인드라고 합니다.

글로벌 언와인드 수행 흐름

3-2. EXCEPTION_CONTINUE_EXECUTION

__try
{
	//...
}
__except(EXCEPTION_CONTINUE_EXECUTION)
{
	//예외 처리 수행
    //...
}

예외 필터가 EXCEPTION_CONTINUE_EXECUTION로 평가되면 예외를 발생했던 코드를 다시 한번 수행하도록 합니다. 만약, 예외 발생 후 적절한 조치가 취해지지 않았다면 다시 문제가 발생하게 되겠죠. 이 경우 또 다른 예외가 발생할 수도 있고 또는 무한 루프에 빠질 가능성도 있습니다. 이는 곧 디버깅이 어려워 문제 해결에 어려움이 발생하겠죠.

3-3. EXCEPTION_CONTINUE_SEARCH

__try
{
	//...
}
__except(EXCEPTION_CONTINUE_SEARCH)
{
	//예외 처리 수행
    //...
}

예외 필터가 EXCEPTION_CONTINUE_SEARCH로 평가되면, 가장 최근에 진입했던 __try 블록 중 __except 블록을 가진 곳으로 이동하여 예외 필터를 평가하게 됩니다. __try 블록이 __finally 블록을 가지고 있는 경우 검색 대상에서 제외됩니다.

예외가 처리되는 전체 흐름

앞에서 언급한 각 예외 필터의 동작 흐름을 한눈에 정리해 보겠습니다.

예외가 처리되는 전체 흐름

참고

Windows via C/C++ Fifth Edition, Jeffrey Richter

[.Net] 이미지 뷰어는 ImageGlass로 쉽게 개발하기

Sat, 13 Aug 2022 20:24:47 +0900

이미지 뷰어(Image Viewer)

비전 프로그램에서 이미지 뷰어는 실시간으로 취득되는 카메라 영상이나 검사 결과 이미지를 띄우는 역할을 합니다. 보통은 Picture Box나 Panel에다가 그리기 마련인데요. 만약, 무턱대고 카메라 영상을 받는 그대로 출력하면 프로그램 반응 속도에 영향을 주게 됩니다. 고해상도의 이미지를 컨트롤의 크기에 맞춰 Stretch 알고리즘을 사용하거나 빠른 속도로 컨트롤의 이미지를 업데이트하면 UI 반응 속도가 느려지기 때문입니다.

그런데 보통은 이런 걱정을 할 필요가 없습니다. 대부분의 프로그램은 영상을 천천히 띄우거나 빠르게 띄우더라도 실시간으로 프로그램을 조작하지 않기 때문입니다. 하지만 비전 프로그램과 같이 실시간으로 다수의 카메라 영상을 띄우면서 제어가 필요한 상황이라면 얘기가 달라집니다. 이미지 확대/축소, 마우스 Drag & Drop에 따른 이동, 실시간 갱신에 따라 응답 속도가 느려지면 사용자 입장에서는 참으로 답답하고 신뢰성이 떨어지기 때문입니다.

서론이 길었습니다. 그래서 본문에서는 이미지 뷰어를 어떻게 개발하는지, 그리고 ImageGlass 라이브러리를 사용하면 장점이 무엇이고 얼마나 개발하기 편리해지는지 설명합니다.

직접 이미지 뷰어 만드는 방법

ImageGlass를 설명하기에 앞서, 이미지 뷰어를 직접 어떻게 만드는지 알아보겠습니다.

동작 이해하기

아래와 같이 500x500 크기의 이미지와 400x400의 컨트롤이 있다고 예시를 들겠습니다.

그림 파일과 컨트롤의 크기

그림 파일의 가로, 세로 크기가 컨트롤의 크기보다 큽니다. 이 경우, 그림은 컨트롤에 다음과 같이 그려집니다.

그림이 컨트롤에 그려지는 모습

즉, 컨트롤의 영역을 벗어난 부분은 그려지면 안 되며, 마우스 드래그 앤 드롭이나 스크롤 바 이동으로 시작 offset이 적용되어 그려져야 합니다. 예를 들어, 시작 offset이 변경되면 다음과 같이 그려지게 됩니다.

이미지 offset 적용에 따라 그려지는 모습

마우스 드래그 앤 드롭에 따라 offset을 계산하기 위해서는 LButtonDown, LButtonUp, MouseMove 이벤트가 필요합니다. 나머지는 그림을 불러오고 그리는 함수만 구현하면 끝입니다. 물론, 필요에 따라 확대/축소 기능도 필요하고 오버레이가 필요할 수도 있습니다.

어쨌든, 이게 다입니다. 그럼, 실제 구현은 어떻게 하는지 코드를 알아보겠습니다.

따라 하기

ExamViewer 이름의 Windows Forms 앱 프로젝트를 생성합니다.

WinForm 프로젝트 생성하기

그리고 솔루션 파일에 MyViewer 이름의 컨트롤 라이브러리를 추가합니다.

컨트롤 라이브러리 생성하기

위와 같이 두 개의 프로젝트를 추가하면 아래와 같은 모습이 됩니다.

두 개의 프로젝트가 추가된 모습

UserControl1.cs의 코드 구현은 다음과 같습니다. 주석으로 간단한 설명을 추가했습니다.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Drawing.Imaging;
using System.Drawing.Drawing2D;
using System.Data;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace MyViewer
{
    public partial class UserControl1: UserControl
    {
        Point _leftClick = Point.Empty; //왼쪽 마우스 클릭 좌표
        Point _offset = Point.Empty; //마우스 드래그 앤 드롭 offset 계산
        Point _lastOffset = new Point(0, 0); //마지막 offset 보관 용도

        Bitmap _bitmap = null; //파일로 불러온 이미지
        Bitmap _canvas = null; //더블 버퍼링을 위한 배경 이미지
        SolidBrush _background = new SolidBrush(Color.FromArgb(255, 255, 255)); //배경 색상
        Rectangle _sizeCanvas = new Rectangle(0, 0, 0, 0); //배경 이미지의 크기

        Rectangle _sizeSrc = new Rectangle(0, 0, 0, 0); //배경 이미지에 그려질 원본 이미지의 위치
        Graphics _g = null; //그려질 컨트롤의 핸들

        public UserControl1()
        {
            InitializeComponent();

            _canvas = new Bitmap(this.Width, this.Height);

            _sizeCanvas.Width = this.Width;
            _sizeCanvas.Height = this.Height;

            _sizeSrc.X = 0;
            _sizeSrc.Y = 0;
            _sizeSrc.Width = this.Width;
            _sizeSrc.Height = this.Height;

            _g = this.CreateGraphics();
        }

        public void LoadImage(string path)
        {
            _bitmap = (Bitmap)Image.FromFile(path);

            draw(_g);
        }

        private void draw(Graphics g)
        {
            if (_bitmap != null)
            {
                var graphics = Graphics.FromImage(_canvas);

                graphics.FillRectangle(_background, _sizeCanvas);

                _sizeSrc.X = -_offset.X;
                _sizeSrc.Y = -_offset.Y;
                graphics.DrawImage(_bitmap, 0, 0, _sizeSrc, GraphicsUnit.Pixel);

                g.DrawImage(_canvas, 0, 0);
            }
        }

        private void UserControl1_MouseMove(object sender, MouseEventArgs e)
        {
            if (e.Button == MouseButtons.Left)
            {
                _offset.X = e.Location.X - _leftClick.X;
                _offset.Y = e.Location.Y - _leftClick.Y;

                _offset.X += _lastOffset.X;
                _offset.Y += _lastOffset.Y;

                draw(_g); //CPU 부하가 높음
            }
        }

        private void UserControl1_MouseDown(object sender, MouseEventArgs e)
        {
            if (e.Button == MouseButtons.Left)
            {
                _leftClick = e.Location;
            }
        }

        private void UserControl1_MouseUp(object sender, MouseEventArgs e)
        {
            if (e.Button == MouseButtons.Left)
            {
                _lastOffset = _offset;
            }
        }
    }
}

코드는 아래의 첨부된 파일을 참고하세요.

ExamViewer.zip

0.02MB

마우스 왼쪽 버튼의 클릭(Down, Up) 동작과 움직임(Move)에 따라 offset 좌표가 계산됩니다. 그리고 MouseMove 이벤트에서 왼쪽 버튼이 클릭되어 있다면(드래그 앤 드롭) 이미지 그리는 작업(draw)도 실시됩니다.

draw() 함수에서는 _bitmap을 컨트롤에 바로 그리지 않습니다. _bitmap을 컨트롤에 바로 그리게 되면, 이미지를 배경에 계속 덧그리게 되어 마우스 이동에 따라 잔상이 남게 됩니다. 바로 아래와 같은 모습이 됩니다.

이미지 이동에 따라 잔상이 남은 모습

그래서 컨트롤 크기에 맞는 임시 비트맵인 _canvas를 생성하여 더블 버퍼링으로 잔상이 남는 현상을 개선합니다. 아래 애니메이션은 위 코드의 동작을 보여줍니다.

뷰어 동작 화면

주의 사항

마우스로 드래그 앤 드롭을 심하게 움직이면 CPU 부하율이 상당히 높아지는 것을 볼 수 있습니다. 그리고 그려지는 이미지가 자연스럽지 않은 것도 말이죠. 위 예제 코드는 MouseMove 이벤트에 draw()를 호출하다 보니, 마우스 움직임에 따라 너무 많은 이벤트가 발생한 것이 원인입니다. 나중에는 확대, 축소 기능도 넣다 보면 더 심해질 것입니다.

그래서 이벤트를 줄이되 어떻게 자연스럽게 이미지를 그려낼지 방법을 찾는 것이 중요합니다. 하지만, 굳이 이런 고민을 하면서 이미지 뷰어를 만들 필요가 있을까요? 본인이 다 만들어서 나의 것을 만들어 가는 것도 좋지만, 우리에게 시간은 많지 않습니다.

이제 이러한 걱정을 할 필요가 없는, 무료로 사용 가능한 이미지 뷰어인 ImageGlass를 알아보겠습니다.

사용하기 편한 이미지 뷰어, ImageGlass

주요 특징

ImageGlass는 이미지를 볼 수 있도록 도와주는 아주 가벼운 응용 프로그램입니다. 윈도우 사진 뷰어처럼 이미지 파일을 더블 클릭하면 바로 띄어지는 프로그램입니다.

ImageGlass 사진 뷰어

주요 특징은 다음과 같습니다.

다양한 이미지 줌(확대/축소) 모드, 마우스 드래그 앤 드롭 이동 가능
클립보드로부터 이미지 열기 가능
70개 이상의 이미지 포맷 지원
gif 호환 가능하며, 이미지 프레임 추출 및 애니메이션 재생/일시 중지 가능
슬라이드 쇼
썸네일 보기
단축키 지원
칼라 채널 선택 가능
색상 및 픽셀 값 추출 가능
자르기 기능
다양한 언어 지원(한국어 포함)
설치형(installer)/실행형(portable) 지원

ImageViewer는 아래 공식 홈페이지에서 다운로드 가능합니다.

https://imageglass.org/release/imageglass-8-6-7-13-36

ImageGlass 8.6.7.13 | ImageGlass

Download ImageGlass 8.6.7.13

imageglass.org

그럼 개발하는 입장에서의 주요 특징도 알아보겠습니다.

위 언급한 기능과 동일
GNU General Public License Version3
오픈 소스
C# 지원(v8.x: .Net 4.8, v9.0: .Net 6)
하드웨어 가속 지원
ImageViewer Control 지원하여 쉽게 사용 가능

혹시 GNU GPLv3 라이선스가 궁금하다면 아래 링크를 참고하세요.

https://www.olis.or.kr/license/Detailselect.do?lId=1072

GNU General Public License version 3.0 (GPLv3)

www.olis.or.kr

ImageGlass 소스 코드는 아래 공식 Github 주소에서 다운로드 가능합니다.

https://github.com/d2phap/ImageGlass

GitHub - d2phap/ImageGlass: A lightweight, versatile image viewer

A lightweight, versatile image viewer. Contribute to d2phap/ImageGlass development by creating an account on GitHub.

github.com

따라 하기

ExamImageGlass 이름의 Windows Forms 앱 프로젝트를 생성합니다.

Windows Forms 프로젝트 생성하기

ImageGlass 라이브러리를 사용하기 위한 dll을 참조로 추가해야 합니다. 소스 코드를 다운로드하고 빌드해야 하지만, 저는 이 과정을 생략하고 실행 파일 경로에서 dll을 가져왔습니다.

설치 경로의 ImageGlass.ImageBox.dll 참조 추가하기

그리고 WinForm에 ImageBox 컨트롤을 추가합니다. 참고로, 저의 경우에는 Visual Studio의 디자이너에서 오류가 발생하여 코드로 직접 추가했습니다. 디자이너의 코드 예시는 다음과 같습니다.

namespace ExamImageGlass
{
    partial class Form1
    {
        //생략

        private void InitializeComponent()
        {
            this.viewer = new ImageGlass.ImageBoxEx();
            this.btnOpen = new System.Windows.Forms.Button();
            this.SuspendLayout();
            //
            // viewer
            // 
            this.viewer.Location = new System.Drawing.Point(5, 5);
            this.viewer.Name = "viewer";
            this.viewer.Size = new System.Drawing.Size(500, 500);
            this.viewer.Dock = System.Windows.Forms.DockStyle.None;
            // btnOpen
            // 
            this.btnOpen.Location = new System.Drawing.Point(513, 12);
            this.btnOpen.Name = "btnOpen";
            this.btnOpen.Size = new System.Drawing.Size(75, 23);
            this.btnOpen.TabIndex = 0;
            this.btnOpen.Text = "Open";
            this.btnOpen.UseVisualStyleBackColor = true;
            this.btnOpen.Click += new System.EventHandler(this.btnOpen_Click);
            // 
            // Form1
            // 
            this.AutoScaleDimensions = new System.Drawing.SizeF(7F, 12F);
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
            this.ClientSize = new System.Drawing.Size(600, 520);
            this.Controls.Add(this.btnOpen);
            this.Controls.Add(this.viewer);
            this.Name = "Form1";
            this.Text = "Form1";
            this.ResumeLayout(false);
        }

        private ImageGlass.ImageBoxEx viewer;
        private System.Windows.Forms.Button btnOpen;

        #endregion      
    }
}

Form1.cs의 코드는 다음과 같습니다.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using System.Diagnostics;

namespace ExamImageGlass
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            
            viewer.AllowClickZoom = true; //마우스 클릭으로 확대/축소
            viewer.ShowPixelGrid = true; //확대 시 Pixel Grid 활성화하기
        }

        private void btnOpen_Click(object sender, EventArgs e)
        {
            OpenFileDialog dlg = new OpenFileDialog();
            if (dlg.ShowDialog() == DialogResult.OK)
            {
                viewer.Image = Image.FromFile(dlg.FileName);
            }
        }
    }
}

ExamImageGlass.zip

0.01MB

사용 방법이 너무 간단하죠? AllowClickZoom은 마우스의 왼쪽 버튼은 확대, 오른쪽 버튼은 축소 동작을 의미합니다. 그리고 ShowPixelGrid는 확대 배율이 높아졌을 때 Grid를 표현하는 옵션을 의미합니다. 자세한 동작 결과는 아래 애니메이션을 보겠습니다.

ImageGlass 동작 화면

예제로 만든 뷰어보다 더 부드럽고 자연스럽게 그려집니다. 또한, 마우스 이동이나 스크롤 바 이동에 따라 이미지 이동도 가능합니다. 심지어 확대 배율이 높을 경우 Pixel Grid가 표현되어 구분이 더욱 쉬워집니다. 만약, 스크롤 바 사용을 원치 않는다면 사용하지 않겠다는 옵션을 지정하면 됩니다.

지금은 예시로 이미지를 불러오고 확대/축소 및 이동하는 모습만 보여드렸는데요. ImageGlass 사진 뷰어처럼 자르기 기능이나 좌표에 따라 픽셀 값을 얻는 기능, 채널 추출 등 필요한 기능을 사용할 수 있습니다.

티스토리 블로그 백업 프로그램 v2.6, 무료 배포합니다!

Thu, 11 Aug 2022 22:19:17 +0900

티스토리 블로그는 백업 기능을 제공하지 않지만, Tistory Open API를 제공하는데요. 이 API를 이용하여 티스토리 백업 프로그램을 제작해 보았습니다. 해당 프로그램을 사용하여 여러분의 티스토리 블로그를 안전하게 백업하세요.

프로그램 소개

백업 프로그램 특징

로그인한 계정의 모든 블로그 정보 표시
각 블로그의 이름, 주소와 모든 글 수 표시
각 글의 HTML 본문 내용과 첨부된 그림, 파일(pdf, zip 등) 저장
덮어쓰기, 건너뛰기, 이미지 저장 등 백업 옵션 제공
구 에디터, 신 에디터에서 작성된 모든 글 백업 가능

특징에 대한 내용은 아래 '더보기' 버튼을 클릭하여 확인할 수 있습니다.

블로그 목록 표시

로그인 후 메인 화면에는 소유 중인 블로그 목록이 표시됩니다.

블로그 목록

상위/하위 카테고리

티스토리 블로그의 카테고리 관리 메뉴에 설정된 그대로 폴더가 생성됩니다.

카테고리 목록

백업 완료 후 생성된 폴더는 아래와 같습니다.

생성된 카테고리 폴더

백업 결과

각 포스트는 선택한 옵션에 따라 포스트 제목 이름의 폴더에 백업이 됩니다. 참고로, 옵션에 따라 '제목 이름', '[날짜] 제목 이름' 그리고 '[글 번호] 제목 이름'으로 저장이 됩니다. HTML 본문은 content.html로 저장되고, 이미지 태그를 분석하여 첨부된 그림 파일을 개별 확장자로 저장합니다. 첨부된 파일(zip, pdf 등)도 같이 저장됩니다.

백업 결과물

프로그램 다운로드

다운로드 링크를 클릭하면, OneDrive 다운로드 화면으로 연결됩니다. 프로그램 사용 방법은 본문 하단에 작성되어 있습니다.

※ 다음(DAUM)에서 저품질 블로그로 지정되면 OpenAPI 접근이 불가합니다. 이 경우 백업이 안 되니 참고하세요.
※ 오래된 티스토리 에디터에서 작성된 게시물은 첨부 파일이 이미지 태그로 감싸져 있는 경우가 있습니다. 이는 이미지 저장으로 시도되고 결국 백업 실패로 이어집니다. 이에 따라 백업 결과에 실패가 기록되니 따로 저장해야 합니다.

☆Tistory Backup v2.6 다운로드(OneDrive)☆

업데이트 이력

업데이트 이력은 아래 '더보기' 버튼을 클릭하여 확인할 수 있습니다.

v2.6

이전 버전의 티스토리 에디터에서 작성된 이미지가 저장되지 않는 현상이 개선됐습니다.

v2.5

자동 로그인이 안되도록 변경했습니다(티스토리 문의 결과 Tistory REST API 로그아웃 기능은 지원이 안된다고 합니다).

v2.4

HTML 태그에 따라 이미지가 저장되지 않는 현상을 해결했습니다. 본문에 존재하는 img 태그는 모두 저장됩니다.
'카레고리 폴더 생성' 옵션을 추가했습니다. 체크하면 카테고리 이름 폴더에 각 포스트가 저장되고, 해제하면 블로그 이름 폴더에 일괄 저장됩니다.
카테고리 폴더 생성 옵션
'버그 신고' 기능을 추가했습니다. 백업 프로그램 사용 중 버그가 발생하면 해당 버튼을 클릭하여 신고해 주세요.
버그 신고 방법
백업 완료 후 저장 경로에 '백업 결과.txt'파일이 생성됩니다. 내용에는 블로그 이름과 저장된 포스트 개수 그리고 저장되지 못한 경우 어떤 게시물에서 무슨 에러가 발생했는지 간략히 기록됩니다.
기타 UI 변경.

v2.3

카테고리에 특수문자가 있는 경우, 백업 진행 중 데이터를 생성하지 못하는 문제를 해결했습니다.

v2.2

글 제목 마지막에 '...?'가 붙을 경우 경로 생성 문제를 해결했습니다.

v2.1

이미지가 연속 배치된 경우, 한 장만 저장되는 문제를 해결했습니다.
글 제목 중 마지막에 '.' 문자가 포함된 경우 경로 문제 에러가 발생하는 문제를 해결했습니다.
(실제 윈도우 폴더 생성 시 이름 마지막에 '.' 문자가 포함되면 '.' 문자가 자동으로 사라집니다. 백업 프로그램도 글 제목 마지막에 '.' 문자를 강제로 지우도록 수정했습니다.)
백업 시 폴더 제목은 '글 제목' 그대로 저장됐습니다. '글 제목'과 '[날짜] 제목', '[번호] 제목'을 선택할 수 있도록 옵션을 추가했습니다.

저장 옵션
기타 마이너 업데이트.

v2.0

전반적인 UI 교체.
블로그를 개별적으로 선택하여 백업 가능.
다양한 백업 옵션 제공.
카카오 로그인 인증 이슈 해결.
설치 파일로 제공.

v1.1

폰트 미적용 문제 수정.

v1.0

정식 버전 배포.

프로그램 사용 방법

프로그램 사용 방법은 아래 '더보기' 버튼을 클릭하여 확인할 수 있습니다.

로그인하기

프로그램 실행 시 로그인 화면으로 연결됩니다. 카카오 계정 또는 티스토리 계정 버튼을 클릭합니다.

로그인 화면

계정 아이디와 비밀번호를 입력하고 로그인 버튼을 클릭합니다.

로그인 계정 입력 화면

티스토리 API 접근을 위해 '허가하기' 버튼을 클릭합니다.

티스토리 API 접근 권한 화면

백업 옵션 설정하기

로그인 이후 아래의 화면에서 우측 하단의 '설정하기'버튼을 클릭하여 옵션을 설정할 수 있습니다.

백업 프로그램 메인 화면

아래와 같이 저장 경로와 저장 옵션을 선택할 수 있는데요. 각 항목의 설명은 아래 표와 같습니다.

백업 옵션

항목	설명
저장 경로	백업 파일이 저장될 위치를 선택합니다.
덮어 쓰기	이미 같은 '글'이 존재하더라도 덮어씁니다.
이미지 파일	이미지 파일 저장 여부를 선택합니다.
첨부 파일	첨부 파일 저장 여부를 선택합니다.
HTML 파일	HTML 파일 저장 여부를 선택합니다.
카테고리 폴더 생성	카테고리 별 폴더를 생성할지 여부를 선택합니다.
폴더 이름 옵션	폴더로 생성되는 글의 제목 형태를 선택합니다.

백업하는 방법

로그인 이후 아래의 화면에서 좌측 하단의 '백업 시작'버튼을 클릭하여 백업을 진행할 수 있습니다.

백업 시작 버튼

백업이 진행되면 하단에 진행률이 표시됩니다.

백업 진행 중인 화면

백업이 완료되면 아래와 같이 알림 창이 표시됩니다.

백업 완료 알림 화면

버그 신고 방법

프로그램 사용 중 문제가 발생하면 아래 '더보기' 버튼을 클릭하여 절차 확인 후 신고 부탁드립니다.

문제 발생 시 확인 절차

프로그램 우측 상단의 '버그 신고' 버튼을 클릭합니다.
버그 신고 버튼
'버그 신고 방법' 창 표시됩니다. 내용을 차근히 읽고 절차대로 진행합니다.
버그 신고 절차

[C++] RAII(SBRM)로 안전하게 리소스 관리하기

Wed, 27 Jul 2022 21:00:26 +0900

RAII(Resource Acquisition Is Initialization) - SBRM(Scope Bound Resource Managemnet)

가비지 컬렉터(Garbage Collector)가 있는 C#과 달리, C++ 프로그래밍에서 자원의 관리는 전적으로 개발자의 책임입니다. 힙(Heap) 영역에서 어떤 핸들을 생성했으면 반드시 해제하여 메모리 사용을 반환해야 하는 것이죠. 만약, 그렇지 않다면 메모리 누수가 발생하거나 예측 불가능한 상황에 직면할 수 있습니다.

여기서 자원(Resource)이라는 것은 흔히 얘기하는 사용자 버퍼 공간이 될 수도 있고, 소켓, 파일, GDI 등 어떤 객체의 핸들이 될 수도 있습니다. 이러한 자원을 생성하고, 스코프 영역(Scope bound)을 벗어나면 자동으로 해제하는 개념을 RAII라고 합니다. RAII를 디자인 패턴(Design pattern) 또는 관용구(Idiom)라고도 하죠.

참고로, RAII 이름이 개념에 비해 적절하지 않다는 의견이 있습니다. RAII 개념의 핵심은 파괴(해제)인데, 이름은 초기화이기 때문입니다. 그래서 SBRM(Scope Bound Resource Management)라는 이름이 생긴 것이죠. SBRM은 의미 그대로, 스코프 영역에서의 자원 관리를 뜻합니다. 좀 더 이해하기가 쉽죠?

아래 링크는 RAII 이름에 대한 번역가 류광님의 해석인데, 해당 링크도 읽어보면 좋을 것 같습니다.

https://occamsrazr.net/tt/297

C++ RAII(Resource Acquisition Is Initialization)의 해석

RAII라는 이름 자체에 대한 "꿈보다 해몽"

occamsrazr.net

RAII가 필요한 상황

그렇다면, RAII라는 것이 어떤 상황에서 필요한 것일까요? 몇 가지 예시를 들어 보겠습니다.

mutex가 안전하게 해제되지 않는 경우

아래 코드는 doSomething() 함수에 진입하면 mutex로 lock이 걸려 다른 리소스의 접근을 막게 되고, 이후 예외가 발생하여 가장 근접한 try-catch 문으로 빠져나가는 동작을 수행합니다.

#include <mutex>

std::mutex mutex;

void doSomething()
{
	mutex.lock();

	throw std::exception("예외 발생!");

	mutex.unlock();
}

int main()
{
	try
	{
		doSomething();
	}
	catch (const std::exception& exc)
	{
		std::cout << exc.what() << std::endl;
	}
}

즉, unlock이 호출되지 않은 채 불안정하게 함수를 빠져나가는 상황입니다. 이렇게 잠금이 해제되지 않은 채 프로그램이 종료되거나, 다른 곳에서 다시 lock을 호출하면 오류가 발생합니다.

이 경우에는 lock_guard를 사용하여 안전하게 mutex를 사용할 수 있습니다.

#include <mutex>

std::mutex mutex;

void doSomething()
{
	std::lock_guard<std::mutex> g(mutex);

	throw std::exception("예외 발생!");
}

int main()
{
	try
	{
		doSomething();
	}
	catch (const std::exception& exc)
	{
		std::cout << exc.what() << std::endl;
	}
}

lock_guard는 RAII 스타일 메커니즘이 적용된 편리한 mutex wrapper 클래스로, lock_guard 객체가 생성되면 mutex 소유권을 얻으려고 시도하고, 스코프 영역을 벗어나면 객체가 파괴되고 해제됩니다. 자세한 설명은 아래 링크를 참고하세요.

https://en.cppreference.com/w/cpp/thread/lock_guard

std::lock_guard - cppreference.com

template< class Mutex > class lock_guard; (since C++11) The class lock_guard is a mutex wrapper that provides a convenient RAII-style mechanism for owning a mutex for the duration of a scoped block. When a lock_guard object is created, it attempts to take

en.cppreference.com

사용자 메모리가 안전하게 해제되지 않는 경우

사용자 메모리를 생성하고 제거하기 위해 new와 delete를 사용합니다. 아래 예시는, 사용자 메모리를 생성했는데 어떠한 이유로 delete를 정상적으로 호출하지 않아 메모리 누수가 감지되는 상황입니다.

#define _CRTDBG_MAP_ALLOC
#include <cstdlib>
#include <crtdbg.h>

#ifdef _DEBUG
#define new new ( _NORMAL_BLOCK , __FILE__ , __LINE__ )
#endif

void doSomething()
{
	unsigned char* buffer = new unsigned char[100];

	throw std::exception("예외 발생!");

	delete buffer;
	buffer = nullptr;
}

int main()
{
	try
	{
		doSomething();
	}
	catch (const std::exception& exc)
	{
		std::cout << exc.what() << std::endl;
	}

	_CrtDumpMemoryLeaks();
}

위 코드를 실행하면 아래와 같이 메모리 누수가 감지됩니다. 해당 메시지를 더블 클릭하면 정확히 11번째 라인에서 메모리 누수가 있음을 알 수 있습니다.

메모리 누수가 감지된 결과

위 예시의 CRTDBG를 사용하는 방법은 아래 링크를 참고하세요.

[디버깅] 메모리 누수를 점검하는 방법 - CRTDBG (예제 포함)

메모리 누수와 관련된 포스팅은 아래 링크를 참고해주세요. [디버깅] 메모리 누수와 점검하는 방법 소개 [디버깅] 메모리 누수와 점검하는 방법 소개 소개 Unmanaged Code인 C++은 메모리 할당과 해제

luckygg.tistory.com

이렇게 사용자 메모리를 안전하게 사용하기 위해서는 스마트 포인터(Smart pointer)를 사용할 것을 권장합니다.

#include <vector>
#include <memory>

#define _CRTDBG_MAP_ALLOC
#include <cstdlib>
#include <crtdbg.h>

#ifdef _DEBUG
#define new new ( _NORMAL_BLOCK , __FILE__ , __LINE__ )
#endif

void doSomething()
{
	std::unique_ptr<std::vector<unsigned char>> buffer = std::make_unique<std::vector<unsigned char>>(100);
	
	throw std::exception("예외 발생!");
}

int main()
{
	try
	{
		doSomething();
	}
	catch (const std::exception& exc)
	{
		std::cout << exc.what() << std::endl;
	}

	_CrtDumpMemoryLeaks();
}

다소 복잡해 보이는데요. unsigned char를 vector로 구성하고, 이를 unique_ptr로 관리하는 방식입니다. 이 경우, 아래와 같이 직접 포인터 주소에 접근할 수 있습니다.

unsigned char* ptr = buffer->data();

이렇게 스마트 포인터를 사용하면 직접 메모리를 해제하지 않아도 자동으로 관리해 줍니다. 스마트 포인터에 대한 자세한 설명은 아래 링크를 참고하세요.

https://en.cppreference.com/book/intro/smart_pointers

smart pointers - cppreference.com

Warning: This wiki is part of the deprecated and unmaintained CppReference Book project. For up-to-date information on C++, see the main reference at cppreference.com. Smart pointers are used to make sure that an object is deleted if it is no longer used (

en.cppreference.com

[GigE Interface] GigE를 사용하기 위한 준비 Part 2.

Sun, 17 Jul 2022 00:10:07 +0900

GigE를 사용하기 위한 준비 Part 2.

본문 글은 아래 링크를 클릭해주세요.

[GigE Interface] Gigabit Ethernet(GigE) 인터페이스

Gigabit Ethernet(GigE) 효율적이고 신뢰할 수 있는 인터페이스. 낮은 비용, 향상된 시스템 유연성, 간단한 구성품, 신뢰할 수 있는 데이터 전송 및 산업 표준 정립 등의 이유로 Gigabit Ethernet이 머신 비

luckygg.tistory.com

GigE 인터페이스를 사용하기 위해서는 하드웨어뿐만 아니라 드라이버 설정과 소프트웨어도 준비를 해야 합니다. 일반적으로 준비 요소로는 아래 네 가지 정도가 있습니다.

네트워크 준비 요소

1. 네트워크 고급 속성

GigE 카메라를 사용하기 위해서는 네트워크 드라이버에서 설정해야 하는 권장 항목이 있습니다.

① 점보 프레임 또는 패킷(Jumbo Frame / Packet)

점보 패킷은 데이터를 한 번에 보낼 수 있는 최대 크기를 의미하며, 이는 MTU(Maximum Transmission Unit)라고도 정의합니다. 이 값은 데이터를 어느 정도의 크기로 나누어서 처리할 것인지를 설정하는 것인데, 값이 낮을수록 처리 량이 많아져 CPU 부하가 증가하고, 값이 높을수록 처리 량이 줄어들어 CPU 부하가 감소합니다. 기본 값은 1500 byte이며 권장 값은 9KB입니다.

② 수신 버퍼(Receive Buffers)

수신 패킷에 대해 어댑터가 사용할 수 있는 시스템 메모리의 버퍼 크기를 의미합니다. 네트워크 트래픽의 성능을 향상하는 설정이며, 카메라의 패킷 데이터 손실을 줄이기 위해서는 최대 값으로 설정하는 것을 권장합니다. Intel 칩셋의 경우 대부분 2048까지 지원하며 그 외의 칩셋은 값이 낮더라도 항상 최대 값으로 설정해야 합니다.

③ 인터럽트 조절 속도(Interrupt Moderation Rate)

인터럽트가 자주 발생하면 시스템 문제 발생 시 CPU의 반응 속도가 빨라지게 되지만, 작업 처리 효율이 낮아지는 단점이 있습니다. 반대로 인터럽트가 적게 발생하면 CPU의 반응 속도는 느려지지만 작업 처리 효율은 높아집니다. 이 설정 값을 '최대(Extreme)'로 설정하면 인터럽트 속도가 낮아지며 시스템 성능이 향상됩니다.

2. GigE SDK

카메라 제조사는 GigE SDK를 제공하며, 원칙적으로는 해당 제조사의 SDK를 사용해야 안정성을 확보할 수 있습니다. 즉, A사의 카메라를 사용하면 당연히 A사의 SDK를 사용해야 하고, B사의 카메라를 사용하면 B사의 SDK를 사용해야 합니다.

하지만 경우에 따라 A사의 카메라를 B사의 SDK에 또는 A사의 카메라를 3rd party SDK에 사용하는 경우도 있습니다. 같은 GenICam 기반의 SDK라면 문제가 없어야겠지만, 이렇게 사용하는 경우 반드시 호환성을 검증하고 진행해야 합니다.

그리고 가장 중요한 점은 시스템에 하나의 SDK만 설치해야 합니다. 대다수의 사용자들이 테스트 때문에 시스템에 여러 개의 SDK를 설치하고 사용하는 경우가 있습니다. 이 경우 서로 다른 제조사 드라이버들이 영향을 주어 카메라의 성능이 제대로 발휘되지 않을 수도 있습니다.

3. Filter Driver

카메라 제조사마다 GigE SDK 제공 시 필터 드라이버도 포함하여 제공합니다. 이 필터 드라이버는 네트워크의 부하를 줄여주며, 카메라의 데이터 스트리밍을 향상합니다. 별다른 이유가 없다면 반드시 필터 드라이버를 사용하는 것을 권장합니다.

4. Camera Packet Size

카메라에도 패킷 사이즈 설정 파라미터가 존재합니다. 일반적으로 이 값은 네트워크 어댑터의 설정된 값보다 작아야 하며, 대부분 8KB~9KB 정도로 설정합니다. 이 값이 너무 작으면 패킷 손실이 발생하여 영상 취득 시 데이터가 누락된 이미지가 얻어지게 됩니다.

[.Net] 네트워크 어댑터 IP주소와 고급 속성 변경하기(예제 포함)

Sat, 16 Jul 2022 23:51:52 +0900

네트워크 어댑터 IP 주소와 고급 속성

머신 비전에서 GigE 인터페이스를 사용하기 위한 네트워크 설정은 필수입니다. 카메라 연결 및 관리를 위한 고정 IP 주소 설정은 물론이고, 원활한 데이터 스트리밍을 위한 속성 설정 및 필터 드라이버(Filter Driver) 설치는 꼭 필요하죠.

설정이 필요한 네트워크 속성은 일반적으로 다음의 네 가지가 있습니다.

점보 패킷(Jumbo Packet)
수신 버퍼(Receive Buffers)
전송 버퍼(Transmit Buffers)
인터럽트 조절 속도(Interrupt Moderation Rate)

각 네트워크 속성의 의미는 아래 링크를 참고하세요.

[GigE Interface] GigE를 사용하기 위한 준비 Part 2.

GigE를 사용하기 위한 준비 Part 2. 본문 글은 아래 링크를 클릭해주세요. Gigabit Ethernet(GigE) 인터페이스 GigE 인터페이스를 사용하기 위해서는 하드웨어뿐만 아니라 소프트웨어에서도 준비를 해야

luckygg.tistory.com

그래서 IP 주소를 비롯하여, 위에서 언급한 속성을 코드에서 접근하기 위해서는 어떻게 해야 하는지 본문에서 다뤄보겠습니다.

1. 네트워크 IP 주소와 서브넷 마스크 얻는 방법

시스템에 존재하는 네트워크 어댑터의 목록과 IP 주소 그리고 서브넷 마스크를 얻는 방법입니다. System.Net.NetworkInformation 네임스페이스 추가하여 간단하게 어댑터의 정보를 얻을 수 있습니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Net.NetworkInformation; //NetworkInformation 네임스페이스 추가

namespace ExamNetwork
{
    class Program
    {
        static void Main(string[] args)
        {
            //모든 네트워크 인터페이스 얻기
            foreach (var network in NetworkInterface.GetAllNetworkInterfaces())
            {
                //IPv4를 지원하는 네트워크 확인
                if (network.Supports(NetworkInterfaceComponent.IPv4) == true)
                {
                    //이더넷 타입 확인
                    if (network.NetworkInterfaceType == NetworkInterfaceType.Ethernet)
                    {
                        //IP 속성 얻기
                        IPInterfaceProperties properties = network.GetIPProperties();
                        //Unicast 주소가 할당된 ip 얻기
                        foreach (UnicastIPAddressInformation uniIp in network.GetIPProperties().UnicastAddresses)
                        {
                            if (uniIp.Address.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
                            {
                                string ipAddress = uniIp.Address.ToString();
                                string subNetMask = uniIp.IPv4Mask.ToString();
                                Console.WriteLine("======================================");
                                Console.WriteLine($"Name: {network.Name}");
                                Console.WriteLine($"Description: {network.Description}");
                                Console.WriteLine($"Type: {network.NetworkInterfaceType}");
                                Console.WriteLine($"IP: {ipAddress}");
                                Console.WriteLine($"Subnetmask: {subNetMask}");
                            }
                        }
                    }
                }
            }

            Console.ReadLine();
        }
    }
}

코드가 너무 간단해서 그다지 설명할 것이 없습니다. 실행 결과는 다음과 같습니다.

네트워크 어댑터 기본 정보를 출력한 결과

위 예제는 아래 첨부된 파일을 참고하세요.

ExamNetwork_1.zip

0.00MB

2. 네트워크의 IP 주소와 서브넷 마스크 설정하는 방법

위 방법으로 IP주소를 설정할 수 있으면 좋겠지만 설정 기능을 지원하지 않습니다. 그래서 IP 주소를 설정하기 위해서는 다른 방법을 사용해야 합니다. 바로 WMI 클래스를 사용하는 것입니다.

WMI는 Windows Management Instrumentation으로, 윈도우 운영체제의 시스템 자원을 관리할 수 있는 집합입니다. 네트워크 어댑터의 IP 주소와 서브넷 마스크를 설정하기 위해, WMI 클래스인 Win32_NetworkAdapterConfiguration를 사용하는 것입니다.

이 클래스를 사용하기 위해서는 System.Management 어셈블리를 추가해야 합니다.

프로젝트에 어셈블리 추가하기

코드는 다음과 같습니다. 참고로, 비주얼 스튜디오 또는 실행 프로그램을 관리자 권한으로 실행해야 설정이 가능합니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Management; //Managemnet 네임스페이스 추가

namespace ExamNetwork
{
    class Program
    {
        static void Main(string[] args)
        {
            //Win32_NetworkAdapterConfiguration class 얻기
            ManagementClass management = new ManagementClass("Win32_NetworkAdapterConfiguration");
            ManagementObjectCollection networks = management.GetInstances();

            foreach (ManagementObject network in networks)
            {
                //네트워크 어댑터의 이름과 설명 얻기
                var description = network["Description"];
                var caption = network["Caption"];
                
                //EnableStatic Method 얻기
                var objStatic = network.GetMethodParameters("EnableStatic");
                //새로 지정할 IP 주소와 서브넷 마스크 지정하기
                objStatic["IPAddress"] = new string[] { "192.168.10.1" };
                objStatic["SubnetMask"] = new string[] { "255.255.255.0" };
                //EnableStatic Method에 파라미터를 넘겨 결과 반환 받기
                var result = (uint)network.InvokeMethod("EnableStatic", objStatic, null)["returnValue"];
                if (result != 0)
                    Console.WriteLine("IP 설정 실패.");
            }

            Console.ReadLine();
        }
    }
}

설정이 필요한 네트워크 어댑터 이름을 확인한 후 IP 주소와 서브넷 마스크를 설정합니다. 그리고 그 결과를 아래와 같이 확인할 수 있습니다.

네트워크 설정 결과

위 예제는 아래 첨부된 파일을 참고하세요.

ExamNetwork_2.zip

0.00MB

특히, 이 부분은 아래 마이크로소프트 문서를 참고하면 도움이 됩니다.

https://docs.microsoft.com/ko-kr/windows/win32/cimwin32prov/win32-networkadapterconfiguration?redirectedfrom=MSDN

Win32_NetworkAdapterConfiguration 클래스 - Win32 apps

네트워크 어댑터의 특성 및 동작을 나타냅니다. 이 클래스에는 네트워크 어댑터와 독립적인 TCP/IP 프로토콜 관리를 지원하는 추가 속성 및 메서드가 포함되어 있습니다.

docs.microsoft.com

3. 네트워크 어댑터 고급 설정 변경하기

네트워크 어댑터 고급 설정 화면

사실 이 부분을 찾기가 가장 까다로웠습니다. 점보 패킷(MTU), 수신 버퍼, 전송 버퍼 등과 같은 고급 설정을 변경하고 싶은데, 제공하는 함수를 도저히 찾을 수 없더군요. 그런데 알고 보니 아주 쉬운 방법이 있었습니다. 바로, 레지스트리를 변경하는 것이죠.

레지스트리 편집기에서 아래 경로로 이동하면, 시스템에 존재하는 네트워크 목록과 설정 값을 확인할 수 있습니다.

1. Win + R > regedit //레지스트리 편집기
2. 시작 > 레지스트리 편집기 실행

//네트워크 어댑터 목록 위치
컴퓨터\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4d36e972-e325-11ce-bfc1-08002be10318}

레지스트리 편집기에서 네트워크 어댑터의 고급 설정 편집

네트워크 어댑터의 주요 설정 이름은 다음과 같습니다.

항목	이름
Jumbo Packet(점보 패킷)	*JumboPacket
Receive Buffers(수신 버퍼)	*ReceiveBuffers
Transmit Buffers(전송 버퍼)	*TransmitBuffers
Interrupt Moderation(인터럽트 조절)	*InterruptModeration
Interrupt Moderation Rate(인터럽트 조절 속도)	ITR

즉, 설정이 필요한 네트워크 어댑터를 찾아서 해당 위치의 키(Key) 값(Value)을 변경하면 되는 것입니다. 아주 간단하죠? 이 방법도 비주얼 스튜디오 또는 프로그램을 관리자 권한으로 실행해야 합니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Win32; //Win32 네임스페이스 추가

namespace ExamNetwork
{
    class Program
    {
        static void Main(string[] args)
        {
            string network_registry = @"SYSTEM\CurrentControlSet\Control\Class\{4d36e972-e325-11ce-bfc1-08002be10318}";
            //레지스트리 열기
            RegistryKey regNetwork = Registry.LocalMachine.OpenSubKey(network_registry, false);

            //하위 키 이름 얻기
            var adapters = regNetwork.GetSubKeyNames();
            foreach (var adapter in adapters)
            {
                //어댑터의 레지스트리 얻기
                RegistryKey regAdapter = Registry.LocalMachine.OpenSubKey(network_registry + "\\" + adapter, true);

                //어댑터의 이름 얻기
                string deviceInstanceID = regAdapter.GetValue("DriverDesc").ToString();
                //점보 패킷 값 읽기
                var value = Convert.ToInt32(regAdapter.GetValue("*JumboPacket"));
                //점보 패킷 값 쓰기
                regAdapter.SetValue("*JumboPacket", "9014", RegistryValueKind.String);
            }

            Console.ReadLine();
        }
    }
}

위 예제 코드는 점보 패킷을 확인하고, 값을 9014로 설정하는 방법을 보여줍니다. 다른 설정 값도 위와 같이 적용하면 설정 값 변경이 가능합니다.

점보 패킷이 변경된 모습

위 예제는 아래 첨부된 파일을 참고하세요.

ExamNetwork_3.zip

0.00MB

정리

위에서 보여준 세 가지 방법을 조합하면 네트워크 목록을 확인하고, IP 주소와 고급 설정을 원하는 대로 변경할 수 있는 동작을 구현할 수 있습니다.

[디버깅] Visual Studio C# 원격 디버깅(Remote Debugging) 사용 방법

Fri, 3 Jun 2022 22:05:02 +0900

C#에서 원격 디버깅(Remote Debugging)하기

원격 디버깅 주제는 이전에 MFC 환경에서 한 번 다뤘었습니다. 간단하게 다시 정의하면, 원격 디버깅은 개발 환경이 없는 PC에서 프로그램을 실행하고, 로컬 PC에서 디버깅을 하는 것을 의미합니다. 자세한 내용은 아래 링크를 참고하세요.

[디버깅] Visual Studio 2015 MFC 원격 디버깅(Remote Debugging)하기!

원격 디버깅(Remote Debugging)? 일반적으로 디버깅이라 함은 컴파일러에서 디버그 모드로 동작하고, 코드를 한 줄 한 줄 실행하며 문제를 찾아가는 과정을 의미합니다. 그런데 원격 디버깅이란 무엇

luckygg.tistory.com

원격 디버깅을 위한 네트워크 구성

원격 디버깅을 위해 로컬 PC와 원격 PC는 같은 네트워크에 존재해야 합니다. 아래 그림과 같이 로컬 PC와 원격 PC를 직접 랜 케이블로 연결하여 네트워크를 구성하면 원격 디버깅이 가능합니다.

직접-연결한-네트워크-구성

또는 허브에 연결되어 있는 PC끼리도 원격 디버깅이 가능합니다.

동일-허브에-연결되어-있는-네트워크-구성

원격 PC 준비 과정

1. 원격 디버거 설치

원격 디버깅을 위해 원격 PC에서 원격 디버거를 먼저 실행해야 합니다. 개발환경이 있는 PC라면 버전에 따라 경로가 다소 다르지만, 보통 아래와 같은 경로에 원격 디버거 프로그램이 존재합니다.

C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

만약, 개발환경이 없는 PC라면 원격 디버거를 따로 다운로드해야 합니다. Visual Studio 버전에 따른 원격 디버거는 아래 링크에서 다운로드 가능합니다.

https://docs.microsoft.com/ko-kr/visualstudio/debugger/remote-debugging-csharp?view=vs-2022

원격 디버그 C# 또는 VB 프로젝트 - Visual Studio (Windows)

다음 단계별 지침에 따라 원격 컴퓨터에서 Visual Studio C# 또는 Visual Basic 애플리케이션을 디버그하는 방법을 알아봅니다.

docs.microsoft.com

2. 원격 디버거 관리자 권한 실행

원격 디버거를 설치한 후 관리자 권한으로 실행합니다.

원격 디버거를 관리자 권한으로 실행하기

실행하면 아래와 같이 프로그램이 생성되고, PC 이름과 포트 번호가 표시됩니다. 이 정보를 가지고 로컬 PC에서 접속하게 됩니다.

PC이름과포트 번호가 표시된 모습

로컬 PC 준비 과정

C# 프로젝트를 준비합니다. 예시로, 간단하게 문자열을 입력받는 Console 프로그램을 준비해 봤습니다.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace ExamRemoteDebugger
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Remote Debugger Sample Program");
            string input = Console.ReadLine();   
        }
    }
}

프로젝트의 속성 메뉴를 선택합니다. 그리고 디버그 탭에서 원격 컴퓨터 사용을 체크합니다. 그리고 원격 PC에서 원격 디버거를 실행했을 때 표시됐던 PC 이름과 포트를 옆의 입력란에 입력합니다.

원격 컴퓨터 사용 체크 및 컴퓨터 정보 입력

이제 프로젝트를 빌드합니다. 프로젝트를 빌드하면 아래 Debug 경로에 파일이 생성됐을 건데요. 이 파일을 원격 PC에 동일한 경로로 복사합니다.

빌드 후 생성된 Debug 파일

주의

코드를 수정할 때마다 이 과정을 반복해야 합니다. 로컬 PC와 원격 PC의 정보가 정확히 일치해야 원격 디버깅이 가능하기 때문입니다.

이제 로컬 PC에서 디버깅을 시작하면, 원격 PC의 원격 디버거에서 다음과 같이 메시지가 표시됩니다.

원격 디버거에 접속된 로컬 PC의 정보

만약, 원격 PC에서 계정 비밀번호가 설정되어 있다면 계정 이름과 비밀번호가 필요합니다.

원격 PC의 계정 정보 입력

이제 로컬 PC에서 원격 PC의 제어로 디버깅이 가능해집니다!

원격 PC 원격 디버깅 중인 모습

[ASP.NET] 시놀로지 도커(Docker)에서 셀레니움(Selenium) 서비스 만드는 방법

Sat, 28 May 2022 09:38:31 +0900

도커(Docker) 셀레니움(Selenium) 서비스

현재 근무하고 있는 회사에는 전자 결재를 위한 이카운트 ERP를 사용하고 있습니다. 이 서비스는 실시간으로 자료 입력과 조회가 가능하고, 전자 문서 결재 진행 상황을 확인할 수 있죠. 게다가 모바일 앱과 웹 기반 서비스를 제공하고 있어 인터넷만 된다면 언제 어디서든 사용이 가능합니다. 또한, 개발자를 위한 REST API도 제공하고 있습니다.

그런데 한 가지 아주 아쉬운 부분이 있습니다. 업무 특성상 특정 결과를 실시간으로 알람 받고 싶은데, 하필 이 부분만 API로 제공하지 않더군요. 고객센터에도 문의해봤지만 API가 없는 것이 맞고, 아직 개발 계획도 없다고 하더군요.

하지만 방법이 아주 없지는 않았습니다. 제가 생각한 구상은 시놀로지 서버의 도커에서 ERP 웹 페이지의 특정 항목을 셀레니움으로 확인하는 것인데요. 당연히 될거라 생각했고, 결국 원하는 결과를 얻을 수 있었습니다. 이번 본문에서는 도커에서 셀레니움 서비스를 동작하기 위한 준비 과정과 동작 결과를 설명하겠습니다.

작업 구상

셀레니움으로 특정 웹사이트에 접속한 후 특정 데이터를 취득합니다. 그리고 조건이 성립하면 시놀로지 챗(Chat)의 챗봇으로 메시지를 전송하여 알림을 받도록 합니다. 이 동작을 도커 서비스로 제작합니다.

서비스-구상도

준비 단계

1. 셀레니움(Selenium) 익히기

셀레니움은 웹 브라우저 자동화를 위한 라이브러리입니다. 본문에서는 특정 웹 페이지에서 특정 데이터들을 확인하는 작업을 수행할 예정입니다. 아래 링크를 참고하여 셀레니움을 어떻게 사용해야 하는지 알아보세요.

[셀레니움/Selenium, C#] C#에서 셀레니움을 사용하는 방법 총정리

셀레니움(Selenium)이란? 셀레니움은 웹 브라우저 자동화를 위한 라이브러리입니다. 눈에 보이는 모든 콘텐츠에 입력, 클릭, 가져오기 등이 가능합니다. 간단한 웹 사이트 접속부터 로그인, 검색,

luckygg.tistory.com

2. 챗봇 연동하기

시놀로지는 챗(Chat)이라는 메신저를 제공합니다. 셀레니움으로 얻은 데이터를 챗의 챗봇과 연동하여 알림을 받을 겁니다. 아래 링크를 참고하여 챗봇을 어떻게 연동하는지 참고하세요.

[챗봇/.NET] C#에서 시놀로지 Chat에 챗봇 메시지 보내기(예제 포함)

시놀로지 Chat 메신저 시놀로지에는 Chat이라는 메신저를 제공하고 있습니다. 이는 패키지 센터에서 설치가 가능한데요. 주요 특징은 다음과 같습니다. 무료로 사용 가능 메시지 고정(공지 사항),

luckygg.tistory.com

3. 리눅스(Linux) 작업자 서비스 만들기

시놀로지 도커에서 서비스를 구동하려면, 리눅스 도커용 작업자 서비스를 만들어야 합니다. 아래 링크를 참고하세요.

[ASP.NET] C# 시놀로지 Linux Docker 용 작업자 서비스 만드는 방법

Linux Docker 작업자 서비스 지난 포스팅에서 ASP.NET Core Worker Service를 빌드하여 Windows 용 Docker에서 서비스를 동작하는 방법을 소개했었습니다. 이번에는 Linux Docker를 위한 작업자 서비스를 제작하려.

luckygg.tistory.com

4. 시놀로지 작업 스케줄러 적용하기

이상하게도 Linux Docker에서 셀레니움을 사용하면 메모리 누수(Memeory leak)가 발생합니다. 이상한 점은 객체를 한 번만 생성하고 사이트로 이동하는 함수만 호출하는데도 누수가 발생합니다. 도대체 왜 생기는지 이유를 아직도 찾지 못했습니다. 이렇게 메모리 누수가 발생하여 사용 가능한 메모리가 부족해지면 시놀로지 나스가 어느 순간 응답이 없는 상태가 됩니다.

그래서 업무 시간에만 서비스가 동작하고 멈추도록 스케줄러를 적용하여, 서비스가 종료되면 메모리를 회복할 수 있도록 편법을 적용했습니다. 시놀로지 작업 스케줄러 사용 방법은 아래 링크를 참고하세요.

[Synology NAS] 작업 스케줄러로 작업 예약하기(사용자 정의 스크립트)

작업 스케줄러란? 시놀로지 나스의 제어판에는 작업 스케줄러 메뉴가 있습니다. 이 작업 스케줄러를 사용하여 특정 시간에 특정 서비스나 스크립트를 예약하고 실행할 수 있습니다. 예를 들어,

luckygg.tistory.com

핵심

Linux 작업자 서비스를 만드는 전반적인 과정은 아래 링크를 참고합니다.

[ASP.NET] C# 시놀로지 Linux Docker 용 작업자 서비스 만드는 방법

luckygg.tistory.com

도커 작업자 서비스에서 셀레니움을 사용하기 위해서는 다음과 같은 옵션 설정이 필요합니다. 그 외 사용 방법은 동일합니다.

ChromeDriverService _driverService = ChromeDriverService.CreateDefaultService();
_driverService.HideCommandPromptWindow = true;

ChromeOptions _options = new ChromeOptions();
_options.AddArgument("disable-gpu");
_options.AddArgument("headless");
_options.AddArgument("no-sandbox");
_options.AddArgument("disable-dev-shm-usage");

ChromeDriver _driver = new ChromeDriver(_driverService, _options);

서비스 빌드를 위한 Dockerfile은 다음과 같이 작성합니다. 도커에서 구성 요소를 설치하고, 크롬 드라이버를 설치하는 과정을 의미합니다.

FROM mcr.microsoft.com/dotnet/runtime:5.0 AS base

COPY . /app
WORKDIR /app
 
#포트 번호는 예시로 8888
ENV ASPNETCORE_URLS http://*:8888
EXPOSE 8888

# RUN apt-get update
RUN apt-get update && apt-get install -y gnupg2
RUN apt install -y wget

# CHROME
RUN wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -
RUN sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/goodle.list'
RUN apt-get update
RUN apt-get install -y google-chrome-stable

# CHROME_DRIVER
RUN apt-get install -yqq unzip
RUN apt-get install -y curl
RUN wget -O /tmp/chromedriver.zip http://chromedriver.storage.googleapis.com/`curl -sS chromedriver.storage.googleapis.com/LATEST_RELEASE`/chromedriver_linux64.zip
RUN unzip /tmp/chromedriver.zip chromedriver -d /usr/local/bin/
ENV DISPLAY=:99
 
#ExamWorkerService는 프로젝트 이름
ENTRYPOINT ["dotnet", "WorkerService.dll"]

앞에서 언급한 것처럼, 도커 서비스에서 셀레니움을 동작하면 메모리 누수가 발생합니다. 작업자 스케줄러에 사용자 정의 스크립트를 추가하여 특정 시간 동안만 동작하고 종료되도록 설정합니다.

docker container start [컨테이너 이름]
docker container stop [컨테이너 이름]

동작 결과

셀레니움으로 얻은 데이터 중 알림이 필요한 정보를 파싱하여 챗봇으로 메시지를 전달하면, 아래 이미지처럼 챗봇 메시지를 얻을 수 있습니다. 이 메시지가 PC나 스마트폰에 알림이 되어 실시간으로 업무 확인이 가능하게 됐습니다.

동작-결과

[Synology NAS] 작업 스케줄러로 작업 예약하기(사용자 정의 스크립트)

Sun, 1 May 2022 10:39:26 +0900

작업 스케줄러란?

시놀로지 나스의 제어판에는 작업 스케줄러 메뉴가 있습니다. 이 작업 스케줄러를 사용하여 특정 시간에 특정 서비스나 스크립트를 예약하고 실행할 수 있습니다. 예를 들어, 휴지통을 주기적으로 비울 수도 있고, 나스 전원을 주기적으로 리부팅할 수도 있습니다.

이 작업 스케줄러는 직접 설정할 수도 있지만 자동으로 등록되는 경우가 있습니다. 하이퍼 백업 기능을 사용하면 스케줄러에 자동으로 등록되어 있는 것을 확인할 수 있습니다. 반복되는 작업이 있다면 스케줄러를 활용하는 것이 좋습니다.

작업-스케줄러-메뉴

작업 스케줄러 종류

작업 스케줄러에 등록할 때 기본적으로 4가지를 추가할 수 있습니다.

작업-스케줄러-종류

1. 사용자 정의 스크립트

사용자가 작성한 스크립트를 실행하는 메뉴입니다. 스크립트 작성으로 도커의 특정 컨테이너를 실행, 종료할 수도 있습니다. 개인적으로 아주 유용하게 사용하고 있는 스케줄러입니다. '서비스'는 도커 자체를 시작하거나 중지할 수 있는데요. '사용자 정의 스크립트'를 사용해서 도커의 특정 컨테이너를 시작하거나 중지할 수 있습니다.

스크립트는 다음과 같이 적용합니다.

docker container start containername
docker container stop containername

사용자 정의 스크립트를 적용하는 자세한 방법은 이후에 나오는 내용에서 설명합니다.

2. 휴지통

모든 휴지통 또는 특정 공유 폴더의 휴지통을 비우는 기능입니다. 모든 파일을 삭제하거나 특정 파일의 개수가 유지될 때, 크기 제한 등 여러 옵션을 설정할 수도 있습니다.

3. 신호음 제어

말 그대로 시놀로지 나스의 신호음을 발생하는 메뉴입니다.

4. 서비스

시놀로지 패키지 서비스를 시작하거나 중지할 수 있는 메뉴입니다.

5. 트리거된 작업

해당 작업은 특정 이벤트 완료 전, 후에 실행되는 스케줄러입니다. 사용자 정의 스크립트만 사용이 가능합니다.

사용자 정의 스크립트로 스케줄러 생성하기

목적

도커 서비스를 개발하던 도중 아주 난감한 문제에 봉착했는데요. 바로, 메모리 누수였습니다. 서비스가 잘 동작하는 줄 알았는데, 시간이 흐르면서 메모리 사용량이 쌓여가고 하루가 지나니 나스가 먹통이 되는 현상이었죠.

하지만 도커 서비스는 무엇이 문제인지 디버깅이 어렵습니다. 개발환경에서 동작하는 것이 아니라, 실제 운영하는 것이기 때문이죠.

그래서 대안책을 찾은 것이, 특정 시간에 서비스를 켜고 끈다면 메모리 누수를 회복하고 계속해서 서비스를 운영할 수 있겠다는 것이죠.

적용 방법

서론이 좀 길었습니다. 그럼, 사용자 정의 스크립트를 어떻게 추가하는지 설명하겠습니다. 아래 그림과 같이 사용자 정의 스크립트 메뉴를 선택합니다.

생성 > 예약된 작업 > 사용자 정의 스크립트

사용자-정의-스크립트-추가하기

아래와 같이 작업 생성 창이 표시되면 작업 란에 이름을 기입합니다.

작업-이름-기입하기

스케줄 탭에서는 해당 스크립트를 언제 실행할지 요일과 시간을 선택할 수 있습니다.

요일과-시간-선택하기

마지막으로 작업 설정 탭에서는 사용자 정의 스크립트를 기입할 수 있습니다. 아래 그림의 스크립트는 notifyerp라는 컨테이너를 시작하라는 명령어입니다.

사용자-정의-스크립트-입력-화면

사용자 정의 스크립트가 추가되면 아래 그림과 같이 목록에 표시됩니다.

사용자-정의-스크립트가-추가된-모습

[Visual Studio] 비주얼 스튜디오 2019에서 깃랩(GitLab) 패키지 사용하는 방법

Tue, 19 Apr 2022 17:27:36 +0900

깃랩(GitLab) 패키지

깃랩(GitLab)은 깃(Git), 깃헙(GitHub)과 마찬가지로 소스 코드의 버전 관리를 위한 시스템입니다. 종류에 따라 설치형도 있고, Console이나 GUI로 제공되는 형태도 있습니다. 그리고 언급한 세 가지 모두 비주얼 스튜디오에서 패키지(플러그인)로도 제공하고 있습니다. 기본적인 개념만 알고 있다면, 굳이 명령어를 입력하지 않고 플러그인 조작으로 쉽게 사용할 수 있는 것이죠.

여기서 문제가 있습니다. 비주얼 스튜디오 2019에는 기본적으로 소스 제어 옵션으로 깃과 Team Foundation Server를 제공하고 있는데요. Visual Studio 2019부터 새로운 옵션이 활성화되어, 이전에 사용하던 깃 메뉴가 보이지 않는 것이죠. 물론, 새로 배워서 사용해도 되겠지만 기존에 사용하던 방식이 익숙하다 보니 불편하긴 합니다.

그래서 이번 포스팅에서 이전과 같이 깃랩 패키지 메뉴를 사용하는 방법을 공유합니다.

New Git user experience 옵션 끄기

해당 기능은 Visual Studio 2019부터 지원되는데요. 기본 값으로 켜져 있으며 옵션의 위치는 다음과 같습니다.

비주얼 스튜디오 > 도구 > 옵션 > 환경 > 미리 보기 기능 > New Git user experience

New Git user experience 옵션 위치

위 옵션이 켜져있으면 Git 변경 내용 화면이 아래와 같이 표시됩니다.

Git 변경 내용 창

그리고 Git 리포지토리 만들기 버튼을 클릭하면 아래와 같은 창이 표시됩니다. 마이크로소프트가 GitHub을 인수한 이후 비주얼 스튜디오 기본 옵션으로 GitHub이 추가되었습니다.

Git 리포지토리 만들기 화면

평소에 사용하던 메뉴와 다르죠. 깃랩 계정 연동 후 Git 변경 내용 메뉴를 보면 버튼의 위치와 아이콘이 변경됐습니다.

새로 변경된 메뉴

새로운 메뉴에 익숙해지기위해 그대로 사용하려면 그냥 사용하시면 됩니다. 하지만 불편하다면 위에서 언급한 옵션을 비활성화하면 되겠습니다. 아래는 옵션을 끈 모습입니다. 아주 친숙한 모습이죠.

옵션이 해제된 모습

프로필

Tue, 5 Apr 2022 22:07:05 +0900

안녕하세요, LuckyGg입니다.

저의 블로그에 방문해 주셔서 감사합니다.

저는 현재 머신 비전 업계에서 근무 중이며, 개인적으로 개발하고 싶은 것들을 공부하고 프로그램을 만드는 것에 재미를 느끼는 사람입니다.

블로그 운영 초반에는 여행이나 후기 같은 것들도 올렸는데, 방향성을 정립한 이후로는 머신 비전과 프로그래밍, IT 관련 내용으로만 운영하고 있습니다.
(여기에 건강 이야기도 덤으로 하고 있습니다. 건강해야 오래오래 일하니까요 )

아직도 배우고 습득해야 할 지식이 넘쳐나서, 언제 제 것으로 만들고 포스팅해야 할지 막막하지만 열심히 해 보겠습니다.

앞으로도 제 블로그에 자주 방문 부탁드리며, 궁금한 점이 있으시면 언제든지 아래 메일로 연락주세요.

LuckyGg: skyupju124@gmail.com

C# Project, Solution Rename 이름 변경 프로그램을 무료 배포합니다!

Tue, 8 Mar 2022 22:38:30 +0900

솔루션 및 프로젝트 이름 변경 프로그램

가끔 테스트 프로젝트를 생성하고 개발하다가 문제가 없으면 해당 프로젝트를 본 프로젝트로 사용하고 싶은 경우가 있습니다. MFC를 사용할 때에는 아래 링크의 프로그램을 사용했었는데요.

https://blog.daum.net/prodori/15684145

프로젝트명 변경

프로젝트 문자 변경 툴로 vsrename을 사용하다가 Visual Studio 2010과 같은 유니코드나 UTF_8 포맷으로 작성된 문서들에 대해서 오동작을 하여 직접 만들어 본 툴입니다. ProjectRename.exe 실행 화면은 다

blog.daum.net

이상하게 C# 솔루션(*.sln)이나 프로젝트(*.csproj) 이름을 변경해주는 프로그램을 제공하는 곳이 없더군요. 누군가 만들어서 배포할 거라 생각했지만, MFC에 비해 이름 변경이 간단해서 그런지 프로그램을 찾지 못했습니다.

그래서 어차피 필요한 거, 프로그램을 직접 만들어서 배포하기로 했습니다.

C#에서 Project, Solution 이름 변경하는 방법

C# 기준 솔루션 및 프로젝트 파일은 이름을 어떻게 변경하는지 알아보겠습니다. 자세한 내용은 아래 '더보기' 버튼을 클릭하세요.

1. Solution 이름 변경하는 방법

보통 프로젝트를 생성하면 솔루션 이름이 프로젝트 이름과 동일하게 생성됩니다. 이후 새로운 프로젝트를 추가하면 아래와 같은 모습이 됩니다.

솔루션 이름 변경 전

솔루션 이름을 변경하는 방법은 아주 간단합니다. *.sln 확장자는 유지하고 파일명만 변경하면 됩니다.

솔루션 이름 변경 후

2. Project 이름 변경하는 방법

프로젝트 이름 변경 방법은 솔루션 파일 이름 변경보다 조금 까다롭습니다. 위 이미지의 예시로 설명하면 다음과 같습니다.

① 하위 프로젝트 경로 폴더 이름을 새로운 이름으로 변경합니다. 또는 변경하지 않아도 됩니다.
② 하위 프로젝트 경로의 *.csproj의 이름을 새로운 이름으로 변경합니다.
③ 변경한 *.csproj 파일을 메모장으로 엽니다.
④ 아래 표시한 부분을 새로운 이름으로 변경합니다.

csproj 내용 변경하기

⑤ *.sln 파일을 메모장으로 엽니다.
⑥ 아래 표시한 부분을 새로운 이름과 *.csproj가 존재하는 경로로 변경합니다.

sln 내용 변경하기

CS Rename 프로그램 특징

솔루션(*.sln) 파일이 존재하는 폴더를 선택하면 하위 프로젝트(*.csproj) 파일을 모두 탐색
솔루션 및 프로젝트 파일 이름 변경 시 폴더 이름도 선택적 변경 가능
비설치 exe 단독 파일

프로그램 다운로드

아래 첨부된 파일을 다운로드하세요.

RenameCSProject v1.0.zip

0.10MB

업데이트 이력

업데이트 이력은 아래 '더보기' 버튼을 클릭하여 확인할 수 있습니다.

v1.0

정식 버전 배포.

프로그램 사용 방법

프로그램 사용 방법은 아래 '더보기' 버튼을 클릭하여 확인하세요.

프로그램을 실행하면 다음과 같은 화면이 표시됩니다.

프로그램 실행 화면

우측 상단의 버튼을 클릭하면 *.sln 파일을 선택하는 화면이 표시됩니다. 이름 변경이 필요한 *.sln 파일을 선택하면 솔루션 파일과 하위 프로젝트 파일 목록이 표시됩니다.

솔루션 파일 선택하기

이름 변경이 필요한 *.sln 또는 *.csproj을 선택한 후 새로운 이름을 입력합니다. 폴더 경로까지 변경하려면 체크 박스를 체크합니다. 이후 Convert 버튼을 클릭하면 이름이 변경됩니다.

이름이 변경된 모습

버그 신고 방법

프로그램 사용 중 문제가 발생하면 '오류가 발생하는 절차'와 '증상'을 댓글로 남겨주세요.

[ASP.NET] Core Worker Service로 레드마인 일감을 시놀로지 챗 메시지로 알림 보내기

Fri, 4 Mar 2022 20:22:13 +0900

개발 배경

저는 회사에서 업무 관리를 위해 시놀로지 도커에서 레드마인을 사용하고 있습니다. 그리고 레드마인의 메일 설정을 통해 일감 생성, 편집 시 메일로 알림을 받고 있습니다. 메일의 경우 아웃룩으로 확인하고 있습니다. 그런데 지금까지 레드마인을 사용하면서 너무나 아쉬운 점이 있었습니다. 바로 알림을 즉시 확인할 수 없다는 것이죠

레드마인 알림이 있는지 확인하기 위해 아웃룩에서 직접 보내기/받기 버튼을 클릭하거나 시간 간격을 짧게 설정해야 했습니다. 하지만 PC에서는 이렇게 확인하면 되지만 스마트폰에서는 알림 받기가 쉽지 않습니다. 알림을 켜자니 수신되는 모든 메일에 대해 알림이 오니 영 불편했습니다

그래서 생각한 것이, '레드마인 일감이 생성되면 메신저로 알림을 줄 수 있지 않을까'입니다. 게다가 저는 사내 메신저로 시놀로지 챗(Chat)을 사용하고 있기 때문에, 챗으로 알림 메시지를 받길 원했습니다

그런데 역시나 안 되는 건 없더군요. 레드마인은 REST API를, 챗은 Incoming Webhook을 제공하고 있었습니다. 즉, 실시간으로 레드마인 REST API를 호출하여 신규 일감을 조회하고, 일감이 있다면 챗으로 메시지를 보내면 되는 것이죠!

구상도

ASP.NET Core Worker Service

그런데 문제가 있었습니다. '어디'에서 프로그램을 돌리느냐입니다. 처음에는 특정 컴퓨터에 프로그램을 실행해 무한 루프로 계속 돌릴지, 아니면 윈도우 서비스로 개발하여 컴퓨터가 켜지면 계속 돌아가게 할지 고민을 했었습니다. 그런데 생각해보니 저는 시놀로지 서버를 사용하고 있었습니다. 즉, 서버에 개발한 프로그램을 돌리면 되지 않을까 싶었죠. 그래서 알게 된 것이 ASP.NET Core였습니다.

ASP.NET Core는 Windows, macOS 및 Linux에서 인터넷 연결 앱을 동작할 수 있는 프레임 워크입니다. 그리고 C#을 지원합니다. 즉, 간단히 설명하면 제가 원하는 동작을 수행하는 코드를 빌드하고 그 결과물을 ASP.NET Core를 통해 서비스를 동작할 수 있다는 것입니다.

게다가 Visual Studio에서 제작 가능한 ASP.NET Core Worker Service(작업자 서비스) 템플릿은 장기간 실행되는 서비스 앱을 개발하기 위해 제공됩니다. 즉, 이번 구상과 같이 멈추지 않고 계속해서 돌릴 서비스를 제작하기 위한 프로젝트라는 것이죠.

개발 순서

이제 본격적으로 개발에 돌입하기에 앞서, '어떻게' 개발해 나갈 것인지 설명하겠습니다. 중간 중간 내용이 꽤 많아서 하위 포스팅을 첨부했습니다.

1. 테스트 프로그램

우선 레드마인 REST API와 시놀로지 챗 Incoming Webhook을 연동할 줄 알아야겠죠? 레드마인 REST API와 Incoming Webhook을 다루는 방법은 아래 링크를 참고하세요.

[.Net] C# 레드마인 REST API 사용하는 방법(예제 포함)

[챗봇/.NET] C#에서 시놀로지 Chat에 챗봇 메시지 보내기(예제 포함)

2. Windows Docker with Worker Service

도커는 Windows와 Linux 운영체제 모두 지원하는데요. 최종 목표는 리눅스 기반의 시놀로지 도커이지만, 중간 검증을 위해 윈도우용 도커에서 먼저 테스트를 진행하려고 합니다. 그리고 도커에서 서비스를 구동하기 위해서는 Visual Studio에서 제공하는 작업자 서비스(Worker Service) 템플릿을 사용하면 됩니다.

이와 관련된 내용은 아래 링크를 참고하세요.

[ASP.NET] C# Windows Docker 용 작업자 서비스 만드는 방법

3. Synology Docker with Worker Service

윈도우 도커에서 검증이 됐다면, 시놀로지 도커에 이미지를 올리고 컨테이너를 실행하면 끝입니다. 여기서 Putty를 사용하여 시놀로지에 접속하는 과정이 있기 때문에 PuTTY 사용 방법도 숙지하시기 바랍니다.

[Synology NAS] 푸티(PuTTY)로 시놀로지 접속하는 방법

PuTTY 사용법도 익혔다면 리눅스 도커용 작업자 서비스 만드는 방법을 참고하세요.

[ASP.NET] C# 시놀로지 Linux Docker 용 작업자 서비스 만드는 방법

동작 설계

현재 제가 사용하는 레드마인에는 타 부서에서 업무를 요청할 수 있는 '업무 요청' 프로젝트가 따로 있습니다. 타 부서 담당자들은 모두 이곳에서 일감을 생성하여 업무를 요청하게 됩니다. 그리고 처리된 일감은 해당 프로젝트에서 사라지게 됩니다.

이를 기반으로, 제가 생각한 서비스의 동작은 다음과 같습니다.
① 업무 요청 프로젝트에 존재하는 '처리되지 않은 일감'을 조회한다.
② 일감 번호를 기억하여 중복으로 메시지를 전달하지 않도록 한다.
③ 메신저로 일감 웹 사이트 주소와 제목을 메시지로 전송한다.

아주 간단하죠? 이를 기반으로 코드 구현을 해보겠습니다.

서비스 동작

코드 구현

중간중간 확인해야 할 것들이 꽤 많았습니다. 그럼 본격적으로 프로젝트의 목표를 위한 핵심 코드 구현은 어떻게 되는지 살펴보겠습니다.

public class Worker : BackgroundService
{
	//신규 일감 알림 메시지 중복 방지를 위한 객체
	private Dictionary<int, string> _list = new Dictionary<int, string>();
	
    //... 생략...
    
    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            try
            {
            	//1초 마다 지연
                await Task.Delay(1000, stoppingToken);
				//현재 존재하는 일감 조회
                var issues = searchIssues();
                //존재하는 일감이 있다면
                if (issues != null)
                {
                    foreach (var issue in issues)
                    {
                        try
                        {
                        	//일감 번호와 제목을 _list에 추가
                            _list.Add(issue.Id, issue.Subject);
                            //시놀로지 Chat에 메시지 전송
                            notifyChatMessage(issue);
                        }
                        catch (Exception exc)
                        {
                        	//이미 _list에 일감 제목이 존재하면 예외로 처리
                            continue;
                        }
                    }
                }
				//현재 존재하는 일감이 없다면
                else 
                {
                	//모든 신규 일감을 Chat에 메시지를 보냈으므로,
                    //현재 존재하는 목록을 지운다(중복 방지)
                    if (_list.Count != 0)
                    {
                        _list.Clear();
                    }
                }
            }
            catch(Exception exc)
            {
                _logger.LogInformation(exc.Message);
            }
        }
    }
}

코드는 생각보다 아주 간단하고, 주석으로도 충분히 설명이 될 것 같습니다. 중간에 호출하는 searchIssues()는 레드마인 REST API 포스팅을, notifyChatMessage()는 Chat에 챗봇 메시지 보내기 포스팅을 참고하세요.

후기

실제 알림 화면

해당 서비스를 제작한 후 빠르게 업무 요청 일감을 관리하고 있습니다. 이전에는 다른 일을 하느라 바쁘면 메일 확인이 늦어 업무 확인이 늦어졌는데, 현재는 PC 또는 스마트폰으로 알림이 즉시 오니 바쁘더라도 빨리 확인하게 되어 업무 지연이 최소화되었습니다. 역시 불편하면 직접 만들어서 해결하는 것이 정답인 것 같습니다.

[ASP.NET] C# 시놀로지 Linux Docker 용 작업자 서비스 만드는 방법

Mon, 28 Feb 2022 21:49:28 +0900

Linux Docker 작업자 서비스

지난 포스팅에서 ASP.NET Core Worker Service를 빌드하여 Windows 용 Docker에서 서비스를 동작하는 방법을 소개했었습니다. 이번에는 Linux Docker를 위한 작업자 서비스를 제작하려고 하는데요. 저에게 시놀로지(Linux 기반) 서버가 있기 때문에 이번 포스팅에서는 시놀로지 Docker에서 Linux 용 작업자 서비스를 만드는 방법을 소개하겠습니다.

[ASP.NET] C# Windows Docker 용 작업자 서비스 만드는 방법

Windows Docker 작업자 서비스 ASP.NET Core 는 Windows, macOS 및 Linux에서 인터넷 연결 앱을 동작할 수 있는 프레임 워크입니다. 간단히 설명하면 제가 원하는 동작을 수행하는 코드를 빌드하고 그 결과물

luckygg.tistory.com

작업자 서비스 빌드하기

작업자 서비스 프로젝트는 몇 가지를 제외하고 지난번 프로젝트 생성과 동일합니다. 차이나는 부분만 따로 설명하겠습니다. 전체 과정은 위 링크를 참고하세요.

프로젝트 생성 시 Docker OS를 Linux로 선택합니다.

대상 프레임워크 및 Docker OS 선택

그리고 Dockerfile 내용을 다음과 같이 수정합니다.

FROM mcr.microsoft.com/dotnet/runtime:5.0 AS base
 
COPY . /app
WORKDIR /app

#포트 번호는 예시로 8888
ENV ASPNETCORE_URLS http://*:8888
EXPOSE 8888

#ExamWorkerService는 프로젝트 이름
ENTRYPOINT ["dotnet", "ExamWorkerService.dll"]

이대로 게시한 후 빌드 관련 파일이 생성된 폴더에 Dockerfile을 복사하여 붙여 넣습니다.

게시 폴더에 Dockerfile 복사하기

시놀로지 Docker에 작업자 서비스 설치하기

Linux 기반인 시놀로지 Docker에 작업자 서비스를 설치해 보겠습니다.

시놀로지 DSM에 접속하고 파일 스테이션(File Station)을 실행합니다.

File Station 실행

그리고 docker 폴더에 하위 폴더를 생성하고 이전 과정에서 빌드한 파일을 모두 복사합니다.

예제 프로젝트 이름과 사진의 폴더 이름이 다르긴 하지만 상관없습니다.

게시한 파일 복사하기

파일을 다 옮겼으면 PuTTY를 실행하여 파일의 경로로 이동합니다. PuTTY로 시놀로지 접속 방법을 모른다면 아래 링크를 참고하세요.

[Synology NAS] 푸티(PuTTY)로 시놀로지 접속하는 방법

Synology NAS와 PuTTY 사용 시놀로지 나스를 평범하게 사용한다면 푸티(PuTTY) 사용 방법을 몰라도 됩니다. 하지만 저처럼 레드마인을 사용한다든가, DSM Root 권한으로 접근하여 뭔가를 수행한다면 PuTTY

luckygg.tistory.com

저의 경우 도커를 볼륨 1에 설치했고 notifyredmine 이름의 폴더에 파일을 복사했습니다. 해당 경로로 이동하는 명령어는 다음과 같습니다.

cd /volume1/docker/notifyredmine

이제 다음의 명령어를 입력하여 빌드를 시작합니다. 마지막의 notifyredmine은 서비스 이름이므로, 짓고 싶은 대로 지어도 상관없습니다.

docker build -t notifyredmine .

명령어 실행 후 정상적으로 빌드가 되면 아래와 같은 모습이 보여집니다.

정상적으로 빌드된 모습

이제 시놀로지 DSM에서 Docker를 실행하고 이미지 메뉴를 선택하면 방금 빌드한 이미지가 보이게 됩니다.

도커 이미지 목록

이미지 선택 후 상단의 실행 버튼을 클릭하면 아래의 화면이 표시됩니다. 컨테이너 이름을 입력하고 다음 버튼을 클릭합니다.

컨테이너 생성 화면1

아래의 화면이 표시되면 적용 버튼을 클릭하여 컨테이너를 생성합니다.

컨테이너 생성 화면2

좌측 메뉴 중 컨테이너를 선택하면 컨테이너 목록이 보입니다. 방금 생성한 컨테이너가 정상적으로 실행 중인지 확인할 수 있습니다.

컨테이너 목록 화면

정리

이번에도 잘 따라 하셨나요? 이번 작업은 지난 포스팅인 Windows Docker 작업자 서비스를 만드는 것과 큰 차이가 없었습니다. 하지만 작업자 서비스를 잘못 빌드하면 컨테이너가 계속해서 죽는 경험을 겪게 될 건데요. 본문 내용을 잘 따라 하신다면 큰 삽질 없이 원하는 작업을 실행할 수 있을 것입니다.

[Synology NAS] 푸티(PuTTY)로 시놀로지 접속하는 방법

Wed, 23 Feb 2022 21:15:16 +0900

Synology NAS와 PuTTY 사용

시놀로지 나스를 평범하게 사용한다면 푸티(PuTTY) 사용 방법을 몰라도 됩니다. 하지만 저처럼 레드마인을 사용한다든가, DSM Root 권한으로 접근하여 뭔가를 수행한다면 PuTTY 사용은 필수입니다. 이번 포스팅을 통해 PuTTY로 시놀로지 나스에 어떻게 접근하는지 사용 방법을 소개합니다.

SSH 활성화하기

PuTTY로 시놀로지에 접근하기 위해서는 SSH 포트를 활성화해야 합니다. 시놀로지 DSM에 접속한 후 제어판의 터미널 및 SNMP 설정에서 SSH 포트를 활성화할 수 있습니다.

SSH 서비스 활성화하기

PuTTY로 접근하기

먼저 PuTTY부터 다운로드합니다. 아래 PuTTY 공식 홈페이지에 접속하여 설치형 또는 실행형 파일을 OS 버전에 맞게 준비합니다.

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

Download PuTTY: latest release (0.76)

This page contains download links for the latest released version of PuTTY. Currently this is 0.76, released on 2021-07-17. When new releases come out, this page will update to contain the latest, so this is a good page to bookmark or link to. Alternativel

www.chiark.greenend.org.uk

PuTTY를 실행하면 다음과 같이 화면이 표시됩니다.

PuTTY 실행 화면

항목	설명
Host Name(or IP address)	사이트 주소 또는 IP 주소를 입력합니다.
Port	포트 번호를 입력합니다.
Connection type	연결 타입을 선택합니다. 본문에서는 SSH를 선택합니다.

Host Name과 Port를 입력한 뒤 Open 버튼을 클릭하면 다음과 같이 로그인 정보가 표시됩니다. 만약, 아래와 같은 화면이 표시되지 않고 경고창이나 반응이 없다면 주소 또는 포트 번호를 다시 확인해야 합니다.

시놀로지 로그인 정보 입력 화면

만약, 내부에서는 접속이 잘 되는데 외부 인터넷에서 접속이 안된다면 공유기의 포트포워드 설정을 확인해야 합니다.

공유기의 SSH 포트 포트포워드 설정 예시

처음 콘솔 창에 login as: 문구가 표시되면 관리자 아이디를 입력하고 Enter 키를 누릅니다. 그리고 비밀번호를 입력한 다음 root 권한을 얻기 위해 아래의 명령어를 입력합니다.

sudo --login

이후 다시 한번 비밀번호를 입력한 후 root@...로 표시되면 정상적으로 root 권한을 얻은 것입니다.

root 권한을 얻기 위한 과정

이후 도커 컨테이너라든가 레드마인 관련하여 설치, 삭제 등이 가능해집니다.

[ASP.NET] C# Windows Docker 용 작업자 서비스 만드는 방법

Tue, 15 Feb 2022 18:03:01 +0900

Windows Docker 작업자 서비스

ASP.NET Core는 Windows, macOS 및 Linux에서 인터넷 연결 앱을 동작할 수 있는 프레임 워크입니다. 간단히 설명하면 제가 원하는 동작을 수행하는 코드를 빌드하고 그 결과물을 ASP.NET Core를 통해 서비스를 동작할 수 있다는 것입니다.

게다가 Visual Studio에서 제작 가능한 ASP.NET Core Worker Service(작업자 서비스) 템플릿은 장기간 실행되는 서비스 앱을 개발하기 위해 제공됩니다. 즉, 서버에서 멈추지 않고 계속해서 돌릴 서비스를 제작하기 위한 프로젝트라는 것이죠.

이번 포스팅에서는 작업자 서비스를 빌드하고 Windows Docker에서 동작시키는 과정을 설명하겠습니다.

Windows Docker 준비하기

우선 Windows Docker를 먼저 설치합니다. Windows 10에 Docker를 설치하는 방법은 아래 링크를 참고합니다. 현재 홈페이지에서 제공되는 버전과 포스팅에 기재된 버전과 차이는 있지만, 최신 버전으로 동일하게 따라 해도 문제가 없습니다.

[Docker] Windows 10 Docker Desktop 설치 방법

제 블로그에는 레드마인에 관한 내용이 많이 기재되어 있습니다. Windows Redmine 과 Synology NAS Docker Redmine 두 가지로 되어있는데요. 이번에 소개할 내용은 Windows 용 Docker Redmine 설치 방법입니다...

luckygg.tistory.com

작업자 서비스 빌드하기

Visual Studio 2019에서 작업자 서비스 프로젝트를 빌드하고 결과를 확인하는 방법을 설명합니다.

Visual Studio에서 작업자 서비스 템플릿을 선택하고 ExamWorkerService 이름으로 프로젝트를 생성합니다.

작업자 서비스 템플릿 선택

대상 프레임워크는 .NET 5.0을 선택하고 Docker 사용 체크 및 Windows를 선택합니다.

대상 프레임워크 및 Docker OS 선택

프로젝트를 생성하면 다음과 같은 기본 코드가 구현되어 있습니다. 1초마다 Worker running at: 시간 메시지가 출력되는 동작입니다.

기본으로 제공되는 코드

솔루션 탐색기에서 Dockerfile을 선택하면, 기본으로 아래의 내용이 작성되어 있는 것을 확인할 수 있습니다. 추후 이 Dockerfile을 상위 경로로 복사할 겁니다.

Dockerfile 기본 내용

이제 프로젝트 파일의 마우스 우측 메뉴에서 게시 메뉴를 클릭합니다.

프로젝트 파일의 게시 메뉴 클릭

게시 메뉴에서 폴더를 선택하고 다음 버튼을 클릭합니다.

게시 메뉴의 폴더 선택

폴더 위치는 변경해도 상관없습니다. 게시할 파일이 생성되는 위치를 지정하는 옵션입니다. 폴더 위치 지정 후 마침 버튼을 클릭합니다.

폴더 위치 지정하기

게시 옵션 지정이 완료됐습니다. 상단의 게시 버튼을 클릭하면 지정한 폴더에 빌드된 파일이 생성됩니다.

프로젝트 게시하기

지정된 폴더에 가보면 생성된 파일이 여럿 있습니다. 그리고 ExamWorkerService.exe를 찾을 수 있는데요.

빌드된 파일들

파일을 실행해 보면 아래와 같이 1초마다 현재 시간을 계속해서 출력합니다. 처음 프로젝트를 생성했을 때 구현되어 있던 예제 코드가 동작하는 것이죠.

작업자 서비스 동작 화면

이제 이 서비스를 Windows Docker에서 돌려보겠습니다.

Windows Docker에 작업자 서비스 설치하기

이제 Windows Docker에 작업자 서비스를 설치하고 실행해 보겠습니다.

우선 프로젝트 상위 경로로 이동하여 앞에서 확인했던 Dockerfile을 복사합니다.

프로젝트 상위 경로에 Dockerfile 복사하여 붙여넣기

명령 프롬프트를 실행하고 위 경로로 이동합니다. 저는 바탕화면에 프로젝트가 있으므로, 명령어는 다음과 같습니다.

cd C:\Users\Gg\Desktop\ExamWorkerService

그리고 Docker 빌드를 위한 명령어는 다음과 같습니다. 마지막의 myservice는 서비스 이름이므로, 짓고 싶은 대로 지어도 상관없습니다.

docekr build . -t myservice

위 명령어를 실행하면 도커에 서비스 설치가 시작됩니다. 아래와 같은 메시지가 표시됐다면 정상적으로 설치가 완료된 것입니다.

도커 서비스가 정상적으로 설치된 모습

Windows Docker를 실행하면 Images에 myservice가 보이기 시작합니다.

Docker 이미지 목록

myservice 항목을 클릭하면 우측에 RUN 버튼이 표시됩니다. 버튼을 클릭하면 옵션 설정 창이 표시되는데요. 여기서도 별도 지정 없이 Run 버튼을 클릭합니다.

myservice 동작하기

아래 화면은 컨테이너 목록을 보여줍니다. 방금 실행된 컨테이너 이름을 클릭합니다.

실행 중인 컨테이너 목록

앞에 과정에서 봤던 1초 간격 로그 출력 메시지가 보입니다. 정상적으로 도커에서 서비스로 동작한다는 것을 의미합니다.

도커에서의 동작 확인

정리

따라 해 보니 아주 간단하죠? 저는 시놀로지 서버의 Docker에서 서비스를 구동하기 전에 테스트를 위해 Windows Docker에서 이렇게 확인하고 있습니다. Windows는 컴퓨터를 끄면 Docker가 종료되므로 서비스가 멈춰버리니 테스트 및 디버그 용으로 사용하고, 시놀로지 서버는 계속 동작하므로 릴리즈 용으로 사용하는 것이죠.

[챗봇/.NET] C#에서 시놀로지 Chat에 챗봇 메시지 보내기(예제 포함)

Sun, 13 Feb 2022 11:03:09 +0900

시놀로지 Chat 메신저

시놀로지에는 Chat이라는 메신저를 제공하고 있습니다. 이는 패키지 센터에서 설치가 가능한데요. 주요 특징은 다음과 같습니다.

무료로 사용 가능
메시지 고정(공지 사항), 북마크, 해시태그, 사용자 멘션, 검색 기능
설문조사, 전달, 알림, 메시지 예약, 파일 전송 기능
공개, 비공개 대화방
파일 전송
윈도우, 모바일 앱 지원
스마트 폰에서 파일 공유 가능
지난 대화 기록 저장

즉, 카카오톡과 같은 메신저라고 보면 되겠습니다. 물론, 모두가 Chat을 사용하지는 않겠죠. 그래서 저의 경우에는 사내 메신저(업무용)로 활용하고 있습니다.

시놀로지 챗 PC 화면

시놀로지 Chat Webhook 기능

시놀로지 챗은 수신, 발신 Webhook이라는 기능을 제공하고 있습니다.

수신 Webhook

수신 Webhook은 외부에서 Chat으로 메시지를 보낼 수 있습니다. 즉, 외부 인터넷에서 시놀로지 Chat으로 메시지를 보낼 수 있다는 의미죠. 메시지에는 텍스트와 링크 그리고 파일 업로드도 가능합니다. 파일 업로드의 경우 최대 크기는 32MB입니다.

수신 Webhook 설정 화면

발신 Webhook

발신 Webhook은 Chat 메시지를 트리거 단어로 수신 대기합니다. 즉, 챗에 특정 단어를 입력하면 트리거 신호로 인식하여 관련 데이터를 외부 URL로 보내는 것입니다.

발신 Webhook 설정 화면

좀 더 자세한 사용 명세는 아래 링크를 참고하세요.

https://kb.synology.com/ko-kr/DSM/help/Chat/chat_integration?version=6

Synology Chat에서 통합 사용 | Synology Chat - Synology 지식 센터

kb.synology.com

Webhook 설정 방법

챗 실행 화면에서 우측 상단의 프로필 사진을 클릭합니다.

프로필 클릭

그리고 통합 메뉴를 클릭합니다.

통합 메뉴 클릭

아래의 메뉴에서 들어오는 Webhooks를 선택합니다. 본문에서는 나가는 Webhooks으로 테스트할 조건이 안되기 때문에 들어오는 Webhooks만 다룹니다.

들어오는 Webhooks 메뉴 클릭

들어오는 Webhooks 화면에서 생성 버튼을 클릭합니다.

생성 버튼 클릭

프로필 사진, 이름, 채널을 선택하고 Webhook URL을 복사해 둡니다.

수신 Webhook 설정 예시 화면

C#에서 수신 Webhook으로 메시지 보내기

ExamChatWebhook 이름으로 Windows Forms 앱 프로젝트를 생성합니다.

Windows Forms 프로젝트 생성

UI에 버튼을 하나 배치하고 코드는 다음과 같이 작성합니다.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using System.Net;
using System.IO;

namespace ExamChatWebhook
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void buttonSendMessage_Click(object sender, EventArgs e)
        {
            //수신 Webhook url
            string webhookUrl = "";
            string payload = "&payload={\"text\": \"LuckyGg의 메시지, https://luckygg.tistory.com\"}";

            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(webhookUrl + payload);
            request.Method = "GET";
            using (var response = request.GetResponse())
            {
                using (Stream dataStream = response.GetResponseStream())
                {
                    using (var reader = new StreamReader(dataStream))
                    {
                        string requestResult = reader.ReadToEnd();
                    }
                }
            }
        }
    }
}

코드가 너무 간단하죠? 코드를 실행하면 챗으로 메시지가 바로 전송됩니다.

챗으로 수신된 메시지

코드의 자세한 사용 방법은 아래 첨부된 코드를 참고하세요.

ExamChatWebhook.zip

0.01MB