API 계약 테스트 설명: 출시 전에 주요 변경 사항 파악

  1. 홈
  2. 블로그
  3. 테스트 자동화

테스트 자동화

API 계약 테스트 설명: 출시 전 주요 변경 사항 파악

한 팀이 API를 변경하면 다른 팀의 앱이 프로덕션까지 아무도 모르게 중단될 수 있습니다. 계약 테스트는 전체 시스템을 실행하지 않고도 양측이 여전히 동의하는지 확인합니다. 우리는 어떤 것이 소비자를 방해하는지 보여주기 위해 계약에 대해 다섯 가지 현실적인 API 변경 사항을 테스트했습니다.

읽는 시간 10분
API 계약 테스트 설명: 주요 변경 사항을 출시하기 전에 파악하세요.

핵심 요약

  • 계약은 API 제공자와 소비자 간에 합의된 요청 및 응답 형태입니다.
  • 계약 테스트 해당 계약을 기준으로 각 측면을 개별적으로 확인하므로 모든 서비스를 실행할 필요가 없습니다.
  • 확인 결과 필드 추가는 성공했지만 필드 이름 변경, 유형 변경 또는 열거형 값 추가에 실패했습니다.
  • 소비자 중심 계약은 주로 Pact를 사용하여 소비자가 실제로 사용하는 것만 테스트합니다.

주문 팀은 읽기가 더 좋기 때문에 total의 이름을 amount로 바꿉니다. 자체 테스트를 통과하고 배포됩니다. 10분 후 모바일 앱에는 모든 주문에 비용이 전혀 발생하지 않는 것으로 표시되고 송장 서비스가 중단됩니다. 각 팀은 자체 코드를 테스트했지만 누구도 팀 간의 합의를 테스트하지 않았습니다. 그 격차가 계약 테스트로 채워집니다.

우리는 JSON 스키마로 작은 계약을 구축하고 Python jsonschema 라이브러리(버전 4.26)를 사용하여 이에 대한 5개의 현실적인 공급자 응답을 확인했습니다. 아래 결과는 해당 실행에서 나온 것입니다. Pact 및 OpenAPI 도구는 해당 문서에 설명되어 있습니다. 이 기사에서는 실행하지 않았습니다.

테스트 서비스의 문제

많은 서비스 시스템에서 각 팀은 자체 서비스에 대한 단위 테스트와 API 테스트를 작성합니다. 이러한 테스트는 다른 서비스가 무엇을 보내고 기대하는지에 대한 팀 자체 아이디어를 사용하며 종종 모의 테스트로 사용됩니다. 공급자가 변경되면 소비자의 모의 객체는 여전히 이전 형태를 반환하므로 소비자의 테스트는 계속 통과됩니다. 불일치는 두 버전이 공유 환경이나 프로덕션에서 만나는 경우에만 발견됩니다. 전체 종단 간 테스트로 이를 포착할 수 있지만 느리고 취약하며 모든 것을 함께 배포해야 합니다.

계약 테스트란 무엇입니까?

계약 테스트는 API를 호출하는 소비자와 API를 제공하는 공급자라는 두 당사자가 통신 방법(엔드포인트, 메서드, 헤더, 요청 본문, 응답 필드, 유형 및 상태 코드)에 동의하는지 확인합니다. 계약은 기계가 읽을 수 있는 계약으로 기록됩니다. 그런 다음 각 측면은 자체적으로 계약에 대해 테스트됩니다. 즉, 소비자는 계약에서 구축된 모의 서비스에 대해 테스트되고 공급자는 실제 서비스에 대한 계약 요청을 재생하여 테스트됩니다.

다른 테스트 유형과 비교

테스트 유형 수표 다른 서비스를 실행해야 합니까?
단위 테스트 내부 논리 아니요
API/기능 테스트 한 서비스의 동작 보통은 그렇지 않다
계약 테스트 두 서비스 간의 합의 아니요
통합 테스트 함께하는 실제 서비스 예
엔드투엔드 테스트 전체 사용자 여정 응, 전부

계약 테스트는 테스트 피라미드에서 API 테스트와 통합 테스트 사이에 있습니다. 단위 테스트만큼 빠르지만 이전에 통합 환경이 필요했던 문제를 포착합니다.

우리가 실행한 계약 확인

다음은 JSON 스키마로 작성된 주문 응답에 대한 간단한 계약입니다.

contract = {
  "type": "object",
  "required": ["id", "status", "total"],
  "properties": {
    "id":     {"type": "integer"},
    "status": {"enum": ["paid", "pending", "refunded"]},
    "total":  {"type": "number", "minimum": 0}
  }
}

우리는 공급자 응답의 다섯 가지 버전을 검증했습니다.

v1 provider              PASS
v1 + new field           PASS
renamed total->amount    FAIL: 'total' is a required property
id as string             FAIL: '101' is not of type 'integer'
new status value         FAIL: 'on_hold' is not one of ['paid', 'pending', 'refunded']

currency 필드를 추가하는 것은 소비자가 자신이 모르는 필드를 무시하기 때문에 안전했습니다. total 이름 바꾸기, ID를 텍스트로 보내기, 새로운 상태 값 도입 등이 모두 계약을 위반했습니다. 이들 각각은 공급자의 자체 테스트를 통과했을 것입니다.

파괴적인 변화와 안전한 변화

변경 보통 깨지나요?
선택적 응답 필드 추가 아니요
새 엔드포인트 추가 아니요
응답 필드 제거 또는 이름 바꾸기 예
필드 유형 또는 형식 변경 예
선택적 요청 필드를 필수로 설정하세요. 예
응답에 새 열거형 값 추가 소비자가 가치를 엄격하게 다루는 경우가 많습니다.
상태 코드 또는 오류 형식 변경 예
입력 검증 강화 자주

열거형 케이스는 미묘합니다. on_hold을 추가하면 공급자에게는 무해해 보이지만 알려진 상태에 대해 switch 문이 있는 소비자는 충돌이 발생하거나 아무것도 표시되지 않을 수 있습니다. 잘 작성된 소비자는 알 수 없는 값을 우아하게 처리하고 계약은 그러한 기대를 명시적으로 만듭니다. 획기적인 변경이 불가피한 경우의 버전 관리 전략은 의미적 버전 관리 및 REST API 모범 사례를 참조하세요.

소비자 중심 계약

소비자 중심 계약 테스트에서 각 소비자는 제공자로부터 필요한 사항, 즉 요청 내용과 읽는 필드를 정확하게 기록합니다. 공급자는 모든 소비자의 계약을 충족해야 합니다. 이는 큰 장점이 있습니다. 공급자는 소비자가 사용하지 않는 모든 것을 자유롭게 변경하거나 제거할 수 있으며, 사용되는 것을 변경하면 어떤 소비자가 중단될지 정확히 알고 있습니다.

우리의 데모에서는 공급자 중심 스타일에 더 가까운 단일 스키마를 확인했습니다. 실제 소비자 중심 계약은 일반적으로 소비자가 실제로 읽는 필드만 나열하므로 아무도 사용하지 않는 필드는 오류 없이 제거될 수 있습니다.

팁: 계약서는 공급자가 반환하는 모든 것이 아니라 소비자에게 필요한 것을 설명해야 합니다. 모든 필드와 정확한 값을 고정하는 계약은 공급자 테스트의 깨지기 쉬운 복사본이 되어 무해한 변경에 실패하고 신뢰를 약화시킵니다.

Pact의 작동 방식

Pact는 다양한 언어에 대한 라이브러리를 갖춘 가장 널리 사용되는 소비자 중심 계약 도구입니다. 문서의 흐름은 다음과 같습니다.

  1. 소비자 테스트: 소비자의 단위 테스트는 Pact 모의 서버를 호출하여 예상되는 각 요청과 필요한 최소 응답을 선언합니다.
  2. Pact 파일: 이러한 기대치는 JSON 계약인 “Pact”로 저장됩니다.
  3. 공유: 계약이 Pact Broker 또는 PactFlow에 게시됩니다.
  4. 공급자 확인: 공급자의 CI는 모든 Pact를 가져오고 실제 공급자에 대해 각 요청을 재생한 다음 응답을 확인합니다.
  5. 배포할 수 있나요? 어느 쪽이든 배포하기 전에 함께 실행하려는 버전에 검증된 계약이 있는지 확인하는 검사가 이루어집니다.

“주문 101이 존재합니다”와 같은 공급자 상태를 통해 공급자는 각 상호 작용에 대한 테스트 데이터를 설정할 수 있습니다. Pact를 채택할 때 대부분의 팀이 노력을 기울이는 부분이 바로 여기입니다.

OpenAPI를 사용한 공급자 중심 계약

많은 팀은 다른 방향에서 시작합니다. 공급자는 OpenAPI 사양을 게시하고 테스트를 통해 실제 API가 해당 사양과 일치하는지 확인하고 소비자는 설명된 것만 사용하는지 확인합니다. 도구는 사양에 대한 실시간 응답을 검증하고, 여기에서 테스트를 생성하거나, 사양의 두 버전을 비교하고 주요 변경 사항을 표시할 수 있습니다. 이는 소비자 계약 수집이 불가능한 알 수 없는 소비자가 많은 공개 API에 적합합니다. 단점은 소비자가 실제로 의존하는 부분이 아니라 메시지의 문법을 확인한다는 것입니다.

CI의 계약 테스트

  • 소비자 파이프라인: 소비자 계약 테스트를 실행하고 모든 변경 사항에 대해 계약을 게시합니다.
  • 공급자 파이프라인: 모든 변경 사항에 대해 모든 소비자 계약을 확인합니다. 중단 시 빌드가 실패합니다.
  • 배포 전: 각 환경에 적용되는 정확한 버전 간의 호환성을 확인하세요.
  • 웹후크: 소비자가 변경된 계약을 게시하면 즉시 공급자의 확인을 트리거합니다.

이것을 CI/CD 파이프라인에 맞추면 “누군가를 망쳤습니까?”가 됩니다. 회의부터 빌드 상태까지.

함정

  • 과도한 지정: 유형 및 필수 필드 대신 정확한 값을 주장하면 계약이 불안정해집니다.
  • 계약을 기능 테스트로 처리: 계약은 비즈니스 정확성이 아니라 형태와 합의를 확인합니다. 기능 테스트도 계속하십시오.
  • 공급자 상태 건너뛰기: 현실적인 설정 데이터가 없으면 잘못된 이유로 확인이 통과됩니다.
  • 소유권 없음: 누군가가 브로커를 소유해야 하며 확인이 실패할 경우 응답해야 합니다.
  • 비동기 메시지 잊기: 대기열의 이벤트도 계약이며 Pact와 같은 도구는 메시지 계약을 지원합니다.

계약 테스트를 사용해야 하는 경우

여러 팀이 서로 호출하는 서비스를 소유하고, 배포가 독립적이며, 통합 환경이 느리거나 신뢰할 수 없는 경우 계약 테스트는 성과를 냅니다. 하나의 API와 하나의 프런트 엔드가 함께 배포된 단일 팀의 경우 좋은 API 테스트로 충분할 수 있습니다. 우리의 API 테스트 가이드는 그 시작점을 다루고 있습니다.

바다를 끓이지 않고 시작하기

  1. 한 쌍을 선택하세요. 통합이 가장 자주 중단되거나 가장 중요한 소비자와 공급자입니다.
  2. 두세 가지 주요 상호 작용에 대한 소비자의 기대치를 작성하고, 읽은 필드만 주장합니다.
  3. 제공자를 로컬에서 확인하여 올바른 이유로 통과할 때까지 제공자 상태를 수정합니다.
  4. CI에 양쪽을 추가하여 어느 팀이든 계약 위반 시 몇 분 안에 학습할 수 있습니다.
  5. 몇 주 후 검토: 무엇을 잡았는지, 놓친 부분이 있었나요? 그런 다음 다음 쌍으로 확장하십시오.

작게 시작하면 노력이 가시화되고 신뢰가 쌓입니다. 모든 서비스를 한 번에 계약하려고 하는 팀은 어떤 이점도 보기 전에 도구 및 테스트 데이터에 지체되는 경우가 많습니다.

마무리

계약 테스트는 각 팀의 자체 테스트에서 볼 수 없는 주요 변경 사항(이름이 변경된 필드, 변경된 유형 및 새로운 열거형 값)을 포착합니다. 하나의 중요한 소비자-공급자 쌍으로 시작하여 소비자가 실제로 사용하는 것에 초점을 맞춘 계약을 유지하고 CI에서 공급자를 확인하고 배포 확인을 추가합니다. 간단한 테스트에서는 5개의 그럴듯한 변경 사항 중 3개가 소비자를 망가뜨렸으며 공급자 자체 제품군에는 모두 보이지 않습니다.

자주 묻는 질문

API 계약 테스트란 무엇입니까?

모든 서비스를 함께 실행하는 대신 공유 계약을 기준으로 각 측면을 개별적으로 확인하여 API 제공자와 해당 소비자가 요청 및 응답 형식에 동의하는지 테스트합니다.

소비자 중심 계약 테스트란 무엇입니까?

각 소비자가 요청과 필요한 필드를 정의하는 접근 방식입니다. 공급자는 모든 소비자 계약에 대해 검증되므로 어떤 변경 사항이 누군가를 깨뜨릴지 알고 있습니다.

협약이란 무엇입니까?

Pact는 소비자 중심 계약 테스트를 위한 인기 있는 오픈 소스 도구입니다. 소비자 테스트는 계약 파일을 생성하며, 공급자는 이를 실제 구현과 비교하여 확인합니다.

필드를 추가하는 것이 주요 변경 사항인가요?

선택적 응답 필드를 추가하는 것은 일반적으로 안전합니다. 우리 테스트에서는 통과했습니다. 필드 유형의 이름을 바꾸거나 제거하거나 변경하면 소비자가 손상됩니다.

계약 테스트가 엔드투엔드 테스트를 대체합니까?

이는 특히 서비스가 대화할 수 있는지 확인하는 데에만 사용되는 많은 기능을 대체합니다. 중요한 사용자 여정에 대해 몇 가지 엔드투엔드 테스트를 유지하세요.

계속 학습하세요

Stack Quora와 작업

테스트, WordPress 또는 SEO에 도움이 필요하십니까?

우리는 팀이 더 나은 소프트웨어를 출시하고 사이트를 성장시킬 수 있도록 돕습니다. 현재 진행 중인 작업을 알려주시면 명확한 다음 단계를 제안해 드리겠습니다.

계속 읽으세요

추가 가이드 테스트, AI 및 최신 개발

이 기사가 마음에 드셨나요? 주제를 선택하고 최신 튜토리얼로 바로 이동하세요.

인공지능

RAG 청킹 전략 설명: 고정, 중복, 문장, 재귀 및 제목, 측정

tiktoken 0.14를 사용하여 하나의 문서에서 비교한 RAG 청킹 전략: 고정 크기, 겹침, 문장 패킹, 재귀 분할 및 제목 기반 청크, 분할 사실 측정, 고아 제목 및 저장 비용.

기사 읽기 →
소프트웨어 개발

API 멱등성 설명: 멱등성 키 및 안전한 재시도, 테스트됨

우리가 실행한 Python 서버와 클라이언트를 통해 API 멱등성을 설명했습니다. 응답이 손실되면 키 없이는 이중 요금이 부과되고 키 하나로는 단일 요금이 부과되며 키 재사용, 동시 재시도 및 저장 규칙도 발생합니다.

기사 읽기 →
DevOps

Git Stash 설명: 저장, 적용, 팝 및 추적되지 않은 파일, 테스트됨

Git stash는 Git 2.56에서 실행한 명령으로 설명되었습니다. 메시지 푸시, 추적되지 않은 파일, 나열 및 표시, 적용 대 팝, 인덱스 유지, 충돌, stash 분기, 삭제 및 지우기.

기사 읽기 →
소프트웨어 테스트

쌍별 테스트 설명: 모든 쌍이 216개의 테스트를 13개로 줄이는 방법, 테스트됨

Python 3.13에서 실행한 생성기로 쌍별 테스트를 설명했습니다. 13개 테스트로 처리된 216개 조합이 포함된 체크아웃, 검증된 적용 범위, 더 큰 예제 및 쌍별 버그가 누락될 수 있습니다.

기사 읽기 →
테스트 자동화

테스트 더블 설명: 테스트된 Python 코드를 사용한 Dummy, Stub, Spy, Mock 및 Fake

pytest 9.2에서 실행되는 하나의 Python 예제로 테스트 더블을 설명합니다. 더미, 스텁, 스파이, 모의 및 가짜, 각 사용 시기, 상태 대 동작 확인, 일반 Mock이 숨긴 자동 사양이 버그를 포착하는 방법.

기사 읽기 →
데이터베이스 및 SQL

SQL COALESCE 설명: 기본값, NULLIF, IFNULL 대 ISNULL 및 트랩, 테스트됨

SQL COALESCE는 SQLite 3.50에서 실행한 쿼리(null이 아닌 첫 번째 값, 빈 문자열, 수학의 NULL, 0으로 나누기 위한 NULLIF, 집계, LEFT JOIN 간격 및 IFNULL 대 ISNULL)로 설명되었습니다.

기사 읽기 →
데이터베이스 및 SQL

SQL 자체 조인 설명: 직원-관리자, 쌍 및 행 비교, 테스트됨

SQL 자체 조인은 SQLite 3.50에서 실행한 쿼리(직원 및 관리자, 관리자보다 더 많은 수익, 고유 쌍, 일일 변경 사항, 2홉 체인 및 인덱싱)로 설명됩니다.

기사 읽기 →
소프트웨어 개발

JavaScript 스프레드 연산자 설명: 스프레드와 나머지, 복사본 및 문제, 테스트됨

JavaScript 스프레드 연산자는 Node 24에서 실행한 코드(배열, 개체, 얕은 복사본, 나머지 매개변수, Math.max 제한 및 감소의 성능 트랩)로 설명되었습니다.

기사 읽기 →
소프트웨어 개발

Python 컬렉션 모듈 설명: Counter, defaultdict, deque 등, 테스트됨

Python 3.13에서 실행한 코드(Counter, defaultdict, deque, namestuple, OrderedDict 및 ChainMap, 목록과 deque 타이밍 및 치트 시트)로 Python 컬렉션을 설명했습니다.

기사 읽기 →
인공지능

LLM 컨텍스트 창 설명: 토큰, 한도 및 더 많이 맞추는 방법, 측정

LLM 컨텍스트 창은 tiktoken을 사용하여 측정한 토큰 수(산문, 코드 및 힌디어의 단어 대 토큰, 입력 및 출력 예산, 채팅 기록 트리밍, RAG 청크 및 비용)로 설명되었습니다.

기사 읽기 →
소프트웨어 개발

Webhooks 설명: 작동 방식 및 안전하게 수신하는 방법

Python에서 실행한 수신자 및 발신자에 대한 웹후크 설명: 푸시 대 폴링, HMAC-SHA256 서명, 변조 및 재생된 요청 거부, 백오프를 통한 재시도, 멱등성 및 테스트 팁.

기사 읽기 →
DevOps

Git Cherry-Pick 설명: 필요한 커밋을 안전하게 복사하고 테스트했습니다.

Git Cherry-Pick은 Git 2.56에서 실행한 명령(릴리스 브랜치에 핫픽스 복사, 새 해시 및 패치 ID, -x, -n, 커밋 범위, 충돌, –abort, –skip 및 이후 병합)을 설명했습니다.

기사 읽기 →
테스트 자동화

스냅샷 테스트 설명: 작동 방식, 도움이 되는 경우, 해를 끼치는 경우

스냅샷 테스트는 우리가 실행한 pytest 및 시럽 데모를 통해 설명되었습니다. 즉, 스냅샷 생성, 코드 변경 후 차이점 읽기, 타임스탬프 마스킹, 안전한 업데이트, 스냅샷이 도움이 되거나 해를 끼치는 경우 등이 있습니다.

기사 읽기 →
소프트웨어 테스트

돌연변이 테스트 설명: 100% 커버리지에서 여전히 버그를 놓친 이유

우리가 구축하고 실행한 작은 돌연변이 도구를 사용하여 돌연변이 테스트를 설명했습니다. 14개의 돌연변이, 79% 점수를 얻은 100% 라인 범위의 테스트 스위트, 100%에 도달한 경계 테스트, 도구, 비용 및 CI 팁이 포함됩니다.

기사 읽기 →
인공지능

프롬프트 삽입 설명: AI 앱이 속이는 방법과 이를 방어하는 방법

빌더를 위한 신속한 주입 설명: 직접 및 간접 공격, 키워드 필터가 실패하는 이유(테스트에서 4개 중 1개 차단), 최소 권한, 도구 허용 목록 및 출력 확인을 포함한 계층형 방어.

기사 읽기 →
DevOps

DNS 레코드 설명: 실제 조회를 통한 A, AAAA, CNAME, MX, TXT 및 TTL

우리가 실행한 조회를 통해 설명된 DNS 레코드: 확인 작동 방식, A 및 AAAA, CNAME 규칙, MX 및 null MX, SPF 및 확인을 위한 TXT, NS, TTL 및 캐싱, 안전한 DNS 변경.

기사 읽기 →
DevOps

기능 플래그 설명: 안전한 릴리스, 점진적 출시 및 플래그 위생

우리가 실행한 출시 시뮬레이션을 통해 설명된 기능 플래그: 플래그 유형, 안정적인 해싱을 사용한 출시 비율, 킬 스위치, 허용 목록, 두 경로 테스트, 플래그 부채 및 모범 사례.

기사 읽기 →
테스트 자동화

Python Faker를 사용한 테스트 데이터 생성: 현실적이고 반복 가능하며 안전한 데이터

Python Faker를 사용하여 데이터 생성을 테스트하고 실행하고 측정합니다. 반복 가능한 데이터, 로케일, 고유 값, 도메인 형태의 레코드, Faker가 놓친 엣지 케이스, 생산 데이터 마스킹 및 속도를 위한 시드입니다.

기사 읽기 →
소프트웨어 테스트

Shift-Left 테스트 설명: 팀 속도를 늦추지 않고 조기에 버그 찾기

Shift-Left 테스트 설명: 의미, 조기 결함이 더 저렴한 이유, 요구 사항 검토부터 CI 확인까지의 관행, 테스터의 역할 변경, 오른쪽 Shift, 메트릭 및 롤아웃 계획.

기사 읽기 →
데이터베이스 및 SQL

SQL 문자열 함수 설명: TRIM, SUBSTR, REPLACE, CONCAT 및 데이터 정리

우리가 실행한 쿼리로 설명된 SQL 문자열 함수: 연결 및 NULL, TRIM, UPPER 및 LOWER, SUBSTR 및 INSTR, REPLACE, 패딩, 유니코드 길이, 지저분한 데이터 정리 및 방언 차이.

기사 읽기 →
데이터베이스 및 SQL

SQL 트리거 설명: 트리거 전후, 감사 로그 및 함정

우리가 실행한 트리거(BEFORE vs AFTER, OLD 및 NEW, 감사 로그, 검증, 재고 업데이트, WHEN 조건, 롤백, 방언 차이 및 이를 피해야 하는 시기)로 설명된 SQL 트리거.

기사 읽기 →
소프트웨어 개발

Python JSON 모듈 설명: 덤프, 로드, 사용자 정의 유형 및 일반적인 오류

덤프 및 로드, 파일, 유형 변환, 날짜 및 소수점, 사용자 정의 인코더, object_hook, 부동 정밀도, 구문 분석 오류 및 JSON 라인 등 우리가 실행한 코드로 설명된 Python JSON 모듈입니다.

기사 읽기 →
소프트웨어 개발

ES 모듈과 CommonJS: Node.js에서 JavaScript 가져오기가 작동하는 방식, 테스트됨

ES 모듈과 CommonJS는 Node.js에서 실행한 코드(신택스 가져오기 및 내보내기, 필수, 라이브 바인딩, 캐싱, 최상위 대기, 동적 가져오기, 파일 확장자 및 상호 운용성)로 설명되었습니다.

기사 읽기 →
소프트웨어 개발

Python Regex 설명: 패턴, 그룹, 예측 및 함정, 테스트됨

Python 정규식은 검색 대 일치, findall, 그룹 및 명명된 그룹, 탐욕 대 게으른, 하위, 예측, 플래그, 유니코드 놀라움 및 치명적인 역추적 등 우리가 실행한 패턴으로 설명되었습니다.

기사 읽기 →
인공지능

LLM 구조화된 출력 설명: AI 모델에서 신뢰할 수 있는 JSON 얻기

Pydantic에서 실행한 검증(JSON 모드 및 스키마, 제한된 디코딩, 모델 출력 중단 방식, 재시도 루프 및 의미 체계 검사)을 통해 LLM 구조화된 출력을 설명했습니다.

기사 읽기 →
DevOps

SSH 키 설명: 작동 방식, ssh-keygen, Ed25519 및 안전한 습관

공개 키와 개인 키, ssh-keygen, Ed25519와 RSA, 지문, 암호, ssh-agent, Authorized_keys, 구성 파일, GitHub 및 키 위생 등 우리가 생성한 키로 SSH 키를 설명합니다.

기사 읽기 →
DevOps

HTTP 캐싱 설명: 실시간 테스트를 통한 캐시 제어, ETag 및 304 응답

우리가 실행한 소규모 서버를 통해 HTTP 캐싱을 설명했습니다. Cache-Control 지시문, max-age, 캐시 없음과 저장 없음, ETag 재검증 및 304 응답, CDN, 캐시 무효화 및 테스트 헤더.

기사 읽기 →
테스트 자동화

API 계약 테스트 설명: 출시 전에 주요 변경 사항 파악

API 계약 테스트는 우리가 실행한 스키마 검사를 통해 설명되었습니다. 계약이 무엇인지, 소비자 중심 계약, Pact, OpenAPI, 중단 소비자를 변경하는 방법, CI에 어떻게 적용되는지.

기사 읽기 →
소프트웨어 테스트

위험 기반 테스트 설명: 위험 점수 매기기, 매트릭스 구축 및 중요한 사항 테스트

위험 기반 테스트는 위험 식별, 가능성 및 영향 점수 매기기, 위험 매트릭스 구축, 위험을 테스트 깊이에 매핑, 실제 사례 및 일반적인 실수 등 단계별로 설명됩니다.

기사 읽기 →
데이터베이스 및 SQL

SQL 제약 조건 설명: NOT NULL, UNIQUE, CHECK 및 FOREIGN KEY, 테스트됨

우리가 실행한 테스트를 통해 설명된 SQL 제약 조건: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY 및 FOREIGN KEY, NULL 허점, SQLite의 외래 키 설정, 제약 조건 명명 및 테스트.

기사 읽기 →
데이터베이스 및 SQL

SQL 날짜 함수 설명: 버그 없이 날짜 추가, 비교 및 그룹화

우리가 실행한 쿼리로 설명된 SQL 날짜 함수: 간격 추가, 월말 놀라움, 날짜 차이, BETWEEN 트랩, 날짜별 그룹화, 시간대, 인덱스 및 방언 차이.

기사 읽기 →
소프트웨어 개발

Python asyncio 설명: 실시간 타이밍을 사용하는 비동기, 대기, 수집 및 작업 그룹

Python asyncio는 코루틴, 대기, 수집, 작업 그룹, 오류 처리, 시간 초과, 동시성 제한 및 성능을 저하시키는 호출 차단 실수 등 시간을 측정한 코드로 설명했습니다.

기사 읽기 →
소프트웨어 개발

JavaScript의 디바운스 및 스로틀: 작동 방식, 각 사용 시기, 테스트됨

JavaScript의 디바운스 대 스로틀은 Node.js에서 측정한 타이밍(각각의 작동 방식, 간단한 구현, 선행 및 후행 호출, 실제 사용 사례 및 테스트)을 설명합니다.

기사 읽기 →
소프트웨어 개발

Python 컨텍스트 관리자 설명: with 문, contextlib 및 실제 사용

Python 컨텍스트 관리자는 우리가 실행한 코드로 작동 방법, __enter__ 및 __exit__, contextlib.contextmanager, 억제, ExitStack, 데이터베이스 트랜잭션 및 일반적인 실수를 설명했습니다.

기사 읽기 →
인공지능

LLM 온도 및 Top-p 설명: AI 모델이 다음 단어를 선택하는 방법

LLM 온도와 top-p는 우리가 실행한 시뮬레이션을 통해 확률이 어떻게 재구성되는지, top-p가 유지하는 항목, 작업별 권장 설정, 결정론 및 AI 기능 테스트에 대해 설명했습니다.

기사 읽기 →
DevOps

YAML 설명: 구문, 노르웨이 문제 및 우리가 테스트한 기타 함정

YAML은 기본 구문, 목록 및 지도, 노르웨이 문제, 부동 소수점으로 변환되는 버전, 8진 우편번호, 60진수 시간, 앵커, 여러 줄 텍스트 및 안전 로딩 등 파서 테스트를 통해 설명되었습니다.

기사 읽기 →
DevOps

크론 작업 설명: 구문, 실제 일정 및 이를 깨뜨리는 실수

다섯 가지 필드, 연산자, 실제 예, 날짜 또는 요일 트랩, 환경 문제, 로깅, 중복 및 시간대 등 우리가 확인한 일정으로 Cron 작업을 설명했습니다.

기사 읽기 →
인공지능

AI 환각 설명: 언어 모델이 사물을 구성하는 이유와 이를 줄이는 방법

AI 환각은 그것이 무엇인지, 언어 모델이 환각을 생성하는 이유, 일반적인 유형, 접지 및 프롬프트를 통해 환각을 줄이는 방법, 그리고 우리가 실행한 간단한 점검에 대해 설명했습니다.

기사 읽기 →
DevOps

환경 변수 설명: .env 파일, 비밀 및 구성이 올바르게 완료되었습니다.

우리가 실행한 Python 예제를 통해 설명된 환경 변수: 읽기 및 설정, 모든 값이 문자열인 이유, .env 파일, 프로세스 상속, 비밀 및 유효성 검사.

기사 읽기 →
소프트웨어 개발

API 속도 제한 설명: 알고리즘, 헤더 및 429 오류 처리

우리가 실행한 시뮬레이션을 통해 설명된 API 속도 제한: 토큰 버킷, 고정 창, 슬라이딩 창, 429 응답, 속도 제한 헤더, 백오프를 사용한 재시도 및 테스트 제한.

기사 읽기 →
테스트 자동화

Python에서 조롱: unittest.mock, 패치 및 테스트를 거짓말로 만드는 실수

Unittest.mock을 사용하여 Python에서 모의, 테스트됨: 모의 및 return_value, 부작용, 이름이 사용되는 패치, 사양 및 자동 사양, 모의 날짜 및 일반적인 실수.

기사 읽기 →
소프트웨어 테스트

코드 커버리지 설명: 회선 커버리지와 분기 커버리지 및 100%의 실제 의미

실제 Coverage.py 실행을 통해 설명되는 코드 적용 범위: 라인, 분기 및 조건 적용 범위, 보고서 읽기, 100% 적용 범위가 여전히 버그를 놓칠 수 있는 이유 및 합리적인 대상.

기사 읽기 →
데이터베이스 및 SQL

SQL의 DELETE vs TRUNCATE vs DROP: 차이점, 롤백 및 사용 시기

테스트된 SQL을 통해 DELETE 대 TRUNCATE 대 DROP에 대해 설명합니다. 각각의 제거, 롤백, 트리거, ID 재설정, 속도 및 PostgreSQL, MySQL, SQL Server 및 SQLite의 차이점.

기사 읽기 →
데이터베이스 및 SQL

SQL 뷰 설명: 예제를 통해 함정 생성, 사용 및 방지

우리가 실행한 쿼리로 설명된 SQL 뷰: 뷰 생성, 실시간 결과, 열 숨기기, 성능, 업데이트 가능하고 구체화된 뷰, 손상된 종속성 및 모범 사례.

기사 읽기 →
소프트웨어 개발

TypeScript 인터페이스와 유형: 실제 차이점, 컴파일러로 테스트

TypeScript 인터페이스 대 유형, 실제 컴파일러로 확인: 둘 다 할 수 있는 것, 하나만 할 수 있는 것, 선언 병합, 확장 대 교차점 및 따라야 할 간단한 규칙.

기사 읽기 →
소프트웨어 개발

Python *args 및 **kwargs 설명: 명확한 예가 포함된 유연한 함수

Python *args 및 **kwargs는 우리가 실행한 코드(패킹 및 언패킹, 매개변수 순서, 키워드 전용 및 위치 전용 인수, 데코레이터 및 일반적인 오류)를 설명했습니다.

기사 읽기 →
소프트웨어 개발

Python Lambda 함수: 구문, 실제 사용 및 사용하지 말아야 할 경우

Python 람다 함수는 구문, 키를 사용한 정렬, 맵 및 필터, 클로저, 후기 바인딩 트랩, 일반 def가 더 나은 선택인 경우 등 우리가 실행한 코드로 설명되었습니다.

기사 읽기 →
인공지능

AI 에이전트란 ​​무엇입니까? 작동 방식, 간단한 에이전트 루프를 사용하여 실행할 수 있음

AI 에이전트란 무엇입니까? 우리가 실행한 작은 Python 루프, 실제 위험 및 간단한 챗봇이 더 나은 선택일 때 에이전트 루프, 도구, 메모리 및 가드레일에 대한 일반 가이드입니다.

기사 읽기 →
DevOps

모니터링과 관찰 가능성: 로그, 지표, 추적을 통한 실제 차이점

모니터링과 관찰 가능성 설명: 알려진 오류와 알려지지 않은 오류, 로그, 지표 및 추적, 결제 사건 안내, 골든 신호, OpenTelemetry 및 유용한 경고.

기사 읽기 →
DevOps

Docker 볼륨과 바인딩 마운트: 컨테이너 데이터를 올바른 방식으로 유지

Docker 볼륨과 바인드 마운트 설명: 컨테이너 데이터가 사라지는 이유, 명명된 볼륨, 바인드 마운트, tmpfs, Compose 예제, 백업, 권한 및 각 사용 시기.

기사 읽기 →
테스트 자동화

TDD와 BDD: 주요 차이점, 두 가지 방식으로 구축된 하나의 기능 및 각 사용 시기

TDD와 BDD는 두 가지 방식으로 구축된 하나의 할인 기능, 즉 우리가 실행한 코드를 사용한 적록 리팩토링, 주어진 시점 시나리오, 도구, 장단점 및 각 사용 시기를 설명합니다.

기사 읽기 →
소프트웨어 테스트

UAT(사용자 승인 테스트): 프로세스, 체크리스트 및 실제 사례

사용자 승인 테스트는 누가 실행하는지, QA와 어떻게 다른지, 7단계 프로세스, UAT 테스트 사례 템플릿, 체크리스트, 승인 기준 및 일반적인 실수에 대해 설명했습니다.

기사 읽기 →
데이터베이스 및 SQL

SQL NULL 값 설명: IS NULL, COALESCE, NULLIF 및 피해야 할 함정

우리가 실행한 쿼리를 통해 설명된 SQL NULL 값: 3개 값 논리, IS NULL, COALESCE, NULLIF, 집계, 조인 및 정렬이 NULL을 처리하는 방법 및 조용히 발생하는 버그.

기사 읽기 →
데이터베이스 및 SQL

SQL CASE WHEN 문: 구문, 실제 예 및 일반적인 실수

우리가 실행한 쿼리로 설명된 SQL CASE: 단순 및 검색 양식, 조건 순서, SUM이 있는 피벗, COUNT 트릭, 사용자 정의 정렬, 업데이트 및 피해야 할 NULL 트랩.

기사 읽기 →
소프트웨어 개발

JWT란 무엇입니까? 실제 예제로 설명되는 JSON 웹 토큰

JWT란 무엇입니까? JSON 웹 토큰은 세 부분, 즉 우리가 실행한 코드에서 구축 및 변조된 토큰, JWT 대 세션, 저장소, 새로 고침 토큰 및 보안 실수를 설명했습니다.

기사 읽기 →
소프트웨어 개발

JavaScript 이벤트 루프 설명: 예제가 포함된 호출 스택, 마이크로태스크 및 타이머

호출 스택, 작업 및 마이크로태스크 대기열, setTimeout 0이 즉시 실행되지 않는 이유, 차단, 기아 및 인터뷰 퀴즈 등 우리가 실행한 코드로 JavaScript 이벤트 루프를 설명했습니다.

기사 읽기 →
소프트웨어 개발

Python 생성기 및 수율 설명: 실제 예제로 메모리 절약

Python 생성기와 항복은 우리가 실행한 코드로 설명됩니다. 일시 중지 및 재개 방법, 측정된 메모리 절약, 파이프라인, 무한 시퀀스, 항복, 전송 및 공통 트랩.

기사 읽기 →
인공지능

임베딩이란 무엇입니까? 벡터와 코사인 유사성을 간단하게 설명

임베딩이란 무엇입니까? 벡터, 코사인 유사성 및 의미론적 검색에 대한 일반 언어 가이드로, 우리가 실행한 작은 예, 일반적인 용도, 모델 선택 및 알려진 한계를 제공합니다.

기사 읽기 →
DevOps

블루-그린 배포와 카나리아 배포: 차이점, 장단점 및 선택 방법

블루-그린 배포와 카나리아 배포에 대한 설명: 각각의 작동 방식, 비용, 위험 및 롤백, 테스트한 안정적인 사용자 버킷팅, 데이터베이스 마이그레이션, 롤링 업데이트 및 선택 방법.

기사 읽기 →
테스트 자동화

불안정한 테스트: 원인과 해결 방법

우리가 실행한 데모를 통해 불안정한 테스트에 대해 설명했습니다. 주요 원인, 확인 및 진단 방법, 시기, 공유 상태 및 날짜, 격리 프로세스에 대한 적절한 수정 사항.

기사 읽기 →
소프트웨어 테스트

부하 테스트와 스트레스 테스트 비교: 차이점, 측정항목 및 k6 예

부하 테스트와 스트레스 테스트 비교 설명: 각각의 증명, 스파이크 및 흡수 테스트, 중요한 측정항목, 평균이 잘못된 이유, k6 예 및 테스트 계획 방법.

기사 읽기 →
소프트웨어 테스트

테스트 케이스와 테스트 시나리오: 주요 차이점, 예 및 각각의 사용 시기

테스트 케이스와 테스트 시나리오 설명: 명확한 정의, 병렬 테이블, 시나리오에서 케이스로 가져온 하나의 비밀번호 재설정 기능, 템플릿 및 각 사용 시기.

기사 읽기 →
데이터베이스 및 SQL

SQL 쿼리 최적화: 타이밍에 따라 실행 계획을 읽고 느린 쿼리를 수정합니다.

백만 개의 행에서 테스트된 SQL 쿼리 최적화: 실행 계획 읽기, 올바른 인덱스 추가, 분할할 수 없는 필터 수정, 복합 인덱스 및 키 세트 페이지 매김 사용.

기사 읽기 →
데이터베이스 및 SQL

SQL UNION 대 UNION ALL: 테스트된 차이점, 예 및 성능

SQL UNION과 UNION ALL은 우리가 실행한 쿼리(중복, 둘 다 따르는 규칙, 실제 데이터 버그, 측정된 성능, INTERSECT 및 EXCEPT, 각각의 사용 시기)를 설명합니다.

기사 읽기 →
소프트웨어 개발

JavaScript Fetch API 튜토리얼: GET, POST, 오류 처리 및 시간 초과

로컬 서버에 대해 테스트된 JavaScript Fetch API 튜토리얼: GET 및 POST, 404가 발생하지 않는 이유, 재사용 가능한 도우미, 쿼리 문자열, 시간 초과, CORS 및 일반적인 실수.

기사 읽기 →
소프트웨어 개발

Python 파일 처리: 읽기, 쓰기, CSV, JSON 및 pathlib 예제 포함

우리가 실행한 코드로 설명된 Python 파일 처리: 개방형 모드, 대용량 파일 읽기, CSV, JSON, pathlib, 바이너리 파일, 안전한 쓰기, 오류 처리 및 일반적인 실수.

기사 읽기 →
소프트웨어 개발

Python 클래스 및 객체: 실제 예제가 포함된 OOP 튜토리얼

우리가 실행한 코드로 설명된 Python 클래스와 객체: __init__, 메소드, 클래스 대 인스턴스 속성, 상속, 속성, 던더 메소드, 데이터 클래스 및 일반적인 실수.

기사 읽기 →
인공지능

대규모 언어 모델이란 무엇입니까? LLM의 작동 방식, 과대광고 없이 설명

대규모 언어 모델이란 무엇입니까? LLM은 토큰, 임베딩, 주의, 훈련, 온도 및 컨텍스트 창, 작은 다음 단어 데모 및 실제 한계 등 일반 언어로 설명됩니다.

기사 읽기 →
DevOps

초보자를 위한 Linux 명령: 예제가 포함된 필수 터미널 가이드

탐색, 파일, 로그 보기, grep, 파이프, 권한, 프로세스 및 아카이브 등 작업별로 그룹화된 초보자를 위한 Linux 명령과 실용적인 로그 분석 예제가 포함되어 있습니다.

기사 읽기 →
테스트 자동화

셀레늄 대 극작가: 주요 차이점, 코드 비교 및 선택할 항목

Selenium과 Playwright 비교: 아키텍처, 대기, 브라우저 및 언어 지원, 디버깅, 두 도구 모두에서 동일한 테스트, 마이그레이션 조언 및 선택 방법.

기사 읽기 →
소프트웨어 테스트

등가 분할: 실제 예제를 통해 설명되는 테스트 설계 기법

등가 분할 설명: 유효한 파티션과 유효하지 않은 파티션을 찾는 방법, 연령, 비밀번호 및 쿠폰에 대한 작업 예제, 실행한 테스트, 경계와 쌍을 이루는 이유.

기사 읽기 →
소프트웨어 테스트

소프트웨어 테스팅의 심각도와 우선순위: 차이점, 매트릭스 및 실제 사례

소프트웨어 테스팅의 심각도와 우선순위에 대한 설명: 명확한 정의, 예제가 포함된 4방향 매트릭스, 수준 척도, 각 항목을 설정하는 사람 및 버그 분류 실행 방법.

기사 읽기 →
데이터베이스 및 SQL

SQL 하위 쿼리 자습서: 유형, 상관 하위 쿼리 및 EXISTS(예제 포함)

스칼라, IN, FROM 및 SELECT 하위 쿼리, 상관 하위 쿼리, EXISTS, NOT IN NULL 트랩 및 하위 쿼리 대 JOIN 대 CTE 등 우리가 실행한 쿼리가 포함된 SQL 하위 쿼리 자습서입니다.

기사 읽기 →
데이터베이스 및 SQL

SQL 트랜잭션 및 ACID 설명: COMMIT, ROLLBACK 및 격리 수준

COMMIT, ROLLBACK, 저장점, 잠금, 격리 수준, 더티 읽기, 교착 상태 및 모범 사례 등 우리가 실행한 은행 이체를 통해 SQL 트랜잭션 및 ACID를 설명했습니다.

기사 읽기 →
소프트웨어 개발

Git 명령 치트 시트: 실제로 사용하는 명령과 예제

실제 데모 저장소의 출력과 함께 설정, 준비, 분기, 원격, 숨김, 기록 및 실행 취소 실수 등 작업별로 그룹화된 Git 명령 치트 시트입니다.

기사 읽기 →
소프트웨어 개발

JavaScript Promises 설명: then, catch, Promise.all 및 일반적인 실수

우리가 실행한 코드로 설명된 JavaScript Promise: 상태, then 및 catch 체인, 오류 처리, Promise.all, allSettled, race 및 기타, 이벤트 루프 및 일반적인 실수.

기사 읽기 →
소프트웨어 개발

Python 사전 튜토리얼: 방법, 예제 및 일반적인 패턴

우리가 실행한 코드가 포함된 Python 사전 튜토리얼: 사전 생성, 읽기 및 업데이트, 주요 방법, 병합, 이해, 패턴 계산 및 그룹화, 일반적인 실수.

기사 읽기 →
인공지능

RAG 란 무엇입니까? 실제 예제를 통해 설명되는 검색 증강 생성

RAG란 무엇인가요? 검색 증강 생성은 인덱싱, 청킹, 임베딩, 검색, 소규모로 작동하는 Python 예제, 평가 및 일반적인 실패 등 단계별로 설명됩니다.

기사 읽기 →
DevOps

초보자를 위한 Terraform 튜토리얼: 첫 번째 파일부터 모듈까지 코드로서의 인프라

초보자를 위한 Terraform 튜토리얼: 클라우드 계정 없이 시작하여 초기화, 계획 및 적용을 배우고 변수, 출력, 상태, 모듈 및 안전한 팀 워크플로를 학습합니다.

기사 읽기 →
DevOps

Docker와 Kubernetes: 주요 차이점, 함께 작동하는 방식 및 필요한 사항

Docker와 Kubernetes에 대한 설명: 각각의 기능, 동일한 앱이 두 가지 모두에서 실행됨, Docker Compose와 Swarm 비교, dockershim 변경 사항 및 필요한 사항을 결정하는 방법.

기사 읽기 →
테스트 자동화

초보자를 위한 Pytest 튜토리얼: 고정 장치, 매개변수화 및 실제 예제

pytest 9.2에서 실행한 테스트(어설션, 픽스쳐, 매개변수화, conftest, 마커, tmp_path, Monkeypatch, 유용한 플래그 및 CI)가 포함된 초보자를 위한 pytest 튜토리얼입니다.

기사 읽기 →
소프트웨어 테스트

소프트웨어 테스팅 라이프사이클(STLC): 6단계, 시작 및 종료 기준, 예

소프트웨어 테스팅 수명주기는 시작 및 종료 기준, 결과물, 작업된 로그인 기능 예, STLC 대 SDLC 및 Agile의 STLC를 포함하는 6개의 STLC 단계를 설명합니다.

기사 읽기 →
소프트웨어 개발

Git merge vs rebase: 차이점, 예제, 언제 무엇을 쓸까

Git merge vs rebase를 실제 로그 출력, 비교표, rebase의 황금률, 안전한 팀 워크플로로 설명합니다.

기사 읽기 →
소프트웨어 개발

파이썬 리스트 컴프리헨션: 문법, 예제, 피해야 할 때

파이썬 리스트 컴프리헨션 설명: 문법, 필터링, if-else, 중첩 반복문, 실제 측정 시간, 그리고 일반 for 반복문이 더 나은 경우.

기사 읽기 →
데이터베이스 및 SQL

예제로 쉽게 배우는 SQL JOIN (Inner, Left, Right, Full)

샘플 테이블과 쿼리로 SQL JOIN을 단계별로 이해하세요. INNER, LEFT, RIGHT, FULL, CROSS, SELF와 흔한 실수, 성능 팁까지 정리했습니다.

기사 읽기 →