morenice's blog

Docker Desktop Malware Blocked - com.docker.vmnetd

morenice — Fri, 7 Feb 2025 23:14:11 +0900

출처: https://github.com/docker/for-mac/issues/7520

예전부터 Docker desktop을 사용해왔는데, 오랫만에 이미지 빌드 및 테스트할게 있어 터미널을 열어 "docker" 명령어를 실행하니 아예 동작을 하지 않았다. 라이브러리 의존성 문제가 있나 싶어 맥OS를 최신 버전(Sequoia 15.0 -> 15.2)으로 업그레이드 하였고, Docker Desktop 또한 최신 버전을 다운로드 받아서 재설치를 시도하였다.

하지만 설치 후 사진과 같이 Malware Blocked(com.docker.vmnetd) 메시지와 더불어 실행이 되지 않았다. 문제 원인을 가정해보기로는 (1) Docker에 malware가 포함되었다, 또는 (2) 맥OS의 malware 감지 시스템이 신규로 추가되거나 있었더라도 예민하게 동작할 가능성이 있다 정도로 생각되었다.

혹시 몰라 구글링을 좀 해봤는데 다행히 2025년 1월에 docker for-mac 레파지토리쪽에 이슈가 등록된 사항을 확인하였다.

https://github.com/docker/for-mac/issues/7520

[Workaround in description] Mac is detecting Docker as a malware and keeping it from starting · Issue #7520 · docker/for-mac

Description Whenever Docker is started, this error is shown: Malware Blocked. “com.docker.socket” was not opened because it contains malware. this action did not harm your Mac. Reproduce Start Dock...

github.com

아직 공식적으로 수정되진 않았지만, 임시 해결 방법이 공유되어 있어 이를 따라해보았다. 내용을 살펴보면 설치된 vmnetd 관련 설정들을 삭제하고 수동 설치 또는 vmnetd 주요 파일들을 복사해주는 명령어들이다.

# Quit Docker Desktop and check that no remaining docker processes are running using the Activity Monitor
#Run the following commands:

# Stop the docker services
echo "Stopping Docker..."
sudo pkill '[dD]ocker'

# Stop the vmnetd service
echo "Stopping com.docker.vmnetd service..."
sudo launchctl bootout system /Library/LaunchDaemons/com.docker.vmnetd.plist

# Stop the socket service
echo "Stopping com.docker.socket service..."
sudo launchctl bootout system /Library/LaunchDaemons/com.docker.socket.plist

# Remove vmnetd binary
echo "Removing com.docker.vmnetd binary..."
sudo rm -f /Library/PrivilegedHelperTools/com.docker.vmnetd

# Remove socket binary
echo "Removing com.docker.socket binary..."
sudo rm -f /Library/PrivilegedHelperTools/com.docker.socket

# Install new binaries
echo "Install new binaries..."
sudo cp /Applications/Docker.app/Contents/Library/LaunchServices/com.docker.vmnetd /Library/PrivilegedHelperTools/
sudo cp /Applications/Docker.app/Contents/MacOS/com.docker.socket /Library/PrivilegedHelperTools/

OS 업그레이드부터 Docker 재설치까지 그리고 이래저래 삽질하는 시간이 꽤 걸렸지만, 위 방법으로 간단히 해결할 수 있었다.

비슷한 문제가 발생하면, 위 링크를 참고하여 임시조치를 적용하는 것을 추천한다.

N잡러를 위한 전자책 만들기

morenice — Mon, 30 Dec 2024 01:17:53 +0900

흑상어쌤 지음

약 10여 년 전부터 갖고 있던 컨퍼런스 발표, 원격 근무 등 여러가지 목표 중 하나는 전자책 만들기였다. 소프트웨어 개발과 관련된 막연한 글을 쓰고 싶었고 고민만 몇 번 하다가 진행이 멈춘 프로젝트 중 하나이다. 글을 어떻게 하면 잘 적을 수 있을까? 내가 적은 글들이 정말 도움은 될까? 같은 고민들이 있었는데 이는 책을 기획하고 집필하는 과정 중 하나이고 그 뒤로 판매 및 마케팅 디자인등 여러 가지로 고민거리가 필요하다는 걸 깨닫게 되었다.

N잡러를 위한 전자책 만들기는 저자 흑상어쌤이 전자책 작성에 대한 노하우가 집적된 일종의 프레임워크라고 할 수 있다. 전자책이란 무엇인지 그리고 기획단계에서 어떤 고민들이 필요한지를 하나하나 서술하고 있다.

전자책의 목적은 독자의 문제, 고민, 욕망을 해결해 주기 위한 것입니다. 그러므로 독자가 누구인지, 어떤 문제를 해결하고 싶어 하는지를 관찰해야 합니다.

전자책은 독자를 대상으로 하며, 자신의 작품이 얼마나 수준 높은지를 판단하기 위해 제작하는 것이 아님을 기억해야 합니다. 부족해 보일지라도 일단 시장에 작품을 내놓고 독자들의 평가를 토대로 개선해 나가는 것이 중요합니다. 아무리 오랜 시간 고민을 해도 독자들은 작가가 얼마나 노력하고 준비를 했는지 알 수 없고, 관심도 없습니다. 독자들은 자신들의 문제를 해결하는데 관심이 있지요.

다소 추상적인 부분에 대해서도 구체적으로 설명하고 여러 지침들을 주는게 이 책의 장점이다. 예를 들어 "Part 01 전자책 이해하고 기획하기"에서 아는 것과 모르는 것에 대한 이야기가 나온다.

아는 것: 직접할 수 있고 다른 사람에게 설명하거나 가르칠 수 있는 것
모르는 것: 읽거나 보기만 한것. 안다고 생각하는 것. 실제로 해본 적 없거나 다른 사람을 가르치거나 설명할 수 없는 것

또한 실제로 자신이 아는 것과 필요한 사람을 정리해보세요와 같이 액션 메시지로 이어지는데 "내가 경험해 본 것과 할 수 있는 것은 무엇인가?" 그리고 "그것이 누구에게 어떤 도움이 될 수 있는가"등 질문으로 생각을 구체화할 수 있게 도와준다.

이 처럼 내용 중간중간에 나오는 흑상어쌤의 액션 메시지는 이 책의 큰 장점이다.

책에서 언급하듯이 크몽 플랫폼에 들어가서 전자책들을 훑어보았다. 많은 사람들이 전자책을 만들고 있고, 무엇보다도 독자 관점의 작은 문제를 해결하는데 초점이 맞춰져 있다는 것도 확인할 수 있었다.

또한 베껴쓰고 바꿔쓰며 연습하고 최종적으로 자신 스타일로 새로운 글을 써보는 연습법인 '베바새 글쓰기' 또한 인상적이다.

글쓰는 방법부터 다소 어렵게 느껴지는 디자인 그리고 마케팅 관련 내용들이 있기 때문에 용기를 갖고 책 집필을 시작한다면 퀄리티 있는 전자책이 나오지 않을까 싶다. 잊고 있었던 책 집필에 대해 용기를 주었고 실용적이면서 충분한 가이드를 줄 수 있는 책이라고 생각한다.

"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

실무로 통하는 클린 코드

morenice — Mon, 26 Aug 2024 14:19:09 +0900

막시밀리아노 콘티에리 지음, 이태영 옮김

어떤 기술을 학습해 가는 방법은 여러 가지가 있다. 최근 가장 관심 있는 방법 중 하나로써 기본적인 개념을 익힌 뒤 실용적인 관점에서의 예시들을 포함, 어떻게 활용하는지 익혀나가고 점진적으로 왜 이렇게 했는지 등 사고의 폭을 넓혀가는 방법이 와닿는다. 그런 관점에서 한빛미디어에 나온 "실무로 통하는..." 시리즈의 책들은 인과추론, 타입스크립트, 엑셀, 데이터 시각화등 책이 나와있는데 "실무로 통하는 클린코드" 또한 이러한 시리즈 책 중 하나이다.

클린코드는 읽고, 이해하고, 유지보수하기 쉬운 코드를 의미합니다. 이를 위해 잘 구조화되고 간결하며 변수, 함수, 클래스에 의미 있는 이름을 사용합니다. 또한 모범 사례와 디자인 패턴을 따르며 성능과 구현 세부 사항보다 코드의 가독성과 동작을 우선시합니다.

p31 왜 클린 코드인가요?

클린 코드란 읽고, 이해하고, 유지보수하기 쉬운 코드를 위한 모든 활동들을 의미한다. BigData와 같이 여러가지 의미를 함축하는 용어로써 "클린 코드"란 말은 로버트 C 마틴에 의해 널리 알려졌다. 클린 코드 책이 나온 지 꽤 오래되었지만 여전히 개발자들의 바이블이다. 하지만 Java 언어를 바탕으로 예시들이 설명되고 있어 요즘과 같이 다양한 언어를 다루는 사람들에게는 예시에 대한 갈증이 있었을 것이다.

이러한 관점에서 실무로 통하는 클린 코드(Clean code Coookbook)는 꽤 유용한 책이다. Java뿐 아니라 Javascript, Python, PHP를 사용한 예시들이 제공되고 있고 짧은 예시들이 가득가득하여 읽어나가는데 부담이 없다. 사실 예시가 너무 많아서 머릿속으로 기억하는 게 어려울 지경이다.

지은이 막시밀리아노 콘티에리는 약 25년동안 소프트웨어 업계에 종사하였는데 그 중 14년째는 대학 강의를 하고 있는 사람이다. 이름이 익숙하지 않은 발음이라 어느 국가 사람일까 궁금했는데 아르헨티나 국적을 가진 사람이었고 링크드인 프로필을 보면 책과 관련된 언급을 찾아볼 수 있다. 대략 1년이 안된 책이 한국어로 번역까지 되어 출판된 것을 보면 얼마나 따끈따끈한 책인지를 알 수 있다.

저자의 링크드인 글 일부를 발췌

Chapter 1,2에서 클린코드에 대한 설명 그리고 공리(수학에서 가장 근본이 되는 기초 명제)를 시작으로, Chapter 3부터 다양한 예시들을 설명해 나가는데 "문제", "해결", "설명" 순으로 진행이 된다. 문자열 남용 제거하기처럼 선언적으로 변환하는 간단한 예시들부터 시작하여 디자인 패턴에 대한 인용 그리고 놓치기 쉬운 과도한 일반화에 대한 내용을 첨부한다.

4.4 문자열 남용 제거하기

(노트) 퍼사드 패턴

과도한 일반화 줄이기

이 책을 관통하는 하나의 단어가 있다면 MAPPER(Model: Abstract Partial and Programmable Explaining Realiity) 일 것이다. 저자가 말하는 MAPPER에 대해서는 매우 동의한다. 프로그래밍을 처음 배울 때 추상화 그리고 모델링에 대한 부분을 배우게 되는데 실제 내용이 와닿지 않다가 경험이 쌓일 수록 이러한 개념이 와닿는 순간들이 점차 많아지게 된다. 시점을 생각해보면 유지보수를 하게 됨에 따라 기존 코드를 변경하고 문제 없이 동작하게 해내가는 과정들을 겪으면서가 아닐까 싶다. 버그가 나와서 고쳤는데 다른 버그가 나타난다던가, 기능 요구사항이 있어 수정을 하려는데 강결합된 코드들로 인하여 거의 다 뜯어고쳐나가는 일들 그리고 배포시 겪는 장애들의 연속등 실제로 주변에서 많이들 겪고 보게 되는 일들이다.

나에게 클린 코드란 관리/담당하는 코드들이 내 손을 떠나서도 정해진 요구사항과 목표에 맞게 잘 동작시키는 기본 바탕을 의미한다. 좀 더 말하자면 유닛테스트 및 회귀테스트 그리고 적정 수준의 설계 문서들이 함께 있어야 하겠지만 말이다. 개인적으로는 "Chapter 4 기본형 집착", "Chapter 16 섣부른 최적화", "Chatper 17 결합도", "Chatper 19장 계층"을 재미있게 읽었다.

하루 한 Chapter 이렇게 읽으면 딱 좋을듯 한데 부담이 된다면 하루에 2,3페이지씩 정해서 읽어도 좋다. 첫번째 읽을 때에는 이해하기 위해 그리고 두 번째 읽을 때 비판적 사고로 읽어보면 본인의 코딩 스타일에 충분히 도움이 되지 않을까 생각한다. 팀 또는 함께하는 사람들이 있다면 같이 읽어도 좋다고 생각한다.

개발자란 코드를 가지고 글을 쓰는 사람이다. 글을 잘쓰기 위한 전략이나 학습이 필요하다. 물론 글을 많이 써야겠지만 변해가는 요구사항에 맞춰 고객에게 빠르고 안전하게 서비스를 제공하기 위한 유지보수 관점에서의 글쓰기가 필요하다. 클린 코드는 이러한 관점을 위한 전략이고 유지보수는 거의 모든 대부분 개발자들이 하는 일이다.

"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

처음 시작하는 FastAPI

morenice — Sun, 28 Jul 2024 00:21:17 +0900

빌 루바노빅 지음

최근에는 프로덕션 레벨로 Java을 활용하여 작업을 이어오면서 개인프로젝트 몇몇을 제외하고는 Python 기반의 웹 서비스 개발을 거의 못하고 있었다. 종종 FastAPI에 대한 이야기를 듣곤 했었다. 작년말 해커톤에 참여할 일이 있었는데 그 때 함께 작업하시는 분이 FastAPI 이야기를 하셔서 1시간 정도 레퍼런스 문서를 보고 백엔드 API 서버를 만들기는 했었는데 이번에 이렇게 관련 서적을 읽을 기회가 있어서 한번 각을 잡고 읽어보게 되었다.

Python을 개발언어의 강력함은 배우기 쉽고 이를 지탱하는 프레임워크가 굉장히 많다는 점이다. 그 중 웹 프레임워크는 과거부터 2가지 종류가 굉장히 인기가 많았다. 일종의 거대한 프레임워크라고 할 수 있는 Django와 대조적으로 경량화된 Flask이다. 어드민부터 시작하여 CLI 도구등 (Ruby on rails의 영향을 받은듯한) 다양한 기능들을 직접적으로 지원하여 간단한 웹 어플리케이션은 굉장히 빠르게 개발할 수 있는 Django는 그 유명한 인스타그램에서 초기에 활용한 프레임워크이기도 하다.

지금도 그렇지만 개인적으로 웹사이트를 만들 일이 있다면 거리낌없이 Django를 활용했었고, 마이크로서비스가 주류가 된 이후로는 자유도가 높고 경량화된 백엔드API 서버를 만들 수 있는 Flask를 활용하여 백엔드 API 서버를 개발하였다. 한가지 아쉬웠던 점은 Python의 GIL(Global Interpeter Lock) 때문에 멀티 프로세스보다 경량화된 멀티 쓰레딩을 활용하기 어렵다는 점이고 일반적으로 I/O가 많은 백엔드서버에서 비동기를 지원하지 않아 성능적으로 이점을 많이 가져가지 못한 점이 있었다.

이 때 필요한 기술은 비동기이다. Django와 Flask 모두 결국 비동기를 지원하게 되었지만 결국 FastAPI가 비동기 API 서버의 흐름을 잡고 있지 않을까 생각을 한다. Flask와 비슷한 간결함과 자유도 그리고 비동기 지원. 자동화된 문서화와 ORM까지 어느정도 갖춰서 사용할 수 있는 레퍼런스가 제공되는 점까지 프로덕션 레벨에서 사용하지 않을 이유가 없다.

실용적인 목적으로 빠르게 활용하기 위해서만 학습했었는데 내부 동작이나 기능의 지원여부 그리고 Django, Flask와의 차이점에 대해 정리된 글을 보고 싶다는 생각을 했었는데 이 책에서는 궁금한 점들을 잘 표현하고 있다. 주니어 개발자들을 위한 서비스, API, HTTP, Restful, 동시성등 개념적인 설명과 더불어 어느정도 웹개발에 대한 경험이 있는 독자들을 대상으로 글을 쓴 것 같은 인상또한 받았다.

책의 장점이자 단점인데, "단순히 API 서버는 이렇게 만들면 됩니다"가 아니라 API 서버를 개발하는데 필요한 개념들부터, 테스트를 위한 도구(pytest), 코드 포맷팅, ORM, 의존성 주입, 로깅, 인증/인가등 다양한 범위로 설명을 한다. Cython, pypy등의 언급까지 정말 많은 영역을 다루다 보니 특정 부분은 설명이 적거나 개론적인 부분만 적혀있는 것도 있어 단점이라고도 볼 수 있다. 하지만 API에 대한 큰 틀을 한번 정리해준다는 점은 장점으로 생각된다.

데이터 계층에 대한 설명은 로우레벨인 쿼리부터 시작한다는 점은 인상적이지만 최근 ORM을 거의 다 사용하는 추세인데 너무 적게 내용을 할당해 아쉬움이 좀 있었다.

Python을 시작해서 FastAPI로 처음 개발을 시작한다면 추천하기 좀 어렵다. 하나하나 집어주는 부분은 참 좋았지만 기술적 단어나 배경에 대한 이해가 부족할 수 있어 맥락을 이해하기 어려울 것으로 본다. 하지만 Django/Flask 개발 경험이 있는 사람이 FastAPI를 도입하거나 사용하기 위해 이 책을 읽어본다면 빠르게 어느정도 퀄리티가 보장된 서버를 만들 수 있는 가이드가 될 것이라고 생각한다.

"한빛미디어 <나는리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

한 권으로 끝내는 이미지 생성 AI with 미드저니

morenice — Sat, 23 Mar 2024 18:18:15 +0900

헤더림(임혜린) , 백승호  (지은이)

10년 전만 하더라도 AI 기술을 활용하는 사람들은 기계학습, 딥러닝을 포함하여 알고리즘과 수학적 지식을 필요로 했다. 이미지(또는 데이터)에서 사물을 식별하거나 이상패턴을 판별하는 등 특정 분야에서만 활용하고 있었고 전문적인 지식뿐 아니라 다양한 경험이 뒷받침되어야 사용할 수 있는 수준이었다. 학습 모델을 어떤 데이터로 만들것인지 그리고 최종 결과가 잘 동작하는지등 가늠하는 것도 어려운 주제이고 전문적인 최신 트렌드를 계속해서 학습해야하는 고충이 있다. 하지만 생성형 AI가 태동하기 시작하면서 분위기가 바뀌었다. 생성형 AI(generative AI)는 프롬프트에 대응하여 텍스트, 이미지, 기타 미디어를 생성할 수 있는 일종의 인공지능(AI) 시스템을 말한다.

즉, 프롬프트만 잘 만들수 있다면 전문적인 AI 지식을 알지 못해도 필요한 정보를 얻거나 이미지를 만들어낼 수 있다. 최근에는 이미지뿐 아니라 영상까지 만들어내는 수준까지 이끌었다. 그렇다보니 과거 전문분야 또는 특정분야에서만 활용할 수 있었던 AI를 일반인이 일상에서 손쉽게 사용할 수 있는 수준으로 만들어주었다. 문학, 시, 이미지, 영상 등의 분야를 소비하는 것뿐만 아니라 AI를 통해 생산자가 될 수 있는 것이다.

AI의 대중화라 부를 수 있는 생성형 AI를 어떻게 시작하면 좋을지 그리고 어떻게 프롬프트를 작성해야 원하는 수준의 결과물을 얻을 수 있는지 2가지 관점에서 지식과 경험이 필요하다. 한 권으로 끝내는 이미지 생성 AI는 2가지 관점을 만족시켜주는 책으로써 생성형 AI에 관심이 있는 일반인이나 직장인, 디자이너, 아티스트, 기획자를 위한 실용적인 예시를 보여주어 실제로 삶에 AI를 활용할 수 있게 도와주는 책이다.

책 초반부분에 텍스트를 기반으로 이미지가 어떻게 제공되는지 간략하게 소개가 나온다. 위 사진은 화성에서 테니스를 치고 있는 사자를 만들어달라고 한 결과물이다.

화성에 있는 사자 이미지 생성 예시

대표적인 서비스들이 소개되며 달리, 미드저니의 가입방법 그리고 스테이블 디퓨전 설치 방법에 대해서도 서술한다. 책에서는 주로 미드저니를 통해 이미지를 생성하는 방법과 예시들이 작성되어 있다.

대표 생성형 서비스 Dall-E,  Midjourney, Stable Diffussion

목차 중 PART02 이미지 생성 AI 실무 활용하기에서 "일상에서 이미지 생성 AI 활용하기", "회사 업무에 이미지 생성 AI 활용하기", "디자인 실무에 이미지 생성 AI로 어이디어 얻기"를 주제로 각각 3~4개의 이미지 생성 예시들을 확인할 수 있다.

AI를 통해  필요한 두 장의 이미지를 생성하고 포스터를 만든 사례

특정 작가나 아티스트 느낌을 반영한 이미지 또한 만들어낼 수 있다

포스터 만들기

페르소나 인물 예시

책을 읽어나가면 굉장히 쉽다!라고 느낄 수 있고 읽는데 1~2시간이면 충분하다. 쉽게 느끼는 이유는 저자가 알고 있는 그리고 경험한 지식들이 잘 녹여져 있기 때문이라고 생각한다. 막상 만들고 싶은 이미지에 대한 프롬프트를 작성해보려고 하면 생각보다 어떤 키워드를 프롬프트에 포함시켜야 할지 생각이 잘 안난다. 그럴 때 마다 책에 작성된 내용을 다시 확인하여 프롬프트를 작성하는등 꾸준히 연습하는게 필요해 보였다.

최근 AI 시장은 매년마다 빠르게 변화하고 있지만 나중에 한 번에 이해하기보다는 일상에 적용할 수 있는 부분들을 확인하고 꾸준히 관찰하는 게 더 중요하다고 생각한다. 작년말 회사에서 AI 해커톤을 진행하여 참석하였고 그 이후로 ChatGPT를 종종 활용하고 있는데 올해는 다양한 이미지 생성을 해보고 삶에 반영해볼 계획이다.

"한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

You Don't Know JS Yet - 자바스크립트 개념, 스코프와 클로저

morenice — Sun, 25 Feb 2024 00:28:24 +0900

최근 함께 일하는 동료와 가볍게 JavaScript 주제로 이야기를 했었다. 기억나는 내용 중 하나는 JavaScript 개발자 면접관으로써 생각보다 숙력자를 찾기 어렵다는 것이다. JavaScript는 과거 웹 브라우저에서 동작시키기 위한 스크립트 언어였지만 이제는 서버뿐 아니라 앱 또는 GUI 개발까지 다양하게 활용되고 있다.

https://innovationgraph.github.com/global-metrics/programming-languages#programming-languages-rankings

github 플랫폼에 가장 많이 등록되어 활용되는 개발언어이기도 하고 각종 리포트의 항상 상위권 인기에 머무르는게 이 언어이다. 같이 일하던 동료가 말하는 숙련자란 Javascipt를 잘 이해하고 서버 개발에 활용할 수 있는 사람을 말한다.

그러한 관점에서 나 또한 비슷한 사람에 속한다. 오랫동안 다뤄왔지만 JavaScript 내부 동작에 대해 고민해보거나 개발 언어 특성에 맞게 코드를 작성하려는 노력을 굳이 하지 않았다. 누군가 좋은 패턴이라고 하면 수용적인 태도로 고개를 끄덕거리며 비슷하게 코드를 작성하기 위해 시간을 들였던 기억만 남는다. 쉬우면서도 어려운 언어 그리고 오래동안 사용했지만 자신있게 잘 사용할줄 안다고 하기 어려운 개발 언어가 JavaScript이다.

You Dont' Know JS는 JavaScript을 알지만/잘 알지 못하는 개발자들을 위한 필독서라고 할 수 있다. 이 책의 강점이라고 할수 있는데, 내부 동작방식에 대해 정말 짧은 예시 코드들을 가지고 설명을 풀어나간다는 점이다.

짧은 예시 코드들은 복잡하지 않기 때문에 독자의 이해를 돕기도 하지만, 한번에 이해되지 않는 상황에도 부담을 줄여주어 여러번 반복해서 읽어볼 수 있게 해준다.

사실 YDKJSY(You Don't Know JS Yet)시리즈는 6개의 챕터로 이루어져 있는데, 이번 책은 첫번째 자바스크립트 개념과 두번째 스코프와 클로저를 엮어서 만든 것이다.

시작하기 (자바스크립트 개념)
스코프와 클로저
객체와 클래스
타입과 문법
동기와 비동기
ES.Next와 그 너머

기억나는 몇몇 내용들을 요약하자면

JavaScript는 ECMAScript의 스펙을 지원하는 개발언어이며, 하위호환을 존중하는 언어이다.
렉시컬 스코프 스펙을 지원하기 위해 구문 분석과 같은 컴파일이 필요하고 실제 동작은 인터프린터 방식을 취한다.
function에 대한 일급 객체를 지원한다.
(class 문법을 추후 지원했지만) 클로저, 프로토타입을 활용하여 function을 추상화 및 캡슐화하였고 상속 개념처럼 활용할 수 있도록 발전해왔다.
간략한 코드 예시를 통한 스코프와 클로저의 수많은 개념 설명들

저자는 초반에 중급자를 위한 책이라고 밝히는데 사실 JavaScript를 막 시작한 개발자가 아니라면 크게 무리가 없다고 생각한다. 중요한 점은 다른 개발 언어를 다뤄봄으로써 JavaScript의 철학을 이해하고 비교할 수 있는지가 중요한데 Java, Python, C/C++, Golang등 어떤 것이든 상관이 없다고 생각한다. Java에서는 클로저를 지원하진 않지만 함수형 인터페이스를 통해 함수를 전달받고 응답할 수 있는 수준까지 제공하고 있으며 Python에서는 클로저를 지원하며 이를 활용하여 decorator 기능을 언어차원에서 제공하기도 하였다. 또한 golang에서도 클로저를 직접 지원한다.

스코프는 여전히 헷갈리지만 클로저 부분은 꽤 재미있게 읽었다.

여러 사람들과 같이 읽으면 더 좋은 책이라고 생각한다. 각자 갖고 있는 지식이나 경험을 기반으로 비교하며 장단점에 대해서 토론할수 있기 때문이다.

"한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

[2023년 결산] 한빛냥 독자의 소리

morenice — Sat, 24 Feb 2024 23:14:51 +0900

이메일 데브잇 내용 중

2023년 가을쯤 내가 작성한 리뷰 글이 하나 소개되었다. "파이썬 크래시코스"는 쉽게 잘 풀어쓰고 구성이 꽤 좋은 책이라 즐겁게 읽었는데 이렇게 소개까지 해주셔서 기분이 참 좋았었던 기억이 난다.

[Review] - 파이썬 크래시 코스

해당 리뷰는 "나는 리뷰어다" 활동으로 작성한 글이다. "나는 리뷰어다"는 한빛미디어의 도서 서평단을 말한다. 특별한 위치 또는 권위가 있지 않아도 컨텐츠를 작성할 준비가 된 사람이라면 신청할 수 있다. 예를 들어 블로그를 운용하거나 인스타 또는 트위터등을 통해서 어느정도는 활동을 하는 경우인데 선정이 될 수도 있고 안될수도 있다.

IT 개발자의 덕목 중, 기술에 대한 꾸준한 관심을 갖는 것 그리고 어떤 활동이든 자신의 시간을 관심분야에 할당하는 것이 중요하다고 생각한다. 이러한 관점에서 나는 리뷰어다가 꽤 좋은 영향력을 주고 있고 블로그를 통해 컨텐츠 생산자가 되어 내가 알게된 사실들을 재 가공하고 공유하는 것이 꽤 즐거운 일이기도 하다.

2024년에는 부족한 글 솜씨가 조금이라도 더 좋아지는 한해가 되길.

[2023년 결산] WakaTime와 함께하는 개발 회고

morenice — Sat, 24 Feb 2024 22:47:37 +0900

[Daily] - [2022년 결산] WakaTime와 함께한 개발 기록

작년에 이어 올해도 WakaTime에서 일년간의 기록을 잘 정리해서 이메일로 보내주었다.

Code stats report for 2023

간략한 회고를 해보자면, 평균 2시간의 개발을 했으며 올해도 열심히 정말 열심히 Java를 활용하여 서비스 개발을 했다.

Langugaes for 2023

주로 Java, Scala을 활용하여 개발을 했는데, 올해는 Go를 다시 한번 학습하고 서비스 개발에 활용하는 시간을 갖기도 하였다. 간결한 문법과 매우 빠른 성능 그리고 goroutine을 활용한 virtual thread 전략은 참 훌륭하다. 아쉽게도 마지막에 해당 프로젝트가 다시 Kotlin 기반으로 변경되긴 했지만.

한편, 2023년 9월 Java LTS 21 버전이 릴리즈되었고 공식적으로 virtual thread를 지원하게 되었다. Spring에서는 비동기를 위한 Webflux(Reactive Programming)를 오래전부터 지원하고 있었으며 적은 리소스로도 대량의 I/O 요청에 대응할 수 있었다. 이제 virtual thread까지 지원을 하게 되었으니, Spring을 발판삼아 Java는 앞으로도 여전히 서비스 개발에 사랑받는 언어 및 서버 환경이 되지 않을까 하는 생각이 들었다.

새로운 시도로 reactive programming에 대해 강의를 만들기도 하였다. 시간을 꽤 많이 들였지만 결과물을 생각하면 아쉬움이 남기도 하고 충분히 많은 실험들을 했기에 뿌듯하기도 한 기억에 남는다.

2024년에는...

Java virutal thread에 대해서 알아보고 reactive programming과 비교하여 각각 어떤 상황에 활용하면 좋을지 고민을 해볼 생각이다.
같은 동네에서 가끔 만나는 친구 같은 Javascript에 대해서 진중하게 공부를 해볼 계획이다.

Release의 모든 것

morenice — Mon, 25 Dec 2023 12:00:20 +0900

마이클 나이가드 지음, 박성철 옮김

소프트웨어 개발을 처음 시작하는 사람들은 요구사항에 대한 정교한 설계 보다는 어떤 기술을 사용해서 어떻게 구현할 것인지에 대해 고민을 하게 되는데 운용을 포함한 입체적인 관점보다는 구현 자체에만 의미를 두는 경우가 많다. 여기서 정교한 설계는 어떤 시스템과 통합될 것인지 그리고 사용하게될 사용자수는 어떻게 되는지, 안정성을 위해 테스트 시나리오는 무엇일지 그리고 마지막으로 이 모든것을 포함하여 구현해야할 기능들에 대해 일정내 가능할지등 고민하는 것을 말한다.

문제는 실제 제품이나 서비스 운용 경험이 있어야 설계에 여러가지 고려사항들을 포함시킬 수 있다는 점이다. thread safe하지 않는 API를 사용해서 간헐적으로 프로세스가 죽는다던가 또는 책에서도 나오는 예시로 try-catch-finally에서 finally 구문에 close에서 다시 예외가 raise 될 수 있는 것을 고려하지 못해 socket 파일을 닫지 못하는 상황이 발생할 수 있다.

"Release의 모든 것", 이 책은 제품 및 서비스(대부분 서비스 이야기이지만...) Release 이후의 일어날 수 있는 문제점 요소들에 대해 나열하고 서사 방식의 예시를 통해 몰입을 더한다. 책 표지만 봐서는 Release를 어떻게 해야하는지에 대한 좀 따분한 느낌이 들긴 했지만 말이다.

저자 마이클 나이가드는 미국 정보, 은행, 금융, 농업, 상거래등 시스템을 설계 구축하고 운용한 사람으로써, 이미 2007년에 1판 "Release it ! 성공적인 출시를 위한 소프트웨어 설계와 배치" 책을 다시 가다듬어서 2판으로 낸 것이다.

2장 사례연구 내용 중, 흥미 진진한 현장의 느낌...

5장 안정성 패턴 중 ...

GLSB DNS 설계 관련

안정성 패턴 또는 안티패턴으로 시작하여 프로세스, 상호 연결 그리고 OWASP 보안까지 넓은 분야의 주제들을 읽고 정리할 수 있게 도와준다. 서비스 운용에 꼭 필요한 그리고 문제가 발생했을 때 기민하게 대응을 도와줄 레퍼런스가 되어줄 것이다.

[1부 안정성 구축]
1장 운영 환경의 현실
_1.1 올바른 목표 설정
_1.2 도전의 범위
_1.3 여기도 백만 달러, 저기도 백만 달러
_1.4 ‘포스’를 사용하라
_1.5 실용주의 아키텍처

2장 사례 연구: 항공사를 멈추게 한 예외
_2.1 변경 시간대
_2.2 작동 중단
_2.3 장애의 영향
_2.4 사후 분석
_2.5 단서 수색
_2.6 결정적 단서
_2.7 외양간 고치기?

3장 시스템 안정화
_3.1 안정성 정의
_3.2 수명 연장
_3.3 장애 모드
_3.4 균열 확산 차단
_3.5 장애 사슬
_마치며

4장 안정성 안티 패턴
_4.1 통합 지점
_4.2 연쇄 반응
_4.3 연계 장애
_4.4 사용자
_4.5 블록된 스레드
_4.6 자기 부정 공격
_4.7 척도 효과
_4.8 처리 능력 불균형
_4.9 도그파일
_4.10 지렛대 원리
_4.11 응답 지연
_4.12 제한 없는 결과

5장 안정성 패턴
_5.1 시간 제한
_5.2 회로 차단기
_5.3 격벽
_5.4 정상 상태
_5.5 빠른 실패
_5.6 파손 방치
_5.7 핸드셰이킹
_5.8 테스트 하네스
_5.9 결합 분리 미들웨어
_5.10 부하 제한
_5.11 배압 생성
_5.12 조속기

[2부 운영 고려 설계]

6장 사례 연구: 램프 속 우주의 힘
_6.1 첫 번째 크리스마스
_6.2 맥박 확인
_6.3 추수감사절
_6.4 블랙 프라이데이
_6.5 생명 징후
_6.6 진단 테스트
_6.7 전문가 호출
_6.8 처치 방안 비교
_6.9 처치 결과
_6.10 휴식 시간

7장 기반
_7.1 데이터 센터와 클라우드의 네트워크
_7.2 물리 호스트, 가상 머신, 컨테이너

8장 프로세스
_8.1 코드
_8.2 구성
_8.3 투명성

9장 상호 연결
_9.1 규모에 맞는 해법
_9.2 DNS
_9.3 부하 분산
_9.4 수요 제어

10장 제어 평면
_10.1 적합도 평가
_10.2 기계적 확대율
_10.3 플랫폼과 생태계
_10.4 운영 수준 개발 환경
_10.5 시스템 전반의 투명성
_10.6 구성 서비스
_10.7 프로비저닝과 배치 서비스
_10.8 명령과 제어
_10.9 플랫폼 제품
_10.10 점검 목록

11장 보안
_11.1 OWASP 상위 10개
_11.2 최소 권한의 원칙
_11.3 비밀번호 관리
_11.4 상시 업무 절차로서의 보안

[3부 시스템 전달]
12장 사례 연구: 고도를 기다리며
13장 배치 고려 설계
_13.1 반려 동물과 가축
_13.2 시스템 점검 시간이라는 오류
_13.3 자동 배치
_13.4 지속적 배치
_13.5 배치의 여러 단계
_13.6 전문가의 배치

14장 버전 관리
_14.1 다른 서비스를 고려한 버전 관리
_14.2 다른 서비스의 버전 관리
_마치며

[4부 체계적 문제 해결]
15장 사례 연구: 고객에게 짓밟히다
_15.1 최종 점검과 출시
_15.2 QA 지향
_15.3 부하 테스트
_15.4 대중에 의한 살인
_15.5 테스트 간극
_15.6 후유증

16장 적응
_16.1 볼록 곡선 수익률
_16.2 절차와 조직
_16.3 시스템 아키텍처
_16.4 정보 아키텍처

17장 카오스 공학
_17.1 개선을 위한 파괴
_17.2 카오스 공학의 선구자
_17.3 유인원 부대
_17.4 나만의 원숭이 입양
_17.5 재해 시뮬레이션

시니어 개발자라는 이야기를 하게 되면 꼭 대용량 트래픽이 빠지지 않는다. 그만큼 난이도가 있고 시스템적으로 난이도가 있고 컴퓨팅자원뿐 아니라 인정 자원등 고려할 사항이 많기 때문인데 이 책은 그에 대한 힌트 또한 얻을 수 있다. 물론 대용량 트래픽이 아니더라도 복잡한 시스템에 대해 어떻게 운용 관점에서 밤을 새지 않고 새벽에 끌려가지 않게끔 건강한 개발자 그리고 건강한 시스템을 만들어가게 되는 비법을 제공한다. 이 책의 큰 장점이다.

물론 단점 또한 존재하는데 많은 주제를 이야기하다보니 최소 CS(Computer Science) 지식과 서비스 개발 및 출시 경험이 조금이라도 있어야 몰입할 수 있다는 점이다. TCP/IP가 무엇인지 3 hand shaking 과정은 어떻게 되고 TIME_WAIT을 줄일 수 있는 설정은 어떻게 하는지등 자세한 내용은 서술하지 않는다. 당장 구현해야할 기능들을 해결하기 급급하다면 책의 절반 이상은 공감하기 힘들고 다른 세상 이야기로만 느껴질 수 있다. 그럼에도 불구하고 옆에 두고 패턴 부분이나 실제 사례 내용들을 차근차근 읽어보면 1~2년 뒤 개인의 성장과 담당 서비스가 성숙하는데 충분히 도움이 될 것이라 생각한다.

"한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

파이썬 크래시 코스

morenice — Sat, 26 Aug 2023 22:22:39 +0900

출처: https://www.aladin.co.kr/shop/wproduct.aspx?ItemId=321468224&start=slayer

개인적으로 Python이란 개발언어를 활용하게 된지는 꽤 오래되었다. 데이터베이스와 같은 라이브러리 종속적인 스크립트를 만들거나 CLI을 만드는 것으로 시작하여 웹 서비스 개발까지 경험하게 되었는데 현재의 Python의 위상은 그 이상으로 대단하다.

Python은 윈도우, 리눅스, 맥과 같이 다양한 OS를 지원하고 쉬운 설치를 할 수 있다.
매우 쉬운 문법을 제공함으로써 아주 적은 코드로 개발을 할 수 있는데 프로그래밍을 시작하는 이들에게 공부를 시작하는 첫 관문이 되기도 하고 데이터분석을 위한 시작이 되기도 한다.
대표적인 해외 웹 서비스로써 인스타그램이 있다. 과거 인스타그램은 Python을 활용하여 전세계 서비스를 운용하였을 정도이다. 최근에도 적극 활용하고 있는지는 별도 확인해보지 않았다
데이터 시각화 또는 데이터 분석에 주로 활용되며 ML까지도 활용되고 있다.

만약 프로그래밍에 충분한 경험이 있는 사람들은 Python 레퍼런스 문서만 읽어도 시작이 가능하지만, 개발을 처음 시작하는 사람에게는 좀 더 친절하고 숙련된 가이드가 필요하다. 이 책은 Python을 시작하는 사람에게 중요한 입문서 역할을 하는 책이다.

책은 기본편과 실습편으로 분할되어 있고 기본편에서는 Python 언어 설치부터 문법에 대한 설명과 다양한 연습문제들이 제공된다. 실습편은 앞서 기본편에서 학습한 문법들에 대해 좀 더 실용적인 실습을 할 수 있도록 재미있는 프로젝트 기반의 실습을 제공함으로써 학습자의 몰입을 돕고 좀 더 능숙하게 언어를 다룰 수 있도록 한다.

저자 에릭 마테스는 기술서적 저자이면서 개발자이다. 2000년쯤 Java를 사용하여 개발을 했지만 현재는 Python을 주로 활용하고 있고 비영리재단에서 활동하거나 여러 오픈 소스 프로젝트에 참여하고 있다. 만약 저자의 다양한 생각을 엿보고 싶다면 이 인터뷰 내용을 읽어보자

기본편 제일 마지막에 코드 테스트 부분을 제공하고 있는데 사실 소프트웨어 개발에 있어 테스트 코드는 매우 중요하기 때문에 아무리 입문서라도 이런한 부분들을 언급하고 담백하게 내용을 담고 있는 점은 장점이다.

실습편은 3가지 프로젝트를 제공하는데 첫번째는 pygame을 통해 과거의 오락실에서 한번 해봤을 만한(또는 추억의 갤러그 같은) 슈팅 게임을 만들어보는 것이고 그 다음은 데이터를 기반으로하는 다양한 시각화, 마지막으로 Django 기반 웹서비스 개발이다. 이렇듯 단순 실습이 아니라 프로젝트 기반이고 충분히 사용자가 개발을 하면서 재미를 느낄 수 있도록 게임을 도입했다는 것이 인상적이다.

참고로 책 서문에서도 꽤 친절한 가이드가 있는데 입문자의 난이도를 고려하여 실습 중 Django 부분은 제일 마지막에 하라고 나와있다. 실제로 Django 프레임워크는 2005년즘 첫 릴리즈를 시작했으니 올해를 기준으로 약 18년이나 된 굉장히 성숙한 프레임워크이고 Production을 위한 많은 기능들을 제공한다. 개인적으로 소규모의 프로젝트를 진행하게 될 때 특별한 이유가 없다면 바로 선택하여 활용하기도 하고 국내 스타트업에서도 활용하고 있어 학습을 해야할 이유가 충분한 프레임워크이다.

무엇보다 개발을 시작하고 실력이 늘어가는 과정을 경험하려면 실용적인 과정이 반드시 필요하다고 생각한다. 이 책은 기본 문법 뿐만 아니라 실용적인 관점에서 주요 프로젝트 실습까지 제공함으로써 입문자가 빠르게 성장하는 기반을 마련해줄 수 있는 입문서라고 생각한다.

"한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

소프트웨어 아키텍처 the hard parts

morenice — Sat, 1 Apr 2023 00:44:59 +0900

출처: https://www.aladin.co.kr/shop/wproduct.aspx?ItemId=302311495

소프트웨어 아키텍처 the hard parts는 2021년도에 출판된 소프트웨어 아키텍처 101 책의 후속 편이다. 저자 닐포드, 마크 리처즈의 책으로써 이번 hard parts에서는 프라모드 세달라지, 세약 데그하니가 저자로 추가되어 총 4명의 저자가 쓴 현대적인 소프트웨어 아키텍처의 advanced 기술 서적이다.

모든 문제가 하나하나 새로운 도전을 요하기에 어떻게든 문제를 해결하려는 중대한 의사 결정의 양편에 치우친 수많은 트레이드오프를 냉정하게 판단하고 평가할 때 아키텍트의 진가가 드러납니다.

소프트웨어 아키텍처에서는 최고의 설계를 고집하지 마세요. 그 대신 나쁜 것 중에서 제일 나은(least worst) 트레이드 오프 조합을 찾으세요.
26p

책 시작부에 나오는 이야기로써, 사실 시스템 또는 서비스 아키텍처란 작은 범위의 문제를 해결하는 알고리즘 수준이 아닌 좀 더 큰 범위의 문제 또는 도메인을 다뤄야 하기 때문에 모든 문제를 같은 해법으로 해결할 수 없는 경우가 대부분이다. 전반적으로 트레이드오프를 어떻게 분석하고 활용하는지를 서술해 나간다.

무엇보다 한빛가이버 티켓팅 애플리케이션팀의 이야기를 엿볼 수 있다. 한빛가이버란 가상의 애플리케이션으로 운영상 발생한 문제에 대해서 문제가 무엇이고 담당자들 간 의견의 차이점을 설명한다. 상황 및 트레이드오프를 위한 기반 내용 설명을 해주게 되는데 이후 나오게 되는 기술 설명들에 대해 몰입할 수 있게 해주는 중요 역할을 맡고 있다.

책은 크게 두 개의 파트로 나누어져 있다.

Part1 따로 떼어놓기
Part2 다시 합치기

하나의 모놀리식 애플리케이션을 어떻게 분할하여 확장해나 가는지에 대한 Part1 그리고 운영하는 데 있어 분할이 끝이 아니라 적절한 크기의 서비스를 만들어가기 위한 다시 합치는 과정 그리고 마이크로서비스에서 피할 수 없는 분산 트랜잭션에 대한 이야기로 가득하다.

이 책은 새로 시작하는 서비스의 아키텍처를 이야기하는 책은 아니다. 서비스 또는 애플리케이션이 점차 발전해 나감에 따라 어떤 문제점을 직면하게 될 것인지 그리고 해결 아이디어에 대한 트레이드오프가 무엇인지를 미리 경험해 볼 수 있는 장점이 있다.

책을 읽어나가면서 개발 일을 하면서 경험했었던 비슷한 일들을 보곤 하여 공감이 가는 부분들도 꽤 있었다. 책상 옆에 두고 신규 도메인 일을 할 때마다 반복적으로 읽어보고 싶은 책이다.

초기 스타트업에서 살아남아 조직이 확대되고 마이크로서비스를 준비하고 있는 개발조직에서 읽으면 꽤 유용할 것이라고 생각한다. 참고로 도메인 주도 설계에 대해서 미리 학습하고 본다면 이해하는데 더욱 도움이 될 것이다.

"한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

State of Spring 2022

morenice — Mon, 6 Mar 2023 00:10:33 +0900

얼마 전

youtube를 보면서 시간을 보내다가 토비님의 영상을 보게 되었다.

State of Spring 2022 내용에 대해 리뷰하는 내용이었는데, 꽤 재미있게 보기도 하였고 Spring 생태계에 대해서 이해할 수 있는 참고 자료이기도 하여 간략하게 리뷰를 해보려고 한다.

State of series

우선 State of Spring은 VMware 회사에서 설문조사를 진행하고 정리한 통계 발표 자료이다. 사실 VMware의 자료는 처음 접한 상태였는데 구글링을 해보니 State of Kubernetes, State of observability등 다양한 시리즈가 있었다. 이 글의 첨부된 이미지들은 모두 State of Spring 2022 pdf에 포함된 내용들이다.

Demographics

설문조사의 49%가 유럽 그리고 26%가 미국이다. 인도, 아시아, 호주등 다양한 국적이 포함되어 있지만 상당히 많은 부분 미국과 유럽 사람들의 설문 결과가 포함되어 있다는 것을 감안해야 한다.

(사용하는 사람들에게는) Spring은 여전히 강력한 도구이다.

Almost half of stakeholders (47%) reported that they will be using more Spring modules in the coming years, an increase of 8 points. For 2022, the top three Spring Projects remain Spring Security, Spring Data, and Spring WebMVC

마이크로서비스를 위한 프레임워크

The shift to modern architectural styles continues

어두운 녹색이 2021년 그리고 밝은 녹색 2022년을 의미한다. 작년 대비 크게 변화는 없지만 마이크로서비스에 90% 이상 활용하고 있다. 한편 Serverless의 경우에는 약 5%정도 늘어나게 되었는데 Spring Boot 3 활용을 통해 내년에는 비율이 더 많이 늘어날 것이란 생각이 들었다. 이유는 Spring Native 때문인데 Serverless와 매우 밀접한 관계가 있기 때문이다.

API

OpenAPI and GraphQL are gaining ground

Spring Native

Adoption of Spring Native

Spring Boot3부터 GraalVM을 사용한 Spring Native를 정식 지원한다. Java는 인터프리터 언어라서 실행 환경에서 VM(Virtual Machine을 통해 바이트 코드를 기계어로 번역하고 실행하는 흐름을 갖는다. VM에서는 번역 과정에서 기계어를 cache하는 JIT 컴파일러를 운용한다. 그러다보니 시작 단계에서는 여러모로 실행이 느릴 수 밖에 없는데 Serverless 환경에서 다소 치명적이다. Spring Native는 이러한 단점을 해소하기 위해 아예 실행 가능한 바이너리(최적화된)까지 만들어버린다. 이 방식이 코드 최적화까지 최선인가는 고민을 해봐야겠지만 실행 시간 단축에는 충분히 도움이 될 것으로 보인다.

많은 사람들이 압도적으로 Spring native에 대해서 관심이 있었고 2년이내 배포할 계획이 있다고 한다.

Project loom

Excitement building for Project Loom

많은 사람들은 Virtual thread 도입에 긍정적으로 바라보고 있다. 또한 Spring에서도 Virtual thread에 대해 발빠르게 도입하려는 움직임이 있지만 아직 충분하지 않다는 의견이다. 현재로써는 대량의 I/O를 처리하기 위해서는 함수형 프로그래밍에 대한 기본 이해가 필요한 Webflux를 활용해야 하는데(물론 다른 대안도 있지만) 향후 Virtual thread가 안정적으로 확대되고 기술이 성숙해진다면 기존 코드 스타일(blocking I/o)을 유지하면서도 대량의 I/O를 처리할 수 있는 날이 다가올 것으로 생각된다.

Reference

State of Spring 2022

Download the State of Spring 2022 report to learn what matters most to the Spring community and to get a peek at how Spring continues to evolve.

tanzu.vmware.com

소스코드 주석(comment)에 대한 짧은 글

morenice — Sun, 5 Mar 2023 23:22:28 +0900

위키피디아에 의하면 주석이란 소스 코드를 더 쉽게 이해할 수 있게 만드는 것이 목적인 메모를 말한다.

주석 또는 코멘트는 프로그래밍에 있어 내용을 메모하는 목적으로 쓰인다. 소스 코드를 더 쉽게 이해할 수 있게 만드는 것이 주 목적이며, 협업할 때 유용히 쓰인다. 컴파일러와 인터프리터에 의해 일반적으로 무시되어 프로그램에 영향을 주지 않는다.
위키백과

하지만 주석 때문에 소스코드를 더 이해하기 어려울 수 있다. 예를 들어,

1. 코드의 의도가 명백하여 오히려 주석이 중복 내용에 가깝다. "XX를 출력합니다, XX를 가져옵니다. XX를 처리하고 응답합니다."등이 있다.

2. 주석이 관리가 되지 않아 소스코드의 내용과 전혀 다른 설명을 하게 된 경우이다. 너무나도 슬픈 사실인데 소스코드를 수정하는 사람이 주석은 고치지 않은 것이다. 주석 내용이 함정이 될수 있으니 오히려 이 상황을 직면한 개발자에게 위협적일 수 있다.

3. 코드의 동작을 설명하기 보다는 자신이 왜 이렇게 작성했는지 당위성이 적혀있다. 예를 들어 "클린코드를 위해 A 오픈소스를 활용하여 전역 관리를 하여 어쩌구저쩌구... 그래서 이렇게 구현되어 있다"가 함께 적혀있다고 생각해보자. 그나마 허용가능한 수준은 README 파일에 기술하는 것이고 아예 없는편이 좋다고 생각한다. 때때로 "성능상의 이유로 XXX를 어쩌구저쩌구"등과 같이 협업 개발자가 오해하지 않게끔 가이드를 주는 주석들은 꽤 괜찮은 방향이라 생각한다.

번외편으로 아주 간혹 주석에 날짜와 자신의 계정 이름을 적는 경우를 만날 때가 있다. 버전 관리가 없는 세상에서는 도움이 되었을 수 있으나, git이란 버전 관리도구가 보편적이고 흔하게 사용되는 세상이다. 소스코드를 수정한 사용자와 날짜가 모든 커밋 로그에 기록이 되기 때문에 이제는 주석에 더 이상 기록하지 않아도 된다.

반대로 도움이 될만한 내용을 몇 가지 적으면, 수학 수식이 들어간 로직이나 최적화를 위해 가독성이 떨어진 경우 그리고 TODO, FIXME, 마지막으로 주의사항등이다.

마지막으로 주석은 협업을 위해서도 중요하지만 본인을 위해서도 유용하다. 내가 작성했다고 해서 모든 코드가 기억이 나고 빠르게 이해할 수 있는 것은 아니기 때문이다.

마이크로서비스 아키텍처 구축 가이드

morenice — Sat, 25 Feb 2023 20:29:57 +0900

김용욱 지음

마이크로서비스란?

마이크로서비스는 소프트웨어가 잘 정의된 API를 통해 통신하는 소규모의 독립적인 서비스로 구성되어 있는 경우의 소프트웨어 개발을 위한 아키텍처 및 조직적 접근 방식입니다. 이러한 서비스는 독립적인 소규모 팀에서 보유합니다. 마이크로서비스 아키텍처는 애플리케이션의 확장을 용이하게 하고 개발 속도를 앞당겨 혁신을 실현하고 새로운 기능의 출시 시간을 단축할 수 있게 해 줍니다.
- AWS -

마이크로서비스란 소프트웨어를 구축하기 위한 아키텍처이자 하나의 접근 방식으로, 애플리케이션을 상호 독립적인 최소 구성 요소로 분할합니다
- Redhat -

마이크로서비스란 단어가 사용되기 시작한지는 대략 10년정도 됬지만 널리 알려진지는 얼마 되지 않았다. 마이크로서비스가 없는 세상에서는 서비스/앱 개발에 대해서 백엔드를 위한 서버 인프라와 모바일 또는 웹 클라이언트로 크게 분류하고 백엔드는 layered architecture로 구현되고 있었다. 트래픽이 점차 늘어나게 되면 로드밸런서를 도입하여 어플리케이션 서버를 확장하거나 DB scale-up 전략이 일반적이었다고 생각한다.

페이스북, 트위터, 넷플릭스등 폭발적인 성장을 하는 서비스의 등장으로 엔지니어들은 빠른 비지니스 변화에 대한 수용과 서비스 배포주기, 몇백 몇천명 수준의 개발자들이 서로 의존성을 최소화하면서 서비스를 개발하고 확장 가능한 구조가 필요했을 것이다.

마이크로 서비스 구축 가이드

마이크로서비스는 명시적인 스펙이 아니다. 그래서 회사 마다 바라보고 적용하는 수준이 다를 수 있다. 그러다보니 자사의 서비스에 마이크로서비스를 도입하는게 맞는지 그리고 도입하게 된다면 맞는 구조란 무엇인지가 모호하게 느껴지는 것도 사실이다. 이 책은 마이크로서비스란 무엇인지로 시작하여 도입을 고민하고 싶다면 어떠한 기준이 필요한지 장단점에 대한 설명으로 시작하고, 이어서 온라인 강의 서비스를 구축한다는 가정으로 하나하나 섬세하게 마이크로서비스에 대한 적용 단계를 설명한다.

점진적 마이크로서비스 전환

모놀로식 vs 마이크로서비스

"3장 데이터베이스를 분리한다고?" 에서는, 모놀로식 대비 마이크로서비스로 서비스를 개발하게 될 때 경험하게 되는 문제점들을 나열하고 해결방안에 대해서 서술한다. 전반부에 이러한 내용들이 잘 정리되어 있는 점이 인상적이었고 설명을 매끄럽게 잘하는 점이 좋았다. 대략 3-4년전 마이크로서비스로의 전환 작업을 진행했을 때 직면했던 문제점들에 대해 잘 정리되어 있어 놀랐다.

자주 변하지 않는 데이터는 로컬 캐시를 도입함으로써 성능을 향상 시킬 수 있다.

마이크로서비스에서 API 일괄 요청에 로컬 캐시를 도입하게 되면 모놀로식의 단일 SQL(1번)과 거의 동일한 처리 속도가 나오게 된다.

아래는 목차로써 크게 1부, 2부로 나누게 되고 1부에서는 이론적인 개념들이 2부에서는 구축 예시들로 구성되어 있다.

1부. 마이크로서비스 아키텍처 이해하기
- 1장. 마이크로서비스 아키텍처란?
- 2장. 어떻게 적용해야 할까?
- 3장. 데이터베이스를 분리한다고?
2부. 마이크로서비스 아키텍처 적용하기
- 4장. 서비스 선정하기
- 5장. 서비스 설계 원칙
- 6장. 서비스 설계하기
- 장. 서비스 개발하기

다른 책에 비해 서비스 경계를 선정하는 방식에 대해 설명이 많다는 것 또한 꽤 인상적이다. 모놀리식에서 마이크로서비스로의 전환 과정에 대한 경험이 있다면 개별 서비스를 정의하는 것이 쉽지 않은 영역이란걸 알 것이다. 한편, 다른 책에서 흔하게 이야기하는 DDD(도메인 주도 설계) 기반 모델링에 대해서는 집중하여 다루진 않는다. 아니 오히려 DDD만이 마이크로서비스를 설계하는 방법이 아니라고 이야기 한다.

화면 요구사항, 기능 요구사항에 대한 예시를 기반으로 설계 구조를 그림으로 설명한다. 그 외 API 설계나 실제 코드 그리고 버전을 통한 유지보수 예시등 운용에 대한 다양한 설명을 엿볼 수 있다.

마무리

가벼운 마음으로 읽기 시작했는데 꽤 몰입해서 보게 된 책이었다. 마이크로서비스를 구축하려는 계획이 있는 사람이 이 책을 메인으로 시작하여 다른 책을 1-2권을 비교하고 설계 작업을 점진적으로 진행한다면 상당한 도움을 받을 수 있지 않을까하는 생각이 들었다. 안정적으로 서비스를 개발 및 보완할 수 있게 하는 길잡이 역할이 되어줄 것이다. 한편 백엔드 개발 경험 또는 운용 경험이 없다면 한번에 와닿지 않거나 이해하기 어려울 부분이 있을 수 있다.

Reference

"한빛미디어 <나는 리뷰어다> 활동을 위해서 책을 제공받아 작성된 서평입니다."

[윈도우10] 마이크로소프트가 직접 제공하는 PowerToys

morenice — Wed, 11 Jan 2023 23:25:47 +0900

개요

윈도우 OS를 개발하는 마이크로소프트에서 직접 PowerToys 프로그램을 제공한다. 이 프로그램은 아주 강력하고도 재미있는 기능들을 묶음으로 제공한다. 예를 들면 맥에서 편하게 활용하던 Spotlight(Powertoys Run), 간단한 클릭만으로 화면이 잠기지 않게 해주는 카페인(awake), 그 외 모니터 눈금 표시나 RGB 색 확인 그리고 마우스 위치 확인, 이미지 크기 일괄 변경, 프로그램 레이아웃 커스텀등 다양한 기능들을 제공한다.

설치

Releases · microsoft/PowerToys

Windows system utilities to maximize productivity. Contribute to microsoft/PowerToys development by creating an account on GitHub.

github.com

PowerToys는 Github repository의 release note화면에서 설치 파일을 받을 수 있으며, 다운로드 후 실행을 하면 설치가 진행된다. 잠깐, Github 또한 마이크로소프트에서 몇년 전에 인수하여 운용하고 있다. 이 글은 온통 마이크로소프트 세상이다.

설치 과정

다운로드한 설치 파일을 실행하여 설치를 완료하고, 프로그램을 시작하면 아래와 같은 기능 소개 화면을 만날 수 있다.

PowerToys 프로그램 찾기

PowerToys 기능 설명

DSLR로 촬영한 사진들은 raw 파일들이 아니더라도 대부분 5~10M 또는 그 이상의 파일 크기를 갖게 되는데, 메신저로 큰 크기의 사진들을 대량으로 공유하기에는 좀 부담이 된다. 이럴 때 이미지 Resizer(크기 일괄 수정) 기능을 사용하면 매우 유용하다.

Image Resizer 설명

위와 같이 사진들을 선택하고 마우스 우측 버튼 > "그림 크기 조정"을 선택하면 메뉴가 노출되는데 "이미지 크기"만 설정하면 바로 크기가 조정된 사진들을 일괄로 만들어낼 수 있다.

꼭 설치해서 PowerToys Run이라도 활용해보길 추천한다. 프로그램 실행뿐 아니라 재부팅이나 파워오프까지 간단히 명령을 내릴 수 있다. 설치 이후 윈도우 사용성이 매우 좋아질 것이다.

PowerToys Run

morenice's blog

Docker Desktop Malware Blocked - com.docker.vmnetd

N잡러를 위한 전자책 만들기

실무로 통하는 클린 코드

처음 시작하는 FastAPI

한 권으로 끝내는 이미지 생성 AI with 미드저니

You Don't Know JS Yet - 자바스크립트 개념, 스코프와 클로저

[2023년 결산] 한빛냥 독자의 소리

[2023년 결산] WakaTime와 함께하는 개발 회고

Release의 모든 것

파이썬 크래시 코스

소프트웨어 아키텍처 the hard parts

State of Spring 2022

얼마 전

State of series

(사용하는 사람들에게는) Spring은 여전히 강력한 도구이다.

마이크로서비스를 위한 프레임워크

API

Spring Native

Project loom

Reference

소스코드 주석(comment)에 대한 짧은 글

마이크로서비스 아키텍처 구축 가이드

마이크로서비스란?

마이크로 서비스 구축 가이드

마무리

Reference

[윈도우10] 마이크로소프트가 직접 제공하는 PowerToys

개요

설치

See also