지원
버전 1.0.0-alpha.1최신
문서
Adverant Nexus 문서
릴리스 1.0.0-alpha.1. Nexus를 처음 사용하시는 경우 파트 1부터 시작하십시오. 파트 2는 설치 및 운영 담당자를 위한 내용입니다.
지식 모델 맵 탐색공유 코어와 각 도메인 팩, 그리고 해당 렌즈, 모듈 및 관계입니다.
파트 1: 모든 사용자를 위한 안내
- 1.1Nexus의 개요와 대상 사용자Harrow Port Authority를 예시로 들어 Adverant Nexus가 조직에서 하는 역할, 누구를 위해 만들어졌는지, 그리고 각 구성 요소가 어떻게 맞물려 작동하는지 알기 쉽게 설명합니다. 마지막으로 세 가지 에디션을 한 단락으로 요약합니다.
- 1.2Nexus와 함께하는 하루 일과Harrow Port Authority의 하루 일과를 Today 화면 확인부터 마지막 승인까지 따라가며, 사람들이 Nexus에서 실제로 어떤 일을 하고 각 업무가 어디에서 이루어지는지 보여줍니다.
- 1.3조직과 구성원, 그리고 비공개로 유지되는 영역Nexus가 조직과 구성원의 역할을 모델링하는 방식, Adverant 계정에서 구매 및 등록 권한을 가진 사람, 그리고 관리자가 볼 수 있는 영역과 개인에게 비공개로 유지되는 영역의 경계를 설명합니다.
- 1.4조직의 기준에 맞춘 AINexus가 조직 자체의 기준에 맞춰 인공지능(AI)을 사용하는 방식을 설명합니다. 조직이 자체 모델 키를 가져와 소유하고, 단일 스위치보드가 모든 모델 호출을 조직이 선택한 제공업체로 라우팅하며, 로컬 모델은 자체 서버에서 실행되고, 조직 모르게 Adverant로 전송되는 데이터는 없습니다.
- 1.5신뢰와 컴플라이언스컴플라이언스 담당자가 주로 사용하는 Nexus의 기능입니다. 감사 로그와 봉인된 기록, 두 번째 사람의 확인이 필요한 승인, 그리고 검토를 기다리는 인공지능(AI) 결정을 다룹니다. 마지막으로 개인정보 요청과 감사관이 요구하기 전에 증적을 미리 준비해 두는 컴플라이언스 페이지를 설명합니다.
- 1.6알기 쉽게 설명한 에디션과 라이선스Nexus의 세 가지 에디션과 그 위에 추가되는 19개의 애드온 및 도메인 팩, 그리고 기업에서 라이선스가 작동하는 방식을 설명합니다. 오프라인 확인과 각 라이선스 상태가 실제로 의미하는 바, 모든 라이선스가 지키는 약속, 그리고 재설치 없이 Community에서 Enterprise로 전환하는 방법을 다룹니다.
- 1.7도메인 팩과 버티컬특정 산업을 위해 도메인 팩이 Nexus에 추가하는 기능, Adverant가 제공하는 10가지 팩, 특정 사업부에 팩을 활성화하는 방법, 그리고 라이선스에서 팩이 필요로 하는 요건을 설명합니다.
- 1.8Nexus가 실행되는 환경Adverant의 EU 클라우드부터 인터넷이 없는 사이트 및 현장의 디바이스까지 Nexus가 실행될 수 있는 위치, 데이터 주권(Sovereignty)이 실제로 의미하는 바, 그리고 환경 선택 방법을 설명합니다.
- 1.9시작하기시작하기 전에 내려야 할 두 가지 결정, IT 팀이 수행하는 작업, 첫 번째 관리자가 보게 되는 초기 실행 화면, 그리고 첫날 준비해야 할 항목의 체크리스트를 설명합니다.
- 1.10자리를 비웠을 때모든 에디션에서 제공되는 콘솔의 모바일 레이아웃부터 네이티브 iPhone 및 Android 앱까지, 스마트폰에서 Nexus를 사용하는 방법을 설명합니다. 통신 신호 없이 작동하는 기능과 회사에서 스마트폰을 관리하는 방법을 다룹니다.
- 1.11조직에 맞게 맞춤 설정하기단일 설정부터 자체 버티컬 구축까지 조직이 Nexus를 맞춤 구성하는 방법을 설명합니다. 또한 개발자나 파트너에게 요구사항을 전달하는 방법과, 무엇을 구축하든 플랫폼이 보장하는 사항을 다룹니다.
- 1.12자주 묻는 질문비용이나 데이터 접근 권한 같은 민감한 질문을 포함하여 구매자, 관리자, 개인정보 보호 책임자가 가장 많이 묻는 질문에 대한 명확한 답변입니다.
파트 2: IT, DevOps 및 개발자를 위한 안내
- 2.1아키텍처Nexus 차트의 각 서비스가 담당하는 역할과 그 아래에 자리한 스토어, 그리고 서비스 간 ID부터 모든 모델 호출이 거치는 경로까지 이들을 하나로 묶어주는 규칙을 설명합니다.
- 2.2에디션의 내부 구조하나의 제품에서 Community와 Enterprise가 빌드되는 방식, 런타임에 라이선스가 기능 그룹을 활성화하는 방식, Community 설치 환경에서 Enterprise 페이지를 표시하는 방식, 그리고 이것이 풀(Pull)하는 이미지와 개발하는 확장 기능에 의미하는 바를 설명합니다.
- 2.3설치 계획하기명령어를 입력하기 전에 Nexus의 Kubernetes 설치에 필요한 사항, 설치 규모, 그리고 나중에 되돌릴 수 없는 두 가지 결정인 설치 이름과 키 관리자(Key custodian)를 설명합니다. 마지막으로 Harrow Port Authority의 작성된 계획 워크시트를 보여줍니다.
- 2.4릴리스 다운로드 및 검증Nexus 릴리스의 각 구성 요소가 위치한 곳, 풀 토큰(Pull token)으로 Enterprise 이미지를 가져오는 방법, 그리고 설치 전에 오프라인 상태에서 모든 이미지, 차트, 다운로드 파일이 변조 없이 Adverant에서 제공되었음을 증명하는 방법을 설명합니다.
- 2.5nexusctl을 이용한 사전 점검(Preflight)`nexusctl preflight`가 수행하는 모든 점검 항목, 각 항목이 읽는 대상과 실패 조건, 출력 및 저장되는 리포트, 해당 리포트가 콘솔의 사전 점검 페이지에 도달하는 방식, 그리고 모든 플래그를 설명합니다.
- 2.6Kubernetes에 Community 설치하기cert-manager부터 모든 워크로드가 준비될 때까지 Helm을 이용해 Community 에디션을 순서대로 설치하는 방법과 함께, 키별로 설명된 values 파일, --wait를 사용하지 않는 이유, 차트 훅(Hook)이 실행되는 순서, 그리고 대안으로서의 nexusctl 설치 경로를 설명합니다.
- 2.7Enterprise 설치 및 라이선스 적용Enterprise 에디션을 설치할 때 달라지는 점, Adverant 계정에서 라이선스를 요청하는 방법, 모든 거부 코드와 함께 라이선스를 가져오는 세 가지 방법, 그리고 Harrow Port Authority가 데이터 손실 없이 제자리에서 Community 파일럿을 Enterprise로 전환한 방법을 알아봅니다.
- 2.8단일 머신 설치nexusctl을 사용하여 단일 Linux 서버에 Nexus를 설치하거나, k3d를 사용하여 노트북에서 평가해 보고, 로그인 및 패스키가 작동하도록 HTTPS를 통해 콘솔에 접속합니다.
- 2.9설치 프로그램 디스크 이미지베어메탈 서버나 가상 머신을 Nexus 설치 프로그램 이미지로 부팅하면 네트워크 없이도 모든 파일을 사용하기 전에 검사하며 운영체제, k3s, cert-manager 및 Nexus를 설치합니다.
- 2.10에어갭 환경 설치서명된 오프라인 번들을 인터넷이 없는 사이트로 반입하여, 별도로 가져온 키로 검증한 뒤 자체 레지스트리에 로드하여 설치합니다. 라이선스, 업데이트 및 폐기 목록도 수동으로 에어갭을 통과합니다.
- 2.11변형 구성: 외부 저장소, TLS 및 인그레스초기 상태가 아닌 클러스터에 Nexus를 맞추는 값들로, TLS(전송 계층 보안)를 비롯해 이미 운영 중인 데이터베이스, 자체 인증서, 다른 인그레스 컨트롤러, 스토리지 클래스, 메일, 프록시, 레플리카 및 관리형 Kubernetes가 포함됩니다.
- 2.12첫 실행소유권이 등록되지 않은 설치 환경에서 사용자들이 업무를 시작하기까지의 과정입니다. 등록 코드를 생성하고, 브라우저에서 설치 환경의 소유권을 등록하고, 패스키로 첫 번째 관리자를 생성한 다음, 회사 로그인을 연결하고 다른 모든 사람을 초대합니다.
- 2.13라이선스Nexus 라이선스 파일에 담긴 내용, 설치 환경이 이를 오프라인에서 확인하는 방법, 라이선스가 가질 수 있는 여섯 가지 상태, 그리고 라이선스를 요청, 가져오기, 갱신 및 철회하는 방법을 알아봅니다.
- 2.14AI 제공자 및 모델인공지능(AI) 제공자 라우터가 조직 자체의 키 풀에서 모델을 선택하는 방법과 스크립트 및 AI 도구가 외부에서 Nexus에 도달하는 방법을 알아봅니다.
- 2.152일 차: Nexus 운영첫 주 이후 설치 환경을 운영하는 일상적인 작업입니다. 재시작 후 키 저장소의 봉인을 해제하는 것부터 시작하여 제거하는 것으로 끝납니다.
- 2.16보안 및 네트워킹설치 환경이 허용하는 인바운드 및 아웃바운드 트래픽, 서비스들이 서로에게 신원을 증명하는 방법, 그리고 운영자가 로그인 및 데이터베이스를 위해 설정하거나 상속받는 제어 항목을 알아봅니다.
- 2.17문제 해결운영자가 가장 자주 마주치는 문제들을 나타나는 증상별로 정리했습니다. 각 항목은 원인, 이를 확인하는 명령어, 해결 방법을 제시하며, 이 장은 지원 번들을 전송하는 것으로 마무리됩니다.
- 2.18확장 모델설정부터 도메인 팩까지 Nexus를 확장하는 여섯 가지 방법, 각 방법의 한계, 그리고 신뢰 및 격리 수준이 코드가 실행되는 위치를 결정하는 방식을 알아봅니다. 소프트웨어 개발 키트(SDK)를 열기 전에 읽어 보십시오.
- 2.19모든 확장 기능이 상속받는 규칙세 가지 축에서의 격리, UNO를 통한 컴퓨팅, 라우터를 통한 AI(인공지능), 조직 소유의 키 및 라이선스 확인입니다. 각 규칙이 코드에 의미하는 바와 어떤 게이트가 이를 강제하는지, 그리고 이를 직접 작성하는 대신 상속받는 이유를 알아봅니다.
- 2.20스킬Skills Engine 스킬을 작성, 테스트 및 게시하는 방법, 라이브 상태가 되었을 때 표시되는 위치, 그리고 플러그인의 매니페스트 스킬과 어떻게 다른지 알아봅니다. Harrow Port Authority의 선석 배정 요약 실제 사례가 포함되어 있습니다.
- 2.21Plugin SDKPlugin SDK(소프트웨어 개발 키트) 설치, 명령줄 도구, 풀 서비스 템플릿 둘러보기, 필드별 v2 매니페스트, 그리고 플러그인이 규칙을 준수하도록 하는 22개의 게이트를 알아봅니다.
- 2.22플러그인 런타임범위 가드와 데이터베이스 펜스부터 UNO 디스패치, AI(인공지능) 라우트 읽기 및 라이선스 확인에 이르기까지 플러그인이 실행되는 기반 SDK(소프트웨어 개발 키트) 모듈입니다. 그런 다음 실제 데이터베이스를 대상으로 한 테스트, 스킬 등록 및 온보딩을 다룹니다.
- 2.23도메인 팩도메인 팩의 구성 요소와 pack.json의 내용, 렌즈와 렌즈 레지스트리, 지식 모델, 커넥터 및 모바일 오버레이, 조직 단위에 대해 팩의 라이선스를 부여하고 활성화하는 방법, 그리고 Adverant가 기본 제공하는 10가지 팩을 알아봅니다.
- 2.24맞춤형 산업군 팩 엔드투엔드 빌드최초 기획안부터 모든 유닛에서 실행되는 릴리스까지, 지식 모델, 렌즈, 스킬, 풀서비스 플러그인 및 샘플 데이터를 갖춘 콜드체인 도메인 팩의 전체 빌드 과정을 살펴봅니다. 이어서 기존 팩을 확장하는 방법과 이미 배포된 팩에 렌즈를 추가하는 방법을 다룹니다.
- 2.25에디션별 빌드하나의 확장이 모든 에디션, 에어갭(망분리) 사이트, Nexus Edge 페이로드 또는 고객의 자체 브랜드 환경에서 작동해야 할 때 달라지는 점을 설명합니다. Enterprise 모듈의 라이선스 기준선과 서명된 오프라인 배포를 다루며, 각 대상별로 달리 수행해야 할 작업 매트릭스를 제공합니다.
- 2.26AI 코딩 도구로 구축하기Claude Code 및 기타 AI(인공지능) 코딩 도구를 사용하여 안전하게 Nexus 확장을 빌드하는 방법을 설명합니다. IDE(통합 개발 환경)를 Workbench에 연결하고 플랫폼 규칙을 담은 프로젝트 CLAUDE.md를 구성하는 것부터 시작하여, 여섯 가지 실제 프롬프트 예제와 각 결과를 검증하는 게이트로 마무리합니다.
- 2.27빌드 시나리오단일 스킬부터 에어갭 배포까지, 열세 가지 빌드를 담은 쿡북입니다. 각 레시피는 목표, 구성 요소, 단계 및 명령어, 작동을 증명하는 게이트, 그리고 에디션 및 배포 형태에 따라 달라지는 점을 제시합니다.
- 2.28확장 릴리스하기플러그인이나 팩이 정상 빌드 상태에서 이를 실행하는 유닛에 도달하고, 다시 회수되기까지의 과정을 설명합니다. 버전, 릴리스 검토, 채널 및 설치, 서명, 변경 승인, 배포 ID 레코드, 마이그레이션, 롤백 및 버전 폐기를 다룹니다.
부록: 참조
- A부록 A: Helm values 참조Nexus 차트가 허용하는 모든 키, 해당 유형, 허용 값 및 기본값입니다.
- B부록 B: 에디션 매트릭스각 기능을 포함하는 에디션, 애드온 또는 도메인 팩을 안내합니다.
- C부록 C: 오류 코드운영자나 개발자가 마주치는 모든 거부 코드와 그 의미, 그리고 조치 방법입니다.
- D부록 D: 서비스 및 포트차트가 실행하는 모든 서비스, 해당 포트 및 이를 구성하는 values 키입니다.
- E부록 E: 용어집두 파트에서 사용되는 용어를 알기 쉽게 설명합니다.
- F부록 F: 한눈에 보는 아키텍처전체 플랫폼, 오픈 코어 및 그 위에 라이선스가 부여되는 요소, Nexus를 실행하는 각 방식, 그리고 열 가지 도메인 팩 각각을 다이어그램 하나씩으로 보여줍니다.
- G부록 G: 데이터 사전 및 지식 모델모든 레코드의 필드와 각 도메인 팩의 구성 요소입니다.
다운로드(Download)
- Part 1, for everyone (PDF) (새 탭에서 열림) 18 MB
- Part 2, technical, with the appendices (PDF) (새 탭에서 열림) 40 MB
PDF는 영어로 제공됩니다.