코드와 기술을 탐구하고 경험을 기록하는 개발 연구실.
AI · Backend · Cloud · Engineering
총 331개의 글 · AI·LLM, 백엔드, 클라우드, 데이터베이스, 개발 자동화까지. 기술을 탐구하고 실무 경험과 최신 IT 트렌드를 기록하는 개발자 기술 블로그, Pupbani’s Lab입니다.
Docker Compose에서 API 키와 데이터베이스 비밀번호를 안전하게 전달하려면 environment에 값을 직접 넣기보다 secrets를 사용하고, 애플리케이션이 /run/secrets/이름 파일을 읽도록 설계하는 편이 좋습니다. 다만 일반 Docker Compose의 파일 기반 시크릿은 Docker Swarm의 암호화된 시크릿 저장소와 동일하지 않습니다. 호스트 파일의 보안, 권한, 백업, 회전 정책까지 관리해야 합니다.기술 문서 확인: 2026-11-08 · 대상: Docker Compose를 사용하는 Linux 컨테이너 기반 개발·운영 환경 · 예제는 로컬 실행 및 부하 테스트를 수행하지 않았습니다.1. 왜 .env 파일만으로는 부족할까?.env는 Compose 설정값을 편리하게 관리하는 수..
RAG 청킹(Chunking)은 문서를 검색 가능한 작은 단위로 나누는 작업입니다. 좋은 청킹 전략은 무조건 잘게 자르는 것이 아니라, 질문에 답하는 데 필요한 문맥을 보존하면서 검색 결과에 불필요한 내용을 줄이는 것입니다. 처음에는 문단 중심의 재귀 분할을 기준선으로 삼고, 실제 질문에 대한 검색 적중률과 답변 근거의 정확도를 비교하면서 크기와 오버랩을 조정하는 것이 좋습니다.기술 문서 확인: 2026-11-07 | 이 글의 수치와 코드는 출발점 및 예시이며, 실제 성능을 검증한 결과가 아닙니다.1. RAG에서 청킹이 중요한 이유RAG(Retrieval-Augmented Generation)는 문서에서 관련 내용을 검색해 LLM의 답변 생성에 참고시키는 구조입니다. 문서를 통째로 임베딩하면 서로 다른 ..
블록체인으로 회사의 문서관리와 전자결재 시스템을 구축할 수 있을까요? 가능합니다. 하지만 계약서·결재문서·첨부파일 전체를 블록체인에 저장하는 것은 대부분의 기업에서 비효율적입니다. 실무적으로는 문서 원본은 접근이 통제된 저장소에 보관하고, 누가 언제 어떤 문서를 승인·개정했는지에 관한 증거를 위변조 검증 가능한 감사 원장에 기록하는 하이브리드 구조가 더 적합합니다. 직원의 열람 권한, 전자서명, 수정 불가능한 승인본, 변경 이력은 각각 별도로 설계해야 합니다.작성·검증: 2026-11-06 | 기술 범위: DMS(문서관리), 전자결재, 감사 로그, WORM, 해시 체인, Hyperledger Fabric | 본문 예시는 범용 설계안이며 특정 기업의 실제 구축 결과가 아닙니다.1. 블록체인 전산화의 목표부..
FastAPI에서 async def와 def의 차이는 단순히 비동기 문법 사용 여부가 아니라, 요청 처리 중 블로킹 작업을 어디에서 실행하느냐입니다. await를 지원하는 HTTP·DB 클라이언트에는 async def를, 동기식 블로킹 라이브러리에는 일반 def 엔드포인트를 우선 고려하세요. async def 안에서 time.sleep()이나 동기 HTTP 요청을 그대로 실행하면 이벤트 루프를 막아 다른 요청까지 지연시킬 수 있습니다.기술 문서 확인일: 2026-11-06 | 기준: FastAPI·Starlette·Python 공식 문서 | 아래 예제는 교육용이며 실제 부하 테스트는 수행하지 않았습니다.1. FastAPI의 async def와 def는 어떻게 실행될까?FastAPI는 ASGI 기반 웹 프..
2026년 11월 5일 기준, 《승리의 여신: 니케》(NIKKE) PC 런처 해킹 사건은 운영사가 공식 확인한 보안 사고입니다. 런처가 불러오는 외부 스크립트가 변조돼 악성 프로그램 유포에 악용됐으며, 9월 27일 15시 41분 이후 Windows PC 런처를 한 번이라도 실행했다면 보안 점검이 권고됩니다. 운영사는 11월 5일 오전 8시부터 공식 PC 클라이언트에 검사·제거 기능을 제공하고 있습니다. 모바일 버전만 이용한 경우 이번 런처 사고의 영향 대상이 아닙니다.작성·팩트체크: 2026-11-05 (KST) | 사건 유형: PC 런처 공급망 침해·악성코드 유포 | 근거: 니케 운영팀 공식 공지 및 독립 기술 분석1. 니케 해킹 사건, 무엇이 실제로 발생했나?이번 사건을 단순한 '게임 서버 계정 해킹..
프롬프트 인젝션(Prompt Injection)은 LLM이 읽는 외부 문서나 웹페이지에 공격자가 명령을 숨겨, 원래 사용자의 요청과 다른 행동을 유도하는 공격입니다. RAG에서는 검색된 문서를 신뢰할 수 없는 데이터로 취급해야 하며, AI Agent에서는 모델이 제안한 도구 호출을 별도의 권한 검사로 통제해야 합니다. '이전 지시를 무시하라'는 문장을 차단하는 것만으로는 충분하지 않습니다.1. 프롬프트 인젝션과 일반 프롬프트의 차이일반 프롬프트는 사용자가 의도적으로 모델에 전달하는 요청입니다. 반면 프롬프트 인젝션은 모델이 참고자료로 읽어야 할 콘텐츠를 공격자가 지시문처럼 위장하는 것입니다. 핵심은 데이터와 명령 사이의 신뢰 경계가 무너지는 것입니다.2. RAG에서 공격은 어떻게 들어오는가?사용자가 '사..
Trigger.dev가 2026년 11월 1일 일부 조직의 환경변수에 공격자가 무단 접근한 보안 사고를 공개했습니다. 영향을 받은 계정 소유자에게 이메일로 대응 절차를 전달했으며, 공격에 사용된 취약 경로는 차단했다고 밝혔습니다. 영향을 받은 조직이라면 환경변수를 단순히 수정하는 것이 아니라 발급 기관에서 기존 API 키·토큰을 폐기하고 새 자격증명을 발급해야 합니다. 모든 고객이 영향을 받았다는 뜻은 아니며, 정확한 원인과 전체 영향 범위는 공개되지 않았습니다.작성일: 2026-11-04 | 공식 공지: 2026-11-01 | 대상: Trigger.dev 클라우드 사용자와 AI 워크플로 운영자1. Trigger.dev 보안 사고: 확인된 사실Trigger.dev는 TypeScript 기반 백그라운드 작..
pgvector에서 HNSW와 IVFFlat 중 무엇을 선택해야 할까요? RAG 검색의 응답 속도와 재현율(Recall)을 함께 고려한다면 일반적으로 HNSW부터 검토하는 것이 좋습니다. HNSW는 다층 그래프를 탐색해 속도·재현율 균형이 유리한 반면 인덱스 생성 시간과 메모리 사용량이 더 큽니다. IVFFlat은 벡터를 여러 목록(list)으로 묶어 일부만 검색하므로 인덱스 생성 비용이 상대적으로 낮지만, 데이터 분포·목록 수·탐색 범위(probes)에 민감합니다. 데이터가 작거나 필터 조건이 매우 선택적이면 근사 인덱스 없이 정확 검색(Exact Search)이 더 나을 수도 있습니다.자료 확인일: 2026-11-03 | 기준: pgvector 공식 README 및 CHANGELOG, PostgreS..
Gemini API의 Computer Use 도구가 2026년 10월 30일 정식 출시(GA)됐습니다. 개발자는 Gemini 모델이 화면을 보고 클릭·입력·스크롤 같은 UI 작업을 제안하도록 만들 수 있습니다. 다만 모델이 사용자의 PC를 직접 제어하는 구조는 아닙니다. 실제 브라우저·데스크톱 조작은 개발자가 구현한 실행기(예: Playwright)가 담당하며, 권한 제한과 사람의 승인 절차를 반드시 설계해야 합니다.작성 기준: 2026-11-02 | 공식 릴리스: 2026-10-30 | 대상: Gemini API 개발자1. Gemini Computer Use 정식 출시: 무엇이 달라졌나?Google Gemini API 릴리스 노트에 따르면 Computer Use 도구는 2026년 10월 30일 Inte..
Docker Compose에서 API 키와 데이터베이스 비밀번호를 안전하게 전달하려면 environment에 값을 직접 넣기보다 secrets를 사용하고, 애플리케이션이 /run/secrets/이름 파일을 읽도록 설계하는 편이 좋습니다. 다만 일반 Docker Compose의 파일 기반 시크릿은 Docker Swarm의 암호화된 시크릿 저장소와 동일하지 않습니다. 호스트 파일의 보안, 권한, 백업, 회전 정책까지 관리해야 합니다.기술 문서 확인: 2026-11-08 · 대상: Docker Compose를 사용하는 Linux 컨테이너 기반 개발·운영 환경 · 예제는 로컬 실행 및 부하 테스트를 수행하지 않았습니다.1. 왜 .env 파일만으로는 부족할까?.env는 Compose 설정값을 편리하게 관리하는 수..
RAG 청킹(Chunking)은 문서를 검색 가능한 작은 단위로 나누는 작업입니다. 좋은 청킹 전략은 무조건 잘게 자르는 것이 아니라, 질문에 답하는 데 필요한 문맥을 보존하면서 검색 결과에 불필요한 내용을 줄이는 것입니다. 처음에는 문단 중심의 재귀 분할을 기준선으로 삼고, 실제 질문에 대한 검색 적중률과 답변 근거의 정확도를 비교하면서 크기와 오버랩을 조정하는 것이 좋습니다.기술 문서 확인: 2026-11-07 | 이 글의 수치와 코드는 출발점 및 예시이며, 실제 성능을 검증한 결과가 아닙니다.1. RAG에서 청킹이 중요한 이유RAG(Retrieval-Augmented Generation)는 문서에서 관련 내용을 검색해 LLM의 답변 생성에 참고시키는 구조입니다. 문서를 통째로 임베딩하면 서로 다른 ..
블록체인으로 회사의 문서관리와 전자결재 시스템을 구축할 수 있을까요? 가능합니다. 하지만 계약서·결재문서·첨부파일 전체를 블록체인에 저장하는 것은 대부분의 기업에서 비효율적입니다. 실무적으로는 문서 원본은 접근이 통제된 저장소에 보관하고, 누가 언제 어떤 문서를 승인·개정했는지에 관한 증거를 위변조 검증 가능한 감사 원장에 기록하는 하이브리드 구조가 더 적합합니다. 직원의 열람 권한, 전자서명, 수정 불가능한 승인본, 변경 이력은 각각 별도로 설계해야 합니다.작성·검증: 2026-11-06 | 기술 범위: DMS(문서관리), 전자결재, 감사 로그, WORM, 해시 체인, Hyperledger Fabric | 본문 예시는 범용 설계안이며 특정 기업의 실제 구축 결과가 아닙니다.1. 블록체인 전산화의 목표부..
FastAPI에서 async def와 def의 차이는 단순히 비동기 문법 사용 여부가 아니라, 요청 처리 중 블로킹 작업을 어디에서 실행하느냐입니다. await를 지원하는 HTTP·DB 클라이언트에는 async def를, 동기식 블로킹 라이브러리에는 일반 def 엔드포인트를 우선 고려하세요. async def 안에서 time.sleep()이나 동기 HTTP 요청을 그대로 실행하면 이벤트 루프를 막아 다른 요청까지 지연시킬 수 있습니다.기술 문서 확인일: 2026-11-06 | 기준: FastAPI·Starlette·Python 공식 문서 | 아래 예제는 교육용이며 실제 부하 테스트는 수행하지 않았습니다.1. FastAPI의 async def와 def는 어떻게 실행될까?FastAPI는 ASGI 기반 웹 프..
2026년 11월 5일 기준, 《승리의 여신: 니케》(NIKKE) PC 런처 해킹 사건은 운영사가 공식 확인한 보안 사고입니다. 런처가 불러오는 외부 스크립트가 변조돼 악성 프로그램 유포에 악용됐으며, 9월 27일 15시 41분 이후 Windows PC 런처를 한 번이라도 실행했다면 보안 점검이 권고됩니다. 운영사는 11월 5일 오전 8시부터 공식 PC 클라이언트에 검사·제거 기능을 제공하고 있습니다. 모바일 버전만 이용한 경우 이번 런처 사고의 영향 대상이 아닙니다.작성·팩트체크: 2026-11-05 (KST) | 사건 유형: PC 런처 공급망 침해·악성코드 유포 | 근거: 니케 운영팀 공식 공지 및 독립 기술 분석1. 니케 해킹 사건, 무엇이 실제로 발생했나?이번 사건을 단순한 '게임 서버 계정 해킹..
프롬프트 인젝션(Prompt Injection)은 LLM이 읽는 외부 문서나 웹페이지에 공격자가 명령을 숨겨, 원래 사용자의 요청과 다른 행동을 유도하는 공격입니다. RAG에서는 검색된 문서를 신뢰할 수 없는 데이터로 취급해야 하며, AI Agent에서는 모델이 제안한 도구 호출을 별도의 권한 검사로 통제해야 합니다. '이전 지시를 무시하라'는 문장을 차단하는 것만으로는 충분하지 않습니다.1. 프롬프트 인젝션과 일반 프롬프트의 차이일반 프롬프트는 사용자가 의도적으로 모델에 전달하는 요청입니다. 반면 프롬프트 인젝션은 모델이 참고자료로 읽어야 할 콘텐츠를 공격자가 지시문처럼 위장하는 것입니다. 핵심은 데이터와 명령 사이의 신뢰 경계가 무너지는 것입니다.2. RAG에서 공격은 어떻게 들어오는가?사용자가 '사..
Trigger.dev가 2026년 11월 1일 일부 조직의 환경변수에 공격자가 무단 접근한 보안 사고를 공개했습니다. 영향을 받은 계정 소유자에게 이메일로 대응 절차를 전달했으며, 공격에 사용된 취약 경로는 차단했다고 밝혔습니다. 영향을 받은 조직이라면 환경변수를 단순히 수정하는 것이 아니라 발급 기관에서 기존 API 키·토큰을 폐기하고 새 자격증명을 발급해야 합니다. 모든 고객이 영향을 받았다는 뜻은 아니며, 정확한 원인과 전체 영향 범위는 공개되지 않았습니다.작성일: 2026-11-04 | 공식 공지: 2026-11-01 | 대상: Trigger.dev 클라우드 사용자와 AI 워크플로 운영자1. Trigger.dev 보안 사고: 확인된 사실Trigger.dev는 TypeScript 기반 백그라운드 작..
pgvector에서 HNSW와 IVFFlat 중 무엇을 선택해야 할까요? RAG 검색의 응답 속도와 재현율(Recall)을 함께 고려한다면 일반적으로 HNSW부터 검토하는 것이 좋습니다. HNSW는 다층 그래프를 탐색해 속도·재현율 균형이 유리한 반면 인덱스 생성 시간과 메모리 사용량이 더 큽니다. IVFFlat은 벡터를 여러 목록(list)으로 묶어 일부만 검색하므로 인덱스 생성 비용이 상대적으로 낮지만, 데이터 분포·목록 수·탐색 범위(probes)에 민감합니다. 데이터가 작거나 필터 조건이 매우 선택적이면 근사 인덱스 없이 정확 검색(Exact Search)이 더 나을 수도 있습니다.자료 확인일: 2026-11-03 | 기준: pgvector 공식 README 및 CHANGELOG, PostgreS..
Gemini API의 Computer Use 도구가 2026년 10월 30일 정식 출시(GA)됐습니다. 개발자는 Gemini 모델이 화면을 보고 클릭·입력·스크롤 같은 UI 작업을 제안하도록 만들 수 있습니다. 다만 모델이 사용자의 PC를 직접 제어하는 구조는 아닙니다. 실제 브라우저·데스크톱 조작은 개발자가 구현한 실행기(예: Playwright)가 담당하며, 권한 제한과 사람의 승인 절차를 반드시 설계해야 합니다.작성 기준: 2026-11-02 | 공식 릴리스: 2026-10-30 | 대상: Gemini API 개발자1. Gemini Computer Use 정식 출시: 무엇이 달라졌나?Google Gemini API 릴리스 노트에 따르면 Computer Use 도구는 2026년 10월 30일 Inte..
