일련의 정책은 호환성이 손상되는 변경, 알림, 릴리스 및 버전 관리와 관련된 데이터 API 작성기를 제어합니다.
버전 관리 및 릴리스
A release in the context of Data API builder refers to every published version of the software, identified by the Major.Minor.Patch format. These releases fall into three categories: stable, breaking change, and preview.
컨테이너 업데이트 책임
데이터 API 작성기 컨테이너는 자동으로 업데이트되지 않습니다. 고객은 새 릴리스를 모니터링하고, 중요도(보안 업데이트 포함)를 평가하고, 그에 따라 배포된 컨테이너를 업데이트할 책임이 있습니다.
Keeping the container up to date is the customer’s responsibility.
Stable releases
A stable version of Data API builder is backwards compatible. 이전 버전과 호환된다는 것은 데이터 API 작성기의 한 버전을 사용하는 모든 코드가 정확성 또는 기존 기능을 유지하기 위해 코드를 변경하지 않고도 안정적인 최신 버전을 채택할 수 있음을 의미합니다.
호환성이 손상되는 변경 릴리스
데이터 API 작성기의 호환성이 손상되는 변경 버전은 이전 버전과 호환되지 않습니다. 기존 클라이언트 코드에서 호환성이 손상되는 변경 버전을 채택하려면 이전 버전을 대상으로 할 때와 똑같이 클라이언트가 동작하도록 코드를 변경해야 할 수 있습니다.
호환성이 손상되는 변경 버전은 호환성이 손상되는 변경 목록 문서 및 GitHub 릴리스의 변경 설명에서 발표됩니다. 변경 내용이 중요한 보안, 개인 정보 보호 또는 법적 문제를 수정하지 않는 한 미리 보기/릴리스 후보 버전을 게시하면 호환성이 손상되는 변경 버전이 선행됩니다. 이전 버전의 Data API Builder는 GitHub 릴리스 페이지에서 계속 사용할 수 있지만 버그 수정이 포함될 수 있는 최신 릴리스로 업그레이드하는 것이 좋습니다.
Preview releases
데이터 API 작성기 미리 보기 릴리스는 버전 관리 체계로 X.Y.Z-rc 식별됩니다.
-rc 접미사는 빌드가 "릴리스 후보"임을 나타냅니다. 미리 보기 릴리스는 새로운 기능 및 기타 변경 내용에 대한 피드백을 수집하는 데 사용됩니다.
안정적인 마지막 버전에서 의도적으로 중요한 변경을 계획하지 않는 한 안정적인 최신 릴리스 및 새로운 미리 보기 기능의 모든 것을 사용하여 다음 미리 보기 버전을 게시합니다. 다음 데이터 API 작성기 업데이트는 미리 보기 버전 간에 추가한 새로운 미리 보기 기능 중 일부를 중단할 수 있습니다. 이 호환성이 손상되는 동작은 다시 작동하도록 코드를 변경해야 할 수 있음을 의미합니다.
미리 보기 버전은 장기 또는 프로덕션 사용을 위한 것이 아닙니다. 안정적인 새 또는 미리 보기 버전을 사용할 수 있게 되면 더 이상 이전 미리 보기 버전에 액세스할 수 없습니다. 새 기능을 적극적으로 사용하고 릴리스 직후 미리 보기가 아닌 버전으로 전환할 준비가 된 경우에만 미리 보기 버전을 사용하는 것이 가장 좋습니다. 미리 보기 버전의 일부 기능이 안정적인 새 버전에 포함된 경우 나머지 미리 보기 기능은 새 미리 보기 버전에 추가되어 사용해 볼 수 있습니다.
버전 변경 테이블
Important
변경 내용이 중요한 제품 버그, 법적, 보안 또는 개인 정보 보호 문제를 해결하는 경우 부 버전 또는 패치 릴리스에 호환성이 손상되는 변경이 도입될 수 있습니다.
| Release type | Previous Version | New Version | Notes |
|---|---|---|---|
| Breaking Change | 1.Y.Z |
2.Y.Z |
주요 변경 내용과 함께 새로운 기능 및 버그 수정 |
| Stable | 1.1.Z |
1.2.Z |
변경 내용이 중요한 제품 버그, 법적, 보안 또는 개인 정보 보호 문제를 해결하지 않는 한 새로운 기능 및 버그 수정은 호환성이 손상되지 않습니다. |
| Stable | 1.1.1 |
1.1.2 |
변경 내용이 중요한 제품 버그, 법적, 보안 또는 개인 정보 보호 문제를 해결하지 않는 한 새로운 기능이나 호환성이 손상되는 변경 없이 버그 수정 |
| Preview | X.Y.1-rc |
X.Y.2-rc |
새로운 미리 보기 기능 및 버그 수정. 주 버전이 충돌하면 호환성이 손상되는 변경 내용이 포함됩니다. |
Breaking Changes
보안 우선 순위를 지정하고, 기능을 향상시키고, 코드 품질을 유지하기 위해 소프트웨어의 새 버전에는 호환성이 손상되는 변경이 포함될 수 있습니다. 우리는 신중한 아키텍처 선택을 통해 이러한 변화를 최소화하기 위해 노력하지만, 여전히 발생할 수 있습니다. 이러한 경우 이를 알리고 가능한 솔루션을 제공하는 것이 최우선 과제입니다.
Important
변경 내용이 위반되지 않는 것으로 간주되거나 중요한 제품 버그 또는 법적, 보안 또는 개인 정보 보호 문제를 해결하기 위해 호환성이 손상되는 변경인 경우 사전 통지 없이 변경할 수 있습니다.
호환성이 손상되는 변경이란?
호환성이 손상되는 변경은 중단을 방지하기 위해 애플리케이션을 업데이트해야 하는 수정입니다. 데이터 API 작성기에서 호환성이 손상되는 변경에는 REST API 계약, GraphQL 스키마 생성 및 호환성 및 기능에 영향을 주는 기타 요소가 포함될 수 있습니다.
호환성이 손상되는 변경 예제
The following examples are a nonexhaustive list of breaking changes to Data API builder:
- REST API 계약 수정
- GraphQL 스키마 생성의 변경
- 이전 버전과의 호환성에 영향을 주는 변경 내용
- API 또는 매개 변수의 제거 또는 이름 바꾸기
- 오류 코드의 변경 내용
- 권한 정의 기능 조정
- 허용되는 매개 변수, 요청 필드 또는 응답 필드 제거
- 기본값이 없는 필수 매개 변수 또는 요청 필드 추가
- 의도한 API 엔드포인트 기능 수정
변경되지 않는 변경의 정의
A non-breaking change refers to a change that can be integrated into your application without causing disruption. 변경되지 않는 변경 내용은 일반적으로 구현 후에 전달됩니다. 애플리케이션은 사전 통지 없이 이러한 변경 내용을 처리하도록 설계되어야 합니다.
호환성이 손상되지 않는 변경 예제
The following examples are a nonexhaustive list of nonbreaking changes to Data API builder:
- 새 엔드포인트 소개
- 기존 엔드포인트에 메서드 추가
- 응답 및 요청에 새 필드 통합
- 응답 내 필드 순서 조정
- 선택적 요청 헤더 소개
- 데이터 길이 및 응답 크기 변경
- 오류 메시지 및 코드 변경
- HTTP 응답 코드 수정
- 생성된 OpenAPI 문서의 추가 메타데이터
호환성이 손상되는 변경 내용을 전달하려면 어떻게 해야 할까요?
주요 변경 내용에 대해 즉시 알리는 것이 우선입니다. GitHub의 Data API Builder 릴리스 릴리스 정보에서 호환성이 손상되는 변경 알림을 찾을 수 있습니다.
현재 호환성이 손상되는 변경 목록
주요 변경 내용 및 기능 사용 중지는 이 문서에서 발표됩니다.
- 현재 주요 변경 내용은 없습니다.