docs(supply-chain): fold the server delivery page into the SBOM creation guide - #300
Merged
Conversation
…ion guide The server page held only four things the creation guide did not, about 25 lines in total, and the rest restated the creation guide's tool selection and Syft sections. Keeping the two apart made them drift instead. - creation-guide: add a "server delivery" section holding the two-layer scan, statically linked libraries, and the merge step; shrink the tool selection paragraphs to a fork plus an anchor; drop the server paragraph duplicated at the end of the Syft section - submission: add a submission unit section carrying the cluster and multi-node rule, which is a submission rule rather than a generation step, and renumber the sections - skt-scanner: link the BomLens server delivery document from the reference table - delete server-delivery.md and redirect its URL to the creation guide with a front matter alias - repoint the eleven inbound links in the supplier index, checklist, rejection reasons, commercial software, and creation guide
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
서버(OS + 애플리케이션) SBOM 생성페이지를 없애고 내용을오픈소스 도구를 활용한 SBOM 생성과SBOM 제출 절차로 옮깁니다.배경
서버 페이지에만 있던 내용은 네 가지, 25줄 남짓이었습니다. 나머지는 생성 방법 페이지의 도구 선택 절과 Syft 절을 다시 서술한 것이었습니다. 두 페이지를 따로 두다 보니 같은 이야기가 두 곳에 있어 계속 어긋났습니다. 실제로 서버 페이지가 "일반 애플리케이션 납품이라면 생성 방법만으로 충분하다"고 안내하는 동안, 생성 방법 페이지는 서버·VM 이미지까지 다루고 있었습니다.
옮긴 곳
성격에 따라 나눴습니다.
SBOM 생성 방법의서버 납품절제출 절차의제출 단위절. 생성 방법이 아니라 제품당 SBOM 하나라는 제출 규칙이고, 상용 소프트웨어 공급 페이지도 이 내용을 참조하고 있어 생성 방법 안에 두면 상용 완제품 공급사가 엉뚱한 페이지로 가게 됩니다.그 밖의 변경
server-delivery.md를 삭제하고 front matteraliases로 옛 URL을 생성 방법 페이지로 넘깁니다.제출 절차의 절 번호를 재조정했습니다(제출 단위, 제출 시기, 제출 방법, 제출 후 검증).스캔 대상 서술
두 층으로 나눠 스캔하는 서술을 유지했습니다. Syft로 rootfs를 스캔하면 OS 패키지와 함께 파일로 설치된 파이썬·Node.js 의존성은 딸려 오지만, C/C++처럼 소스에 라이브러리를 포함하는 경우는 전혀 식별되지 않습니다. 실제 반려는 모두 누락 방향이라, 두 층을 명시적으로 확인하게 하는 편이 안전합니다. 이 단서를 새 절에 한 문장으로 적었습니다.
확인
hugo빌드 통과/guide/.../server-delivery/,/en/guide/.../server-delivery/)가 생성 방법 페이지로 리다이렉트되는 것 확인server-delivery잔여 참조 없음(앵커와 alias, BomLens 외부 링크 제외)한국어와 영어 양쪽에 같은 내용을 반영했습니다.