WIQD(Work IQ Dev 도구)를 사용하여 Microsoft 365 Copilot 플러그 인 프로젝트에 연속 통합 및 CI/CD(연속 업데이트) 검사를 추가합니다. 이 문서에서는 저렴한 끌어오기 요청 검사를 인증된 후보 테스트 및 승인된 릴리스 제출과 구분합니다.
이 가이드는 WIQD를 기존 CI/CD 시스템에 통합하는 개발자를 위한 것입니다. 전체 CI/CD 환경을 설정하는 방법이 아닌 요구 사항 및 명령 순서를 설명합니다. 시스템의 작업, 트리거, 실행기, 시크릿, 승인 및 아티팩트 처리를 구성하고 예제를 해당 시스템에 통합해야 합니다. 시작하기 전에 필수 구성 요소에 나열된 실행기, 환경 및 자격 증명을 준비합니다.
릴리스 대상은 테넌트의 organization 앱 카탈로그이며, 여기서 관리자는 사용자가 제출된 플러그 인을 검색하기 전에 승인합니다. 직접 공유는 별도의 배포 방법입니다. 이 워크플로는 관리자 승인을 자동화하지 않습니다. 퍼블릭 파트너 센터 제출은 별도의 wiqd publish pc 워크플로를 사용합니다.
필수 구성 요소
기존 파이프라인 또는 워크플로에서 WIQD 명령을 실행하려면 다음이 있는지 확인합니다.
- 수명 주기 파일, 구성 요소 테스트 및 비밀이 아닌 환경 구성을 포함하는 소스 제어 WIQD 플러그인 프로젝트입니다. Work IQ Dev 도구를 사용하여 플러그인 빌드를 참조하십시오.
- 소스 체크 아웃, 실행기, 보호된 비밀 및 릴리스 승인 제어가 있는 기존 CI/CD 시스템. 해당 시스템에서 작업, 트리거 및 아티팩트 처리를 구성하는 방법을 알고 있습니다.
- Node.js 24.15.0 이상 및 실행기에서 정확히 승인된 WIQD 릴리스.
WIQD 설치 지침을 따르고 설치된 버전을 기록합니다.
wiqd --version - PowerShell 7로 이동하여 이 문서의 명령 예제를 사용합니다.
- 테넌트 지원 명령에 대해 구성된 WIQD 환경
WIQD 환경 구성에 따라 환경 파일을 준비합니다. 별도의 테스트 및 프로덕션 환경 또는 Microsoft 365 테넌트는 필수 구성 요소가 아닌 선택 사항입니다.
dev,staging, 는prod일반적인 이름이며 테넌트 또는 배포 scope에 대한 보장이 아닙니다. - 필요한 위임된 동의를 통해 선택한 프로비저닝, 패키지 유효성 검사 및 게시 작업에 대해 권한이 부여된 Microsoft 365 ID입니다. WIQD 동의 및 리소스 제한에 나열된 대로 해당 작업에 필요한 권한만 부여합니다.
- 선언적 에이전트 평가의 경우 프로비전된 대상, 검토된 프롬프트 파일, 승인된 품질 임계값, 별도로 구성된 평가 인증 및 EULA 승인이 있어야 합니다. 자세한 설정 및 요구 사항은 WIQD 에이전트 평가 가이드 를 따르세요. 기술 전용 또는 도구 전용 플러그인과 같이 에이전트가 없는 플러그인에는 에이전트 평가가 필요하지 않습니다. 적용 가능한 구성 요소 및 대상 환경 테스트를 유지합니다.
플랫폼 설정 및 워크플로 작성에 대한 CI/CD 공급자의 설명서를 따르세요. 예를 들어 첫 번째 Azure 파이프라인 만들기 또는 GitHub Actions 구현을 참조하세요.
파이프라인 시나리오 선택
신뢰할 수 없는 변경이 배포 자격 증명에 액세스하거나 릴리스를 제출할 수 없도록 별도의 작업을 구성합니다.
| 시나리오 | 실행할 시기 | WIQD 작업 | 게이트 |
|---|---|---|---|
| 끌어오기 요청 유효성 검사 | 끌어오기 요청이 열리고 제안된 변경 내용에 대한 각 업데이트 후 | 오프라인 소스 유효성 검사; 선택적 오프라인 게시 준비 | 원본 검사를 통과하고 적용 범위 제한이 기록됨 |
| 후보 빌드 및 테스트 | 신뢰할 수 있는 분기 또는 권한 있는 수동 실행에서 승인된 변경 내용 | 선택한 환경에서 플러그인을 프로비저닝하고, 패키지를 빌드 및 검증하고, 적용 가능한 에이전트를 테스트하고 평가합니다. | 패키지, 구성 요소, 환경 및 품질 검사 통과 |
| 릴리스 제출 | 승인된 후보 및 릴리스 권한 부여 | 릴리스 구성 및 유효성이 검사된 패키지를 확인한 다음, organization 앱 카탈로그에 게시합니다. | 성공적인 제출에 이어 관리자 승인 및 출시 확인 |
프로젝트의 구성 요소 빌드 및 테스트를 유지합니다. WIQD는 모든 플러그 인에 대해 범용 컴파일 명령을 제공하거나 플러그 인이 참조하는 원격 서비스를 업데이트하지 않습니다.
WIQD 파이프라인 설정 가이드를 플러그 인 프로젝트에 적용하는 경우 이 문서의 wiqd plugin 명령 시퀀스를 사용합니다. 이 가이드의 수명 주기 예시는 wiqd agent 독립 실행형 플러그 인 프로젝트가 아닌 에이전트 프로젝트를 대상으로 합니다.
저렴한 끌어오기 요청 확인 추가
Microsoft 365 자격 증명 없이 오프라인 유효성 검사를 실행합니다. 이러한 검사는 리소스를 프로비전하거나, 에이전트를 호출하거나, 레지스트리에 아무 것도 제출하지 않습니다.
기존 작업에 소스 검사를 추가하려면 다음을 수행합니다.
- 제안된 소스를 확인하고 승인된 WIQD 릴리스를 설치합니다.
- 프로젝트의 해당 구성 요소 테스트를 실행합니다.
- 다음 WIQD 단계를 실행하여 프로젝트 경로 및
dev의도한 환경 컨텍스트로 바꿉.\plugins\contoso니다. - 작업을 통과하려면 기본 종료 성공 및 JSON 성공 봉투가 필요합니다.
이 GitHub Actions 단계에서는 독립 실행형 플러그 인 프로젝트에서 선언적 에이전트 원본 표면을 확인합니다.
- name: Validate plugin source
shell: pwsh
run: |
$ErrorActionPreference = 'Stop'
$PSNativeCommandUseErrorActionPreference = $false
$text = wiqd plugin validate --path .\plugins\contoso --env dev --mode source --json
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
$result = ($text -join "`n") | ConvertFrom-Json
if ($result.status -cne 'success') { throw 'Plugin source validation failed.' }
동일한 PowerShell 본문을 Azure 파이프라인 pwsh: 단계에서 실행할 수 있습니다. 공급자의 신뢰할 수 없는 끌어오기 요청 작업에 수명 주기 또는 평가 자격 증명을 삽입하지 마세요.
원본 유효성 검사는 저장된 선언적 에이전트 원본을 확인하고 읽을 수 있는 플러그 인 프로젝트 JSON 파일이 필요합니다. 최상위 앱 매니페스트 스키마, 독립 실행형 기술, 루트 커넥터 또는 참조된 API 및 OpenAPI 콘텐츠의 유효성을 완전히 검사하지는 않습니다. 기술 전용 또는 커넥터 전용 플러그인은 선언적 에이전트 소스 범위를 보고할 수 없으며, 모든 구성 요소가 유효하지는 않습니다. 반환된 확인된 파일 목록 및 결과를 검토합니다.
오프라인 작업에 대해 명시적으로 지정합니다 --mode source . 기본값은 wiqd plugin validatepackage, 이미 빌드된 ZIP을 업로드하고 로그인을 요구할 수 있습니다.
WIQD 유효성 검사 명령 참조를 참조하세요.
추가 오프라인 게시 준비 검사의 경우 다음 명령을 실행하고 동일한 종료 코드 및 JSON 검사를 적용합니다.
wiqd plugin publish --path .\plugins\contoso --env dev --dry-run --no-runtime --no-network --json
이 검사는 플러그인을 제출하지 않습니다. 런타임 및 네트워크 검사를 사용할 수 없으며 에이전트가 없으면 선언적 에이전트 단계를 건너뜁니다. 오프라인 검사는 빌드된 패키지의 유효성 검사 또는 대상 Microsoft 365 환경의 테스트를 대체하지 않습니다.
신뢰할 수 있는 작업에 대한 인증 구성
프로비저닝, 패키지 유효성 검사 및 게시에는 끌어오기 요청 작업에 없는 자격 증명이 필요합니다. 테넌트 관리자와 함께 문서화된 인증 모드를 검토하고 선택한 WIQD 릴리스에서 지원을 확인한 다음 신뢰할 수 있는 단계에만 자격 증명을 삽입합니다.
경고
사용자 이름/암호 인증을 사용하지 마세요. 선택한 WIQD 릴리스의 지원이 확인되면 새로 고침 토큰 모드를 사용합니다. 암호 모드는 organization의 보안 정책에서 명시적으로 허용하는 경우에만 사용합니다. 파이프라인을 성공시키기 위해 MFA 또는 조건부 액세스 요구 사항을 약화시키지 마세요. 새로 고침 토큰은 중요한 자격 증명이기도 하며 보호된 저장소와 제한된 액세스가 필요합니다.
중요
WIQD 파이프라인 인증 가이드는 새로 고침 토큰 인증을 아직 릴리스되지 않았거나 완전히 유효성을 검사한 것으로 표시합니다. 새로 고침 토큰 예제는 확인 프로덕션 준비 인증 경로가 아닌 통합 지침입니다. 이러한 예제를 사용하기 전에 선택한 정확한 WIQD 버전에 대한 릴리스 가용성, 보안 승인, 실시간 동의 및 작업 검사를 확인합니다.
| MODE | 필수 프로세스 입력 | 제거할 입력 |
|---|---|---|
| 새로 고침 토큰 |
CI_ENABLED=true, 테 M365_TENANT_ID넌트 GUID 및 보호됨 M365_REFRESH_TOKEN |
and , 빈 정의도 모두 M365_ACCOUNT_NAMEM365_ACCOUNT_PASSWORD삭제합니다. |
| 사용자 이름 및 암호 |
CI_ENABLED=true, 보호 M365_ACCOUNT_NAME됨, 보호됨 M365_ACCOUNT_PASSWORD |
제거 M365_REFRESH_TOKEN, M365_TENANT_ID 이 모드에서는 선택 사항입니다. |
새로 고침 토큰 인증의 경우:
- WIQD 파이프라인 인증에서 프라이빗 로컬 부트스트랩 절차를 따릅니다.
- 결과 토큰을 승인된 파이프라인 비밀 저장소에 직접 넣습니다. 커밋하지 말고, 명령 인수로 전달하거나, 로그 또는 아티팩트에 포함하지 마세요.
- 테넌트 및 토큰을 신뢰할 수 있는 명령 프로세스에 매핑합니다.
- 릴리스 제출을 사용하도록 설정하기 전에 제어된 실행에서 선택한 WIQD 릴리스, ID, 실행기 및 필수 작업을 확인합니다.
신뢰할 수 있는 GitHub Actions 단계의 경우 다음 환경 바인딩을 사용합니다.
env:
CI_ENABLED: 'true'
M365_TENANT_ID: ${{ vars.M365_TENANT_ID }}
M365_REFRESH_TOKEN: ${{ secrets.M365_REFRESH_TOKEN }}
Azure Pipelines에는 비밀 변수에 대한 명시적 env 매핑이 필요합니다. WIQD를 호출하기 전에 다음 바인딩을 사용하고 확인되지 않은 $(NAME) 매크로를 거부합니다.
env:
CI_ENABLED: 'true'
M365_TENANT_ID: $(M365_TENANT_ID)
M365_REFRESH_TOKEN: $(M365_REFRESH_TOKEN)
이는 완전한 파이프라인 정의가 아닌 환경 바인딩입니다. 인증 모드와 공급자별 검사의 경우 모두 WIQD 파이프라인 예제를 따르세요.
CI_ENABLED 정확히 소문자 true여야 합니다. 일반 데이터 CI=true 로는 충분하지 않습니다. CI가 아닌 wiqd auth login 직접 수명 주기 명령을 호출합니다. 앱 전용 ID가 아닌 위임된 자격 증명이며 MFA, 조건부 액세스, 동의 또는 권한을 무시하지 않습니다.
WIQD는 파이프라인 비밀 저장소를 회전하지 않습니다. 인증에 사람의 로그인 또는 동의가 필요한 경우 정책 또는 동의 문제를 resolve하고 문서화된 로컬 절차를 통해 비밀을 교체합니다. 자동으로 다른 ID로 전환하지 마세요.
후보 빌드 및 유효성 검사
릴리스 제출 전에 선택한 WIQD 환경에서 후보를 빌드하고 테스트합니다. 테스트는 릴리스와 동일한 테넌트, 환경 구성 및 승인된 Microsoft 365 ID를 사용할 수 있습니다. 별도의 테스트 환경은 선택 사항입니다. 관련 명령을 동일한 프로젝트 및 환경 상태로 유지합니다.
경고
후보 플러그인과 릴리스된 플러그인이 동일한 플러그인 리소스 ID를 사용하는 경우 프로비전은 카탈로그 제출 또는 관리자 승인 전에 기존 사용자가 사용하는 리소스를 업데이트할 수 있습니다. 해당 변경 내용에 권한이 부여되고 액세스가 제어되는 경우에만 후보 업데이트에 해당 ID를 사용합니다. 별도의 후보 ID는 선택 사항이지만 릴리스된 플러그 인에서 후보 변경 내용을 격리합니다.
후보자를 준비하려면 다음을 수행합니다.
- 승인된 소스 수정 버전 및 플러그인 패키지 버전을 선택합니다.
- 선택한 환경이 이미 프로비전된 경우 승인된 보안 지속성 메커니즘을 통해 설정된 환경 상태를 사용할 수 있도록 합니다. 앱 ID뿐만 아니라 수명 주기에 필요한 모든 값을 유지합니다. 프로젝트 보관 또는 인증 캐시를 다운로드하여 자격 증명을 복원하지 마세요.
- 구성 요소 빌드, 테스트 및 오프라인 소스 유효성 검사를 실행합니다.
- 이 후보에 필요한 경우 선택한 환경을 프로비전하거나 업데이트합니다.
- 프로비저닝이 원본 유효성 검사에 포함되는 입력을 변경하는 경우 영향을 받는 원본의 유효성을 다시 검사합니다.
- 프로젝트를 패키지화합니다.
- 패키지 모드를 사용하여 생성된 ZIP의 유효성을 검사합니다.
- ZIP, 유효성 검사 결과, 원본 수정 버전, 패키지 버전, WIQD 버전 및 환경 ID를 후보 레코드와 함께 유지합니다.
다음 PowerShell 예제에서는 테넌트 리소스에 대한 프로비전 또는 업데이트가 필요한 후보를 다룹니다. 인증이 구성되면 신뢰할 수 있는 작업 내에서 실행합니다. 선택한 환경이 이미 ID에 바인딩되어 있고 프로비저닝 업데이트가 필요하지 않은 경우 프로비전 명령을 생략합니다. 입력이 변경된 경우에만 소스 유효성 검사를 반복합니다. 프로젝트 경로와 dev 환경을 후보 구성으로 바꿉니다. 도우미는 네이티브 오류, 잘못된 형식의 JSON 또는 실패한 봉투에서 중지됩니다.
이 예제에서는 전체 유효성 검사 JSON .artifacts\validation.json 을 중간 증거로 작성합니다. 유지하거나 공유하기 전에 액세스를 제한하고 테넌트 정보, 식별자, URL 및 중요한 콘텐츠에 대한 페이로드를 검토합니다. 업로드하기 전에 증거를 삭제합니다. 아티팩트 디렉터리를 자동으로 업로드하지 마세요.
$ErrorActionPreference = 'Stop'
$PSNativeCommandUseErrorActionPreference = $false
function Invoke-WiqdJson([string[]]$Arguments) {
$text = & wiqd @Arguments
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
$result = ($text -join "`n") | ConvertFrom-Json
if ($result.status -cne 'success') { throw 'WIQD operation failed.' }
return $result
}
$project = (Resolve-Path .\plugins\contoso).Path
$environment = 'dev'
$artifactDirectory = Join-Path $PWD '.artifacts'
New-Item -ItemType Directory -Path $artifactDirectory -Force | Out-Null
$package = Join-Path $artifactDirectory 'plugin-dev.zip'
$common = @('--path', $project, '--env', $environment, '--json')
Invoke-WiqdJson (@('plugin', 'validate', '--mode', 'source') + $common) | Out-Null
Invoke-WiqdJson (@('plugin', 'provision') + $common) | Out-Null
Invoke-WiqdJson (@('plugin', 'validate', '--mode', 'source') + $common) | Out-Null
Invoke-WiqdJson (@('plugin', 'package', '--output', $package) + $common) | Out-Null
if (-not (Test-Path -LiteralPath $package -PathType Leaf)) { throw 'Package output is missing.' }
$validation = Invoke-WiqdJson (@('plugin', 'validate', '--mode', 'package', '--package-file', $package) + $common)
$validation | ConvertTo-Json -Depth 100 | Set-Content -LiteralPath (Join-Path $artifactDirectory 'validation.json')
패키지 모드는 이미 빌드된 ZIP을 플랫폼의 패키지 유효성 검사 서비스에 제출하고 결과를 보고합니다. ZIP을 빌드하거나 자동으로 로그인하지 않으며 런타임 동작, 연결 준비, 원격 서비스 상태 또는 파트너 센터 수락을 설정하지 않습니다. 인증된 서비스 액세스가 필요하며 오프라인 끌어오기 요청 검사가 아닙니다. 누락된 인증, 서비스 오류 또는 거부된 패키지로 인해 후보가 차단됩니다.
프로비전은 선택한 환경 파일을 쓰고 패키징에서 소비하기 TEAMS_APP_ID 때문에 일반적으로 패키징에 우선합니다. 환경이 이미 ID에 바인딩되어 있고 프로비저닝 업데이트가 필요하지 않은 경우 기존 상태에 대한 프로비전 명령 및 패키지를 생략합니다. 다시 프로비전하면 해당 ID가 사용되지만 새로 체크 아웃해도 자동으로 보존되지는 않습니다. 실행 간에 안정적인 ID를 안전하게 유지합니다. 환경 파일, 사용자 비밀 파일, 인증 캐시 또는 전체 작업 영역을 아티팩트로 게시하지 마세요.
시간 초과 후에는 프로비저닝 또는 게시를 자동으로 다시 시도하지 마세요. 다시 실행을 승인하기 전에 기존 작업 및 리소스를 검사합니다.
배치된 후보 테스트 및 평가
필요한 연결, 권한, 기술 및 원격 서비스를 포함하여 모든 대상 환경에서 후보자를 테스트합니다. 패키지 유효성 검사는 모든 기능이 런타임에 작동한다고 설정하지는 않습니다.
선언적 에이전트가 포함된 플러그인의 경우 품질 게이트를 추가합니다.
- 배포된 선언적 에이전트 구성 요소의 타이틀 ID를 식별합니다. 독립 실행형 플러그 인의 카탈로그 제목 ID를 대체하지 마세요.
- 검토된 프롬프트 파일과 대표 작업에 대한 수락 임계값을 준비합니다. 후보를 기준과 비교할 때 제품군을 변경하지 않습니다.
- 평가 CLI의 Microsoft 365 에이전트 연결 인증을 구성하고 의도된 실행기에 대한 테넌트 승인이 필요합니다. 선택한 판사의 자격 증명을 별도로 구성하고 CI 외부에서 평가 CLI의 필수 EULA 동의를 완료합니다.
- 배포된 해당 구성 요소에 대해 실행
wiqd agent eval하고 결과를 후보로 유지합니다. - 블록 릴리스 평가에 실패하거나, 임계값이 충족되지 않거나, 실행기가 인증할 수 없는 경우.
이 예제에서는 작업 영역에서 배포된 에이전트를 평가합니다.evals\contoso 검토된 프롬프트 파일을 evals\contoso\evals\prompts.json체크 아웃 루트를 기준으로 에 놓습니다. 출력 경로는 해당 작업 영역을 기준으로 상대적으로 확인됩니다. 후보 구성 요소의 타이틀 ID로 바꿉니다 <deployed-agent-title-id> .
0.85 임계값은 예입니다. 시나리오에 필요한 품질 막대를 선택합니다.
$ErrorActionPreference = 'Stop'
$PSNativeCommandUseErrorActionPreference = $false
$agentId = '<deployed-agent-title-id>'
$text = wiqd agent eval --path .\evals\contoso --agent-id $agentId --env dev --threshold 0.85 --output .evals\results.json --json
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
$result = ($text -join "`n") | ConvertFrom-Json
if ($result.status -cne 'success') { throw 'Agent evaluation failed.' }
WIQD Eval 명령은 프롬프트 전용 작업 영역 및 명시적 에이전트 ID를 문서화합니다. 평가 워크플로우는 임계값 처리를 문서화합니다. 임계값 누락과 업스트림 실패는 모두 JSON에서 다른 오류 코드를 사용하여 0이 아닌 종료를 반환합니다.
수명 주기 새로 고침 토큰은 평가를 인증하지 않습니다. 평가 CLI는 자체 Microsoft 365 인증을 사용하는 반면 심사위원은 별도의 GitHub Copilot 또는 Azure 자격 증명을 사용합니다. WIQD 원본은 임의의 호스트된 실행기에 대한 완전한 무인 평가 자격 증명 부트스트랩을 제공하지 않습니다. 자동화된 게이트로 만들기 전에 러너에 해당 설정을 검증하십시오. 무인으로 실행할 수 없는 경우 건너뛴 실행을 성공으로 처리하는 대신 권한 있는 평가와 증거를 요구합니다.
wiqd agent eval 전체 플러그인 평가자가 아니며 독립 실행형 기술, 루트 커넥터 또는 사용자 지정 엔진 에이전트를 평가하지 않습니다. 이러한 기능의 경우 플러그 인의 유효성을 검사하고 테스트하는 데 필요한 구성 요소 및 대상 환경 테스트를 유지합니다.
테스터가 직접 액세스해야 하는 경우 대상 그룹에 명시적으로 권한을 부여하고 WIQD 플러그인 공유를 따릅니다. 공유를 위해서는 선택한 환경 파일과 해당 공유 배포가 필요합니다AGENT_SCOPE=shared. 환경 dev 이름을 지정한다고 해서 해당 scope는 설정되지 않습니다. 공유 요구 사항을 무시하기 위해 개인 배포의 레이블을 다시 지정하거나 해당 ID를 복사하지 마세요.
organization 앱 카탈로그에 승인된 업데이트 제출
보호된 릴리스 작업을 사용하여 organization 앱 카탈로그에 업데이트를 제출합니다. 후보 테스트는 프로덕션 변형 또는 관리자 승인을 승인하지 않습니다.
업데이트를 릴리스하려면 다음을 수행합니다.
- 후보 소스 개정, 패키지 버전, 유효성 검사 결과, 해당하는 경우 평가 증거 및 의도된 프로덕션 대상을 승인합니다.
- 릴리스 대상의 설정된 환경 상태를 작업에 사용할 수 있도록 합니다. 실행할 때마다 새 앱 등록을 만드는 대신 업데이트에 대한 기존 플러그 인 ID를 유지합니다.
- 릴리스에서 테스트된 후보와 다른 환경 구성 또는 플러그 인 리소스 ID를 사용하는 경우 해당 대상에 대해 영향을 받는 프로비저닝, 패키징, 유효성 검사 및 테스트를 반복합니다.
- 인증된 Microsoft 365 ID만 변경되는 경우 테넌트, 위임된 동의, 권한 및 필요한 작업에 대한 액세스를 확인합니다. 인증 ID를 변경하는 것만으로는 패키지를 다시 작성할 필요가 없습니다.
- 릴리스 대상의 패키지 및 배포가 해당 테스트를 통과하는지 확인합니다. 유효한 구성, 패키지 및 배포 상태가 변경되지 않은 경우 대상 유효성 검사를 반복하지 않고 후보 증거를 다시 사용합니다.
- WIQD를 통해 릴리스 대상에 대해 프로비전된 프로젝트를 제출하고 결과를 기록합니다.
- 승인을 위해 관리자에게 제출을 전달한 다음 업데이트된 앱 카탈로그 항목, 패키지 버전, 가용성 및 사용자 환경을 확인합니다.
릴리스 대상의 유효성을 검사하고 제출을 승인한 후 이 명령은 선택한 프로젝트의 플러그 인을 organization 앱 카탈로그에 게시합니다.
prod 는 예제 환경 이름입니다. 후보 테스트에 사용되는 것과 동일한 환경일 수 있는 구성된 릴리스 환경을 사용합니다.
$ErrorActionPreference = 'Stop'
$PSNativeCommandUseErrorActionPreference = $false
$text = wiqd plugin publish --path .\plugins\contoso --env prod --json
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
$result = ($text -join "`n") | ConvertFrom-Json
if ($result.status -cne 'success') { throw 'Plugin submission failed.' }
게시 결과를 릴리스 레코드와 함께 유지합니다.
wiqd plugin publish 이전에 빌드된 ZIP --package-file이 아닌 프로젝트 및 환경을 허용합니다. 캡처된 ZIP의 유효성을 검사한다고 해서 게시가 해당 정확한 바이트를 제출한다는 것을 증명할 수는 없습니다. 승인된 원본 및 환경 상태를 고정한 상태로 유지하고, 고정된 WIQD 릴리스의 게시 동작을 검증하고, 제출된 결과를 확인합니다. 이것을 변경할 수 없는 ZIP 프로모션 워크플로로 설명하지 마세요.
WIQD는 이러한 배포 경로에 대해 별도의 명령을 제공합니다.
| 작업 | 결과 | 남은 작업 |
|---|---|---|
wiqd plugin publish |
테넌트 organization 앱 카탈로그에 제출 | 사용자가 플러그 인을 검색하기 전에 관리자 승인 |
wiqd plugin share |
명명된 사용자 또는 테넌트에 대한 직접 액세스 | 승인된 대상 그룹, 설치 및 연결 확인 |
wiqd publish pc 플러그인 패키지의 경우 |
파트너 센터 오퍼 준비, 업로드, 승인된 제출 및 상태 추적 | Microsoft에서 인증 및 라이브 게시를 제어합니다. |
공개 제출의 경우 WIQD를 사용하여 파트너 센터에 게시하는 단계를 따르세요. 마켓플레이스 인증은 이 문서에서 사용하는 핵심 파이프라인 자격 증명과는 별개입니다. 무인 제출에는 명시적 권한 부여와 이전에 설정된 대화형 판매자 세션이 있는 신뢰할 수 있는 영구 실행기 및 보호된 OS 자격 증명 저장소에 대한 액세스가 필요합니다. 클린 러너, 서비스 주체 및 워크로드 ID 인증은 마켓플레이스 게시에서 지원되지 않습니다. 해당 실행기 요구 사항이 충족되지 않는 경우 인증된 운영자를 사용합니다.
WIQD는 플러그인 레지스트리 슬롯 승격 또는 롤백 명령을 문서화하지 않습니다. 릴리스 전에 지원되는 교체 또는 복구 절차를 설정하고, 패키지 업데이트가 별도로 운영되는 서비스 또는 권한을 복원한다고 가정하지 마세요. 롤아웃 확인 및 복구 계획을 위해 플러그인을 개선하고 업데이트합니다 .
증거 보존 및 후보 클린 정리
테넌트 자격 증명 또는 평가 데이터를 권한이 없는 판독자에게 노출하지 않고 승인된 업데이트를 추적하는 데 필요한 증거를 유지합니다.
- 승인된 소스 수정 버전, WIQD 릴리스, 패키지 ID 및 버전, 삭제된 유효성 검사 및 평가 결과, 게시 상태를 유지합니다.
- 프롬프트 및 응답에 조직 데이터가 포함될 수 있으므로 평가 결과 액세스를 제한합니다.
- 후보 배포를 제거하기 전에 프로덕션 업데이트를 확인합니다.
- 임시 후보에 별도의 리소스 ID가 있고 더 이상 필요하지 않은 경우 명시적으로 삭제 권한을 부여합니다. 문서화된 WIQD 플러그인 삭제 명령 은 해당 후보의 환경 및 ID에 대해서만 사용합니다.
파괴적 정리를 무조건적인 파이프라인 단계로 만들거나 후보 정리의 일부로 릴리스된 플러그인의 ID를 삭제하지 마세요. 테스트 및 릴리스에서 동일한 ID를 사용하는 경우 임시 후보로 삭제하지 마세요.