개인 기술 레지스트리

개인 기술 레지스트리를 통해 기술을 발행하여 다른 작업 공간에서 설치하도록 할 수 있고, 버전 및 승인 상태를 추적하며, 조직 전체에서 사용을 모니터링할 수 있습니다.

레지스트리 사용 시기

기술 레지스트리 사용 대상:

• 조직 내 다른 작업 공간과 기술 공유
• 팀이 사용하기 전에 기술 버전 관리 및 승인
• 어떤 기술이 인기 있거나 미사용인지 추적
• 내부 도구 및 도우미의 선별된 라이브러리 제공

자신의 작업 공간을 위해서만 기술을 만드는 경우, 레지스트리가 필요하지 않습니다. 직접 만드세요.

기술 가시성

각 기술에는 누가 볼 수 있고 설치할 수 있는지를 결정하는 가시성 설정이 있습니다:

기술을 생성할 때, private으로 시작합니다.

기술 버전 발행

기술이 안정적이면, 불변의 스냅샷을 생성하기 위해 발행할 수 있으며, 이는 검토 및 설치 가능합니다:

1. 기술에서 기술 열기
2. 발행 클릭(또는 더 이전 버전이 있으면 새 버전 발행)
3. 변경 로그 채우기 — 새로운 내용이나 변경 사항 설명
4. 발행 클릭

기술이 이제 pending_review 상태입니다. 작업 공간 관리자 또는 승인자가 이를 검토하고 승인할 수 있습니다.

발행이 버전을 생성합니다:

• 버전 1 — 첫 번째 발행된 버전
• 버전 2 — 변경 후 다음 발행
• 버전 3, 4 등

각 버전은 불변입니다 — 발행된 버전을 편집할 수 없습니다. 변경하려면 초안 기술을 편집하고 새 버전을 발행합니다.

승인 워크플로우

발행된 기술은 승인 워크플로우를 따릅니다:

1. 작성자가 발행

작성자가 발행을 클릭하면 기술이 pending_review로 이동합니다.

2. 검토자가 승인 또는 거부

작업 공간 관리자 또는 검토자는:

• 승인 — 기술이 approved로 이동하고 다른 작업 공간에서 설치 가능
• 거부 — 기술이 초안 상태로 유지; 작성자가 변경 사항을 만들고 재제출 가능

기술을 검토하려면:

1. 기술 → 대기 중인 검토로 이동
2. 기술을 클릭
3. 코드 및 변경 로그 검토
4. 승인 또는 거부 클릭

3. 승인된 기술을 설치 가능

승인 후 다른 작업 공간에서 기술 → 레지스트리에 기술을 보고 설치할 수 있습니다.

기술 설치

다른 작업 공간에서 발행한 기술을 설치하려면:

1. 기술 → 레지스트리로 이동
2. 다른 작업 공간의 승인된 기술 찾아보기
3. 기술에서 설치 클릭
4. 설치 확인

AACWorkflow가 작업 공간에 기술의 로컬 복사본을 생성하며, 설치한 버전으로 고정됩니다. 복사본은 독립적입니다 — 소스 기술에 대한 편집이 자동으로 복사본을 업데이트하지 않습니다.

설치된 기술의 더 새로운 버전으로 업데이트하려면:

1. 기술 → 설치됨으로 이동
2. 설치된 기술 찾기
3. 업데이트 클릭

최신 승인된 버전이 작업 공간으로 가져옵니다.

기술을 제거하려면:

1. 기술 → 설치됨으로 이동
2. 기술 찾기
3. 제거 클릭

로컬 복사본이 삭제되지만, 이를 사용하는 에이전트는 기술이 사용 불가함을 보여주도록 업데이트됩니다.

버전 히스토리 및 비교

각 발행된 버전이 유지되며, 완전한 히스토리를 볼 수 있습니다:

1. 기술 열기
2. 버전 탭 클릭
3. 다음이 포함된 모든 발행된 버전 보기:
   • 버전 번호
   • 작성자 및 발행 날짜
   • 변경 로그
   • 이전 버전과의 차이

버전 간 변경 사항을 보려면:

1. 버전 탭에서 두 버전 선택
2. 차이 보기 클릭

삭제된 행은 빨강으로; 추가된 행은 초록으로 표시됩니다.

사용 지표

기술이 얼마나 자주 사용되는지 추적:

1. 기술 열기
2. 지표 탭으로 이동

다음이 표시됩니다:

• 이를 사용하는 에이전트 — 기술이 연결된 에이전트 수
• 실행된 작업 — 기술으로 실행된 작업 총 수
• 마지막 사용 — 기술이 마지막으로 실행된 시간

이 지표를 사용하여:

• 인기 있는 기술 식별
• 미사용 기술 찾기(제거 고려)
• 조직 전체의 기술 채택 이해

기술 구성

가시성 전략

• Private — 실험적이거나 개인 기술; 공유할 준비 안 됨
• Workspace — 작업 공간의 모든 사람이 사용하는 기술
• Organization — 안정적이고 검토된 도구, 다른 팀이 알아야 함

명명 규약

도메인 또는 도구를 포함하는 설명적인 이름 사용:

• github-pr-reviewer — GitHub PR 검토
• aws-cost-analyzer — AWS 비용 분석
• sql-optimizer — SQL 쿼리 최적화
• internal-docs-generator — 내부 문서 생성

조직

작업 공간 내에서 태그 또는 접두사를 사용하여 관련 기술 그룹화:

• github-* — 모든 GitHub 관련 기술
• aws-* — 모든 AWS 관련 기술
• internal-* — 내부 전용 도구

모범 사례

• 안정적인 기술만 발행 — 발행 전 철저히 테스트
• 명확한 변경 로그 작성 — 검토자와 사용자가 변경 사항 이해하도록 도움
• 신중하게 버전 관리 — 버전을 건너뛰지 마세요; 의미론적 버전 사용(1.0 → 1.1 → 2.0)
• 기술 집중 — 한 기술, 한 작업; 여러 작업을 하면 분할
• 이전 버전 아카이브 — 새 버전 승인 후, 사용자가 이전 버전이 필요하지 않음
• 의존성 문서화 — 기술이 외부 도구 또는 API가 필요하면 명확히 문서화

버전 관리

새 버전이 발행될 때:

1. 이전 버전은 승인 유지 — 기존 설치가 계속 작동
2. 새 버전은 대기 검토 — 승인받아야 함
3. 사용자가 업그레이드 가능 — 업데이트를 클릭하여 최신 승인 버전 가져오기
4. 고정 — 사용자는 수동으로 업데이트하지 않으면 설치된 버전 유지

이는 다음을 의미합니다:

• 중단 변경이 업그레이드를 강제하지 않음
• 사용자가 업데이트 시기 선택
• 이전 버전이 복귀용으로 사용 가능

아카이빙 및 중단

기술을 중단하려면:

1. 기술 열기
2. 설정으로 이동
3. 아카이브 클릭

아카이브된 기술:

• 레지스트리에 더 이상 표시 안 됨
• 새로 설치 불가
• 기존 설치는 여전히 작동(중단 공지 표시)
• 이미 사용 중인 에이전트는 계속 실행되지만, 사용자에게 대체품으로 전환 권장

선택적으로 제안된 대체품을 설정하여 사용자가 무엇으로 전환할지 알 수 있도록 합니다.

조직 간 기술 공유

조직 외 사람과 기술을 공유하려면:

1. 기술을 파일로 내보내기(.tar.gz 또는 유사)
2. 대역 외로 파일 공유
3. 다른 팀이 기술 → 파일에서 가져오기를 통해 가져올 수 있음

전체 AACWorkflow 커뮤니티로의 공개 공유는 현재 미지원이지만, 이 개인 레지스트리는 조직 내 쉬운 공유를 허용합니다.

보안 및 거버넌스

• 승인 게이트 — 모든 발행된 기술은 사용 전 승인받아야 함
• 작업 공간 범위 — 기술이 각 작업 공간별로 격리; 작업 공간 특정 데이터 유출 안 됨
• 버전 관리 — 각 버전은 불변; 변경은 새 버전과 재승인 필요
• 감사 추적 — 모든 발행, 승인 및 설치가 기록됨

추가 거버넌스 및 체크섬은 기술 서명 및 검토를 참조합니다.

다음 단계

• 기술 서명 및 검토 — 승인 게이트 및 변조 감지
• 기술 — 기술을 만들고 사용하는 방법 배우기
• 팀 — 특정 기술을 사용하도록 에이전트 구성