ACL 액션
계정
| 이름 |
설명 |
CreateAccount |
새로운 계정을 생성하는 기능입니다. |
UpdateAccount |
계정 세팅을 업데이트합니다. |
DeleteAccount |
서버에서 계정을 삭제합니다. |
ViewAccount |
계정 정보를 보는 기능입니다. |
알림
| 이름 |
설명 |
CreateNotice |
새로운 알림을 생성하는 기능입니다. |
UpdateNotice |
서버에서 알림을 수정하는 기능입니다. |
DeleteNotice |
알림을 삭제하는 기능입니다. |
ServiceAccounts
| 이름 |
설명 |
CreateAccount |
새로운 계정을 생성하는 기능입니다. |
UpdateAccount |
계정 세팅을 업데이트합니다. |
DeleteAccount |
서버에서 계정을 삭제합니다. |
ViewAccount |
계정 정보를 보는 기능입니다. |
에이전트
| 이름 |
설명 |
CreateAgent |
에이전트를 생성하는 기능입니다. 명시적으로 수행되거나, 에이전트에 부여되어 자체 등록을 허용할 수 있습니다. |
UpdateAgent |
에이전트의 이름, 풀 등을 업데이트합니다. |
DeleteAgent |
에이전트를 소프트 삭제합니다. |
ViewAgent |
에이전트를 봅니다. |
ListAgents |
사용할 수 있는 에이전트를 나열합니다. |
계산
| 이름 |
설명 |
AddComputeTasks |
사용자가 계산 클러스터에 작업을 추가할 수 있습니다. |
GetComputeTasks |
사용자가 계산 클러스터에서 작업을 얻고 나열할 수 있습니다. |
리스
| 이름 |
설명 |
ViewLeases |
에이전트가 작업한 모든 리스를 봅니다. |
ViewLeaseTasks |
리스의 작업 데이터를 봅니다. |
로그
| 이름 |
설명 |
CreateLog |
로그를 생성하는 기능입니다. 에이전트에 묵시적으로 부여됩니다. |
UpdateLog |
로그 메타데이터를 업데이트하는 기능입니다. |
ViewLog |
로그 콘텐츠를 보는 기능입니다. |
WriteLogData |
로그 데이터를 작성하는 기능입니다. |
CreateEvent |
이벤트를 생성하는 기능입니다. |
ViewEvent |
이벤트를 보는 기능입니다. |
풀
| 이름 |
설명 |
CreatePool |
에이전트의 글로벌 풀을 생성합니다. |
UpdatePool |
에이전트 풀을 수정합니다. |
DeletePool |
에이전트 풀을 삭제합니다. |
ViewPool |
풀을 보는 기능입니다. |
ListPools |
사용할 수 있는 모든 에이전트 풀을 봅니다. |
세션
| 이름 |
설명 |
CreateSession |
에이전트에 부여되어 CreateSession을 호출하며, 자체적으로 유효성을 식별하는 Bearer 토큰을 반환하여 gRPC를 통해 UpdateSesssion을 호출합니다. |
ViewSession |
에이전트 세션에 대한 정보 보기를 허용합니다. |
소프트웨어
| 이름 |
설명 |
UploadSoftware |
에이전트 소프트웨어의 새로운 버전을 업로드하는 기능입니다. |
DownloadSoftware |
에이전트 소프트웨어를 다운로드하는 기능입니다. |
DeleteSoftware |
에이전트 소프트웨어를 삭제하는 기능입니다. |
암호
| 이름 |
설명 |
ViewSecret |
크리덴셜을 봅니다. |
아티팩트
| 이름 |
설명 |
ReadArtifact |
아티팩트에서 읽는 권한입니다. |
WriteArtifact |
아티팩트에 작성하는 권한입니다. |
DeleteArtifact |
아티팩트를 삭제하는 권한입니다. |
UploadArtifact |
아티팩트를 생성하는 기능입니다. 일반적으로 디버깅 전용입니다. 에이전트는 특정 세션에 대한 이 액세스 권한을 보유합니다. |
DownloadArtifact |
아티팩트를 다운로드하는 기능입니다. |
Bisect
| 이름 |
설명 |
CreateBisectTask |
새 bisect 작업을 시작하는 기능입니다. |
UpdateBisectTask |
bisect 작업을 업데이트하는 기능입니다. |
ViewBisectTask |
bisect 작업을 보는 기능입니다. |
디바이스
| 이름 |
설명 |
DeviceRead |
디바이스를 읽는 기능입니다. |
DeviceWrite |
디바이스를 작성하는 기능입니다. |
작업
| 이름 |
설명 |
CreateJob |
새 작업을 시작하는 기능입니다. |
UpdateJob |
작업의 이름을 변경하고, 우선순위를 수정합니다. |
DeleteJob |
작업 프로퍼티를 삭제합니다. |
ExecuteJob |
작업 메타데이터(이름, 체인지리스트 번호, 단계 프로퍼티, 새 그룹, 작업 상태 등) 업데이트를 허용합니다. 일반적으로 에이전트에 부여됩니다. 사용자 대상이 아닙니다. |
RetryJobStep |
실패한 작업 단계를 다시 시도하는 기능입니다. |
ViewJob |
작업을 보는 기능입니다. |
알림
| 이름 |
설명 |
CreateSubscription |
알림을 구독하는 기능입니다. |
프로젝트
| 이름 |
설명 |
CreateProject |
새 프로젝트 생성을 허용합니다. |
DeleteProject |
프로젝트 삭제를 허용합니다. |
UpdateProject |
프로젝트의 어트리뷰트(이름, 카테고리 등)를 수정합니다. |
ViewProject |
프로젝트에 대한 정보를 봅니다. |
리플리케이터
| 이름 |
설명 |
UpdateReplicator |
프로젝트 삭제를 허용합니다. |
ViewReplicator |
새 프로젝트 생성을 허용합니다. |
스트림
| 이름 |
설명 |
CreateStream |
프로젝트 내 새 스트림 생성을 허용합니다. |
UpdateStream |
스트림(에이전트 타입, 템플릿, 예약) 업데이트를 허용합니다. |
DeleteStream |
스트림 삭제를 허용합니다. |
ViewStream |
스트림을 보는 기능입니다. |
ViewChanges |
스트림에 제출된 변경사항을 봅니다. 참고: 이 스키마는 서버의 Perforce 계정에서 응답을 반환하며, 이는 권한이 있는 사용자일 수 있습니다. |
ViewTemplate |
스트림과 연관된 템플릿을 봅니다. |
스토리지
| 이름 |
설명 |
ReadBlobs |
스토리지 서비스의 블롭을 읽는 기능입니다. |
WriteBlobs |
스토리지 서비스에 블롭을 작성하는 기능입니다. |
ReadRefs |
스토리지 서비스에서 레퍼런스를 읽는 기능입니다. |
WriteRefs |
스토리지 서비스에 레퍼런스를 작성하는 기능입니다. |
DeleteRefs |
레퍼런스를 삭제하는 기능입니다. |
심볼
| 이름 |
설명 |
ReadSymbols |
심볼을 다운로드하는 기능입니다. |
툴
| 이름 |
설명 |
DownloadTool |
툴을 다운로드하는 기능입니다. |
UploadTool |
새로운 툴 버전을 업로드하는 기능입니다. |
DDC
| 이름 |
설명 |
DdcReadObject |
레퍼런스/블롭 등에 대한 일반적인 읽기 액세스 권한입니다. |
DdcWriteObject |
레퍼런스/블롭 등을 업로드하기 위한 일반적인 쓰기 액세스 권한입니다. |
DdcDeleteObject |
블롭/레퍼런스 등을 삭제하기 위한 액세스 권한입니다. |
DdcDeleteBucket |
특정 버킷을 삭제하기 위한 액세스 권한입니다. |
DdcDeleteNamespace |
전체 네임스페이스를 삭제하기 위한 액세스 권한입니다. |
DdcReadTransactionLog |
트랜잭션 로그를 읽기 위한 액세스 권한입니다. |
DdcWriteTransactionLog |
트랜잭션 로그를 쓰기 위한 액세스 권한입니다. |
DdcAdminAction |
관리 작업을 수행하기 위한 액세스 권한입니다. |
대시보드
대시보드 기능에 대한 환경설정입니다.
| 이름 |
설명 |
showLandingPage |
boolean 기본적으로 랜딩 페이지로 이동합니다. |
landingPageRoute |
string 사용자를 안내할 커스텀 랜딩 페이지 경로입니다. |
showCI |
boolean CI 기능을 활성화합니다. |
showAgents |
boolean 대시보드에서 에이전트, 풀, 활용 관련 기능을 표시할지 여부입니다. |
showAgentRegistration |
boolean 에이전트 등록 페이지를 표시할지 여부입니다. 다른 곳의 등록 토큰을 사용할 때는 이 스키마가 필요하지 않습니다. |
showPerforceServers |
boolean 서버 메뉴에 Perforce 서버 옵션을 표시합니다. |
showDeviceManager |
boolean 서버 메뉴에 디바이스 매니저를 표시합니다. |
showTests |
boolean 서버 메뉴에 자동화된 테스트를 표시합니다. |
agentCategories |
DashboardAgentCategoryConfig[] 다양한 에이전트 페이지에 대한 환경설정입니다. |
poolCategories |
DashboardPoolCategoryConfig[] 다양한 풀 페이지에 대한 환경설정입니다. |
include |
ConfigInclude[] 다른 환경설정 파일의 포함 사항입니다. |
macros |
ConfigMacro[] 이 환경설정 내 매크로입니다. |
DashboardAgentCategoryConfig
에이전트의 카테고리에 대한 환경설정입니다.
| 이름 |
설명 |
name |
string 카테고리의 이름입니다. |
condition |
string 이 페이지에 대해 평가될 조건 스트링입니다. |
DashboardPoolCategoryConfig
풀의 카테고리에 대한 환경설정입니다.
| 이름 |
설명 |
name |
string 카테고리의 이름입니다. |
condition |
string 이 페이지에 대해 평가될 조건 스트링입니다. |
ConfigInclude
또 다른 소스의 환경설정 데이터를 병합하기 위한 지시문입니다.
| 이름 |
설명 |
path |
string 환경설정 데이터가 포함될 경로입니다. 포함하는 파일의 위치를 기준으로 할 수 있습니다. |
ConfigMacro
환경설정 매크로를 선언합니다.
| 이름 |
설명 |
name |
string 매크로 프로퍼티의 이름입니다. |
value |
string 매크로 프로퍼티의 값입니다. |
글로벌
글로벌 환경설정입니다. (Globals.json)
| 이름 |
설명 |
version |
integer 서버의 버전 번호입니다. 값은 XX로 표시됩니다. |
include |
ConfigInclude[] 포함할 다른 경로입니다. |
macros |
ConfigMacro[] 글로벌 범위 내 매크로입니다. |
dashboard |
대시보드의 DashboardConfig 세팅입니다. |
downtime |
ScheduledDowntime[] 예약된 다운타임 목록입니다. |
plugins |
GlobalPluginsConfig 플러그인 환경설정 오브젝트입니다. |
parameters |
object 다른 툴의 일반 파라미터입니다. api/v1/parameters 엔드포인트를 통해 쿼리될 수 있습니다. |
acl |
AclConfig 액세스 컨트롤 목록입니다. |
ConfigInclude
또 다른 소스의 환경설정 데이터를 병합하기 위한 지시문입니다.
| 이름 |
설명 |
path |
string 환경설정 데이터가 포함될 경로입니다. 포함하는 파일의 위치를 기준으로 할 수 있습니다. |
ConfigMacro
환경설정 매크로를 선언합니다.
| 이름 |
설명 |
name |
string 매크로 프로퍼티의 이름입니다. |
value |
string 매크로 프로퍼티의 값입니다. |
ScheduledDowntime
유지보수 창의 세팅입니다.
ScheduledDowntimeFrequency(열거형)
유지보수 창이 반복되는 빈도입니다.
| 이름 |
설명 |
Once |
한 번 |
Daily |
매일 |
Weekly |
매주 |
GlobalPluginsConfig
ComputeConfig
계산 시스템에 대한 환경설정입니다.
AclConfig
ACL을 업데이트하는 파라미터입니다.
| 이름 |
설명 |
entries |
AclEntryConfig[] 기존 ACL을 대체할 항목입니다. |
profiles |
AclProfileConfig[] 액션 세트를 명명된 컬렉션으로 그룹화하도록 허용하는 프로파일을 정의합니다. |
inherit |
boolean 부모 ACL에서 권한을 상속할지 여부입니다. |
exceptions |
string[] 상속된 세팅에 대한 예외 목록입니다. |
AclEntryConfig
ACL 내 개별 항목입니다.
| 이름 |
설명 |
claim |
AclClaimConfig 사용자 또는 그룹의 이름입니다. |
actions |
string[] 허용할 액션의 배열입니다. |
profiles |
string[] 부여할 프로파일의 목록입니다. |
AclClaimConfig
생성할 새 클레임입니다.
| 이름 |
설명 |
type |
string 클레임 타입입니다. |
value |
string 클레임 값입니다. |
AclProfileConfig
ACL 프로파일에 대한 환경설정입니다. ACL 항목을 통해 사용자에게 부여할 수 있는 액션의 프리셋 그룹을 정의합니다.
| 이름 |
설명 |
id |
string 이 프로파일의 식별자입니다. |
actions |
string[] 포함할 액션입니다. |
excludeActions |
string[] 상속된 액션에서 제외할 액션입니다. |
extends |
string[] 확장할 다른 프로파일입니다. |
ConfigVersion(열거형)
서버를 실행하기 위한 글로벌 버전 번호입니다. 데이터 마이그레이션이 필요한 새로운 기능이 도입되었으므로, 이 버전 번호는 활성화되어야 하는 이전 버전과의 호환성 기능을 나타냅니다. 여기에 새 버전을 추가할 때는 디플로이를 업그레이드하기 위해 취해야 하는 조치를 설명하는 메시지도 ConfigService.CreateSnapshotAsync에 추가하세요.
| 이름 |
설명 |
None |
지정되지 않음 |
Initial |
초기 버전 번호입니다. |
PoolsInConfigFiles |
REST API를 통해 풀을 추가/제거하는 기능이 제거됩니다. 대신 globals.json을 통해 풀을 환경설정해야 합니다. |
Latest |
최신 버전 번호입니다. |
LatestPlusOne |
마지막으로 정의된 버전 번호에 1을 더합니다. |
AgentRateConfig
특정 기준에 일치하는 에이전트의 금전적 비용을 설명합니다.
| 이름 |
설명 |
condition |
string 조건 스트링입니다. |
rate |
number 이 에이전트의 요금입니다. |
ComputeClusterConfig
계산 요청을 실행하기 위한 프로파일입니다.
| 이름 |
설명 |
id |
string 파티션의 이름입니다. |
namespaceId |
string 사용할 네임스페이스의 이름입니다. |
requestBucketId |
string 입력 버킷의 이름입니다. |
responseBucketId |
string 출력 버킷의 이름입니다. |
condition |
string 에이전트가 포함할 필터입니다. |
acl |
AclConfig 액세스 컨트롤 목록입니다. |
PoolConfig
풀에 대한 변경 가능한 환경설정입니다.
| 이름 |
설명 |
id |
string 이 풀의 고유 ID입니다. |
base |
string 세팅을 복사할 베이스 풀 환경설정입니다. |
name |
string 풀의 이름입니다. |
condition |
string 에이전트가 이 풀에 자동으로 포함되도록 하는 조건입니다. |
properties |
string -> string 이 풀과 관련된 임의 프로퍼티입니다. |
color |
PoolColor 대시보드에서 이 풀에 사용할 컬러입니다. |
enableAutoscaling |
boolean 이 풀에 Auto Scaling을 활성화할지 여부입니다. |
minAgents |
integer 풀에 유지할 최소 에이전트 수입니다. |
numReserveAgents |
integer 예비로 보유할 최소 유휴 에이전트의 수입니다. |
conformInterval |
string 일치 간 간격입니다. 0인 경우 풀이 예약에서 일치를 수행하지 않습니다. |
scaleOutCooldown |
string 스케일 아웃 이벤트 간의 쿨다운 시간입니다. |
scaleInCooldown |
string 스케일 인 이벤트 간의 쿨다운 시간입니다. |
shutdownIfDisabledGracePeriod |
string 비활성화된 에이전트를 종료하기 전에 대기할 시간입니다. |
sizeStrategy |
PoolSizeStrategy |
sizeStrategies |
PoolSizeStrategyInfo[] 이 풀의 풀 크기 조정 전략 목록입니다. 조건이 일치하는 첫 번째 전략이 선택됩니다. |
fleetManagers |
FleetManagerInfo[] 이 풀의 플릿 매니저 목록입니다. 조건이 일치하는 첫 번째 전략이 선택됩니다. 비어 있거나 일치하는 조건이 없는 경우 기본 플릿 매니저가 사용됩니다. |
leaseUtilizationSettings |
LeaseUtilizationSettings 리스 활용 풀 크기 조정 전략의 세팅입니다(사용되는 경우). |
jobQueueSettings |
JobQueueSettings 작업 큐 풀 크기 조정 전략의 세팅입니다(사용되는 경우). |
computeQueueAwsMetricSettings |
ComputeQueueAwsMetricSettings 작업 큐 풀 크기 조정 전략의 세팅입니다(사용되는 경우). |
PoolColor(열거형)
이 풀의 라벨에 사용할 컬러입니다.
| 이름 |
설명 |
Default |
기본 |
Blue |
파란색 |
Orange |
주황색 |
Green |
녹색 |
Gray |
회색 |
PoolSizeStrategy(열거형)
사용할 수 있는 풀 크기 조정 전략입니다.
| 이름 |
설명 |
LeaseUtilization |
리스 활용에 기반한 전략입니다. |
JobQueue |
작업 빌드 큐의 크기에 기반한 전략입니다. |
NoOp |
예비/기본 동작으로 사용되는 작업 없음(No-op) 전략입니다. |
ComputeQueueAwsMetric |
외부 AWS Auto Scaling 정책이 플릿을 스케일 조절하도록 메트릭을 보고하는 작업 없음 전략입니다. |
LeaseUtilizationAwsMetric |
외부 AWS Auto Scaling 정책이 플릿을 스케일 조절하도록 메트릭을 보고하는 작업 없음 전략입니다. |
PoolSizeStrategyInfo
풀 크기 조정 전략을 환경설정 및 선택하기 위한 메타데이터입니다.
| 이름 |
설명 |
type |
PoolSizeStrategy 사용할 전략 구현입니다. |
condition |
string 이 전략을 활성화해야 하는 경우의 조건입니다(현재는 날짜/시간으로 구분함). |
config |
object 전략에 대한 환경설정으로, JSON으로 시리얼라이즈됩니다. |
extraAgentCount |
integer 풀 크기가 계산된 후 추가할 인티저입니다. 음수일 수도 있습니다. |
FleetManagerInfo
플릿 매니저 환경설정 및 선택을 위한 메타데이터입니다.
| 이름 |
설명 |
type |
FleetManagerType 사용할 플릿 매니저 타입 구현입니다. |
condition |
string 이 전략을 활성화해야 하는 경우의 조건입니다(현재는 날짜/시간으로 구분함). |
config |
object 전략에 대한 환경설정으로, JSON으로 시리얼라이즈됩니다. |
FleetManagerType(열거형)
사용할 수 있는 플릿 매니저입니다.
| 이름 |
설명 |
Default |
기본 플릿 매니저입니다. |
NoOp |
작업이 없는 플릿 매니저입니다. |
Aws |
AWS EC2 인스턴스를 처리하기 위한 플릿 매니저입니다. 인스턴스를 처음부터 생성 또는 종료합니다. |
AwsReuse |
AWS EC2 인스턴스를 처리하기 위한 플릿 매니저입니다. 기존 EBS 디스크를 재사용하기 위해 이미 존재하지만 중지된 인스턴스를 시작합니다. |
AwsRecycle |
AWS EC2 인스턴스를 처리하기 위한 플릿 매니저입니다. 기존 EBS 디스크를 재사용하기 위해 이미 존재하지만 중지된 인스턴스를 시작합니다. |
AwsAsg |
AWS EC2 인스턴스를 처리하기 위한 플릿 매니저입니다. 실행 중인 인스턴스 수를 제어하기 위해 EC2 Auto Scaling 그룹을 사용합니다. |
LeaseUtilizationSettings
풀의 리스 활용 크기 조정 세팅입니다.
| 이름 |
설명 |
sampleTimeSec |
integer 각 샘플의 기간입니다. |
numSamples |
integer 리스 활용을 계산하기 위해 수집할 샘플 수입니다. |
numSamplesForResult |
integer 유효한 결과를 얻는 데 필요한 최소 샘플 수입니다. |
minAgents |
integer 풀에 유지할 최소 에이전트 수입니다. |
numReserveAgents |
integer 예비로 보유할 최소 유휴 에이전트의 수입니다. |
JobQueueSettings
풀의 작업 큐 크기 조정 세팅입니다.
| 이름 |
설명 |
scaleOutFactor |
number 에이전트를 추가하여 큐 크기를 변경함으로써 풀을 확장하는 인수입니다. 결과는 항상 가장 가까운 정수로 반올림됩니다. 예시: 큐에 20개의 작업이 있는 경우 인수가 0.25이면 5개의 새 에이전트가 추가됩니다(20 * 0.25). |
scaleInFactor |
number 큐가 비어 있을 때 풀 크기를 이 인수만큼 축소합니다. 결과는 항상 가장 가까운 정수로 반올림됩니다. 예시: 큐 크기가 0인 경우 기본값이 0.9이면 풀이 10% 축소됩니다(현재 에이전트 수 * 0.9). |
samplePeriodMin |
integer 잠재적으로 큐에 있는 작업 배치를 얼마나 오래된 것까지 찾을지 지정합니다. |
readyTimeThresholdSec |
integer 고려되기 전 준비 상태에서 에이전트를 대기하면서 소요된 시간입니다. 작업 배치는 선택 및 실행되기 전에 준비 상태일 수 있습니다. 이 한계치는 이 값보다 오래 대기한 배치만 고려되도록 하는 데 도움이 됩니다. |
ComputeQueueAwsMetricSettings
| 이름 |
설명 |
computeClusterId |
string 관찰할 계산 클러스터 ID입니다. |
namespace |
string 메트릭을 작성할 AWS CloudWatch 네임스페이스입니다. |
AgentSoftwareConfig
조건을 평가하여 다양한 에이전트 소프트웨어 버전을 선택합니다.
| 이름 |
설명 |
toolId |
string 툴 식별자입니다. |
condition |
string 이 채널을 사용하기 위한 조건입니다. |
NetworkConfig
네트워크를 설명합니다. ID는 지역, 가용 영역, 랙 또는 사무실 위치 등 모든 논리적인 그룹화를 설명합니다.
| 이름 |
설명 |
id |
string 이 네트워크의 ID입니다. |
cidrBlock |
string CIDR 블록입니다. |
description |
string 사람이 읽을 수 있는 설명입니다. |
computeId |
string 이 네트워크의 계산 ID입니다(계산 리소스 할당 시 사용됨). |
SecretsConfig
암호 시스템에 대한 환경설정입니다.
SecretConfig
암호 값에 대한 환경설정입니다.
| 이름 |
설명 |
id |
string 이 암호의 식별자입니다. |
data |
string -> string 이 암호와 연관된 키/값 쌍입니다. |
sources |
ExternalSecretConfig[] 키/값 쌍을 공급할 제공자입니다. |
acl |
AclConfig 이 특정 암호에 대한 액세스 권한을 정의합니다. |
ExternalSecretConfig
외부 암호 제공자에 대한 환경설정입니다.
| 이름 |
설명 |
provider |
string 사용할 제공자의 이름입니다. |
format |
ExternalSecretFormat 암호의 포맷입니다. |
key |
string 결과 데이터 배열에서 설정할 파라미터를 나타내는 선택적 키입니다. Required if if is . |
path |
string 제공자에서 가져올 대상을 나타내는 선택적 값입니다. |
외부 암호 값을 파싱하는 방식을 설명하는 포맷입니다.
| 이름 |
설명 |
Text |
암호는 외부 암호 키를 사용하여 저장될 일반 텍스트 값입니다. |
Json |
암호는 키/값 쌍이 포함된 JSON 포맷 스트링입니다. |
AnalyticsConfig
분석의 환경설정 세팅입니다.
| 이름 |
설명 |
stores |
TelemetryStoreConfig[] 호드 서버에서 집계할 메트릭입니다. |
BuildConfig
빌드 플러그인에 대한 환경설정입니다.
| 이름 |
설명 |
perforceClusters |
PerforceCluster[] Perforce 클러스터 목록입니다. |
devices |
DeviceConfig 디바이스 환경설정입니다. |
maxConformCount |
integer 한 번에 실행할 최대 일치 수입니다. |
agentShutdownIfDisabledGracePeriod |
string 비활성화된 에이전트를 종료하기 전에 대기할 시간입니다. 실제 풀에 설정된 값이 없는 경우 사용됩니다. |
artifactTypes |
ArtifactTypeConfig[] 다양한 아티팩트 타입에 대한 환경설정입니다. |
projects |
ProjectConfig[] 프로젝트 목록입니다. |
enableConformTasks |
boolean 일치 작업을 실행하도록 허용할지 여부입니다. |
issueFixedTag |
string 문제가 수정된 것으로 표시하기 위해 사용할 커밋 태그입니다. |
PerforceCluster
Perforce 서버의 클러스터에 대한 정보입니다.
| 이름 |
설명 |
name |
string 클러스터의 이름입니다. |
serviceAccount |
string 호드가 이 서버에 로그인하기 위한 사용자 이름입니다. 오버라이드되지 않는 경우 아래에 지정된 첫 번째 계정을 사용합니다. |
canImpersonate |
boolean 서비스 계정이 다른 사용자를 가장할 수 있는지 여부입니다. |
supportsPartitionedWorkspaces |
boolean 이 서버에 분할된 워크스페이스를 사용할지 여부입니다. |
servers |
PerforceServer[] 서버 목록입니다. |
credentials |
PerforceCredentials[] 서버 크리덴셜 목록입니다. |
autoSdk |
AutoSdkWorkspace[] AutoSDK 스트림 목록입니다. |
PerforceServer
개별 Perforce 서버에 대한 정보입니다.
| 이름 |
설명 |
serverAndPort |
string 서버 및 포트입니다. 서버는 여러 기록이 있는 DNS 항목일 수 있으며, 이 경우 로드가 능동적으로 분산됩니다. 접두사 'ssl:'이 사용되는 경우 P4 서버의 지문/인증서 신뢰성이 보장됩니다. SSL이 활성화된 Perforce 서버에 연결하는 방법에 대한 호드 문서를 참고하세요. |
healthCheck |
boolean 각 서버에서 상태 확인 주소를 쿼리할지 여부입니다. |
resolveDns |
boolean DNS 항목을 해석하고 여러 호스트 간에 로드를 분산할지 여부입니다. |
maxConformCount |
integer 이 서버의 최대 동시 일치 수입니다. |
condition |
string 머신이 이 서버를 사용할 자격을 갖추기 위한 선택적 조건입니다. |
properties |
string[] 에이전트가 이 서버를 사용할 자격을 갖추기 위한 프로퍼티의 목록입니다. |
PerforceCredentials
Perforce 사용자의 크리덴셜입니다.
| 이름 |
설명 |
userName |
string 사용자 이름입니다. |
password |
string 사용자의 비밀번호입니다. |
ticket |
string 사용자의 로그인 티켓입니다. 설정된 경우 비밀번호 대신 사용됩니다. |
AutoSdkWorkspace
AutoSDK 동기화에 사용할 플랫폼 및 스트림 경로입니다.
| 이름 |
설명 |
name |
string 이 워크스페이스의 이름입니다. |
properties |
string[] 확인할 에이전트 프로퍼티입니다(예: "OSFamily=Windows") |
userName |
string 서버에 로그인하기 위한 사용자 이름입니다. |
stream |
string 사용할 스트림입니다. |
DeviceConfig
디바이스에 대한 환경설정입니다.
디바이스 플랫폼에 대한 환경설정입니다.
| 이름 |
설명 |
id |
string 이 플랫폼의 ID입니다. |
name |
string 플랫폼의 이름입니다. |
models |
string[] 플랫폼 모델의 목록입니다. |
legacyNames |
string[] 이전 버전의 건틀릿이 사용하고 있을 수 있는 레거시 이름입니다. |
legacyPerfSpecHighModel |
string 고성능 사양의 모델 이름으로, 건틀릿에서 요청될 수 있습니다. |
DevicePoolConfig
디바이스 풀에 대한 환경설정입니다.
| 이름 |
설명 |
id |
string 이 플랫폼의 ID입니다. |
name |
string 풀의 이름입니다. |
poolType |
DevicePoolType 풀의 타입입니다. |
projectIds |
string[] 풀과 연관된 프로젝트 ID의 목록입니다. |
DevicePoolType(열거형)
디바이스 풀의 타입입니다.
| 이름 |
설명 |
Automation |
CIS 작업에 사용할 수 있습니다. |
Shared |
원격 체크인 및 체크아웃을 통해 사용자가 공유합니다. |
ArtifactTypeConfig
아티팩트에 대한 환경설정입니다.
| 이름 |
설명 |
name |
string 레거시 '이름' 프로퍼티입니다. |
type |
string 아티팩트 타입의 이름입니다. |
acl |
AclConfig 아티팩트 타입의 ACL입니다. |
keepCount |
integer 유지할 아티팩트 수입니다. |
keepDays |
integer 이 타입의 아티팩트를 유지할 일수입니다. |
namespaceId |
string 이 아티팩트 타입에 사용할 스토리지 네임스페이스입니다. |
StorageConfig
스토리지에 대한 환경설정입니다.
| 이름 |
설명 |
enableGc |
boolean 가비지 컬렉션을 활성화할지 여부입니다. |
enableGcVerification |
boolean 검증 모드에서 가비지 컬렉션을 활성화할지 여부입니다. 아무것도 삭제되지 않으며, 삭제된 블롭에 액세스 시 로깅만 합니다. |
backends |
BackendConfig[] 스토리지 백엔드의 목록입니다. |
namespaces |
NamespaceConfig[] 스토리지를 위한 네임스페이스의 목록입니다. |
BackendConfig
다양한 제공자의 일반 세팅 오브젝트입니다.
| 이름 |
설명 |
id |
string 스토리지 백엔드 ID입니다. |
base |
string 기본 세팅을 복사할 베이스 백엔드입니다. |
secondary |
string 오브젝트가 이 백엔드에서 발견되지 않는 경우 읽을 또 다른 백엔드를 지정합니다. 한 백엔드에서 다른 백엔드로 데이터를 마이그레이션할 때 사용될 수 있습니다. |
type |
StorageBackendType |
baseDir |
string |
awsBucketName |
string 사용할 버킷의 이름입니다. |
awsBucketPath |
string 버킷 내 베이스 경로입니다. |
awsCredentials |
AwsCredentialsType 사용할 크리덴셜의 타입입니다. |
awsRole |
string 가정할 역할의 ARN입니다. |
awsProfile |
string 크리덴셜 양식을 읽을 AWS 프로파일입니다. |
awsRegion |
string 연결할 지역입니다. |
azureConnectionString |
string Azure용 연결 스트링입니다. |
azureContainerName |
string 컨테이너의 이름입니다. |
relayServer |
string |
relayToken |
string |
gcsBucketName |
string 사용할 GCS 버킷의 이름입니다. |
gcsBucketPath |
string 버킷 내 베이스 경로입니다. |
StorageBackendType(열거형)
사용할 스토리지 백엔드의 타입입니다.
| 이름 |
설명 |
FileSystem |
로컬 파일 시스템입니다. |
Aws |
AWS S3입니다. |
Azure |
Azure 블롭 스토어입니다. |
Gcs |
Google Cloud Storage입니다. |
Memory |
메모리 내에서만 사용할 수 있습니다(테스트 용도). |
AwsCredentialsType(열거형)
AWS에 사용할 크리덴셜입니다.
| 이름 |
설명 |
Default |
AWS SDK의 기본 크리덴셜을 사용합니다. |
Profile |
AWS 환경설정 파일의 프로파일에서 크리덴셜을 읽습니다. |
AssumeRole |
특정 역할을 가정합니다. ARN을 지정해야 합니다. |
AssumeRoleWebIdentity |
현재 환경 변수를 사용하여 특정 역할을 가정합니다. |
NamespaceConfig
특정 네임스페이스의 환경설정입니다.
| 이름 |
설명 |
id |
string 이 네임스페이스의 식별자입니다. |
backend |
string 이 네임스페이스에 사용할 백엔드입니다. |
prefix |
string 이 네임스페이스 내 항목의 접두사입니다. |
gcFrequencyHrs |
number 가비지 컬렉션을 실행하는 빈도입니다(시간 단위). |
gcDelayHrs |
number 새로 업로드된 오펀 오브젝트의 삭제를 허용하기 전에 오브젝트를 보관할 시간입니다(단위: 시간). |
enableAliases |
boolean 에일리어스에 의한 익스포트 쿼리를 지원합니다. |
acl |
AclConfig 이 네임스페이스의 액세스 목록입니다. |
SymbolsConfig
툴 시스템에 대한 환경설정입니다.
SymbolStoreConfig
심볼 스토어에 대한 환경설정입니다.
| 이름 |
설명 |
id |
string 이 스토어의 식별자입니다. |
namespaceId |
string 심볼 스토어 백엔드에 대한 환경설정입니다. |
public |
boolean 인증 없이 이 스토어를 사용할 수 있도록 할지 여부입니다. |
acl |
AclConfig 심볼 스토어에 대한 액세스 권한입니다. |
툴 시스템에 대한 환경설정입니다.
툴을 환경설정하기 위한 옵션입니다.
| 이름 |
설명 |
id |
string 툴의 고유 식별자입니다. |
name |
string 툴의 이름입니다. |
description |
string 툴에 대한 설명입니다. |
category |
string 툴의 카테고리입니다. 툴이 대시보드 내 다른 탭에 표시되도록 합니다. |
group |
string 동일한 툴의 다양한 베리에이션을 위한 그룹화 키입니다. 대시보드에서 함께 표시됩니다. |
platforms |
string[] 이 툴의 플랫폼입니다. NET RID(https://learn.microsoft.com/ko-kr/dotnet/core/rid-catalog)의 형식을 취합니다. |
public |
boolean 이 툴을 인증 없이 공개 엔드포인트에서 다운로드용으로 노출할지 여부입니다. |
showInUgs |
boolean UGS 툴 메뉴에서 이 툴을 다운로드용으로 표시할지 여부입니다. |
showInDashboard |
boolean 대시보드에서 이 툴을 다운로드용으로 표시할지 여부입니다. |
showInToolbox |
boolean 언리얼 툴박스에서 이 툴을 다운로드용으로 표시할지 여부입니다. |
metadata |
string -> string 이 툴의 메타데이터입니다. |
namespaceId |
string 이 툴의 새 디플로이를 위한 기본 네임스페이스입니다. |
acl |
AclConfig 툴의 권한입니다. |
프로젝트
프로젝트에 대한 환경설정을 저장합니다. (*.project.json)
| 이름 |
설명 |
id |
string프로젝트 ID입니다. |
name |
string 새 프로젝트의 이름입니다. |
path |
string 프로젝트 환경설정의 직접 포함 경로입니다. GlobalConfig 오브젝트에서 포함할 때 이전 환경설정 파일과의 호환성을 위해 존재합니다. |
include |
ConfigInclude[] 다른 환경설정 파일의 포함 사항입니다. |
macros |
ConfigMacro[] 글로벌 범위 내 매크로입니다. |
order |
integer 대시보드에서 이 프로젝트의 순서입니다. |
logo |
string 프로젝트 로고에 대한 경로입니다. |
logoDarkTheme |
string 다크 테마용 프로젝트 로고에 대한 선택적 경로입니다. |
pools |
PoolConfig[] 이 프로젝트의 풀 목록입니다. |
categories |
ProjectCategoryConfig[] 이 프로젝트에 포함할 카테고리입니다. |
jobOptions |
JobOptions 작업을 실행하기 위한 기본 세팅입니다. |
workspaceTypes |
string -> WorkspaceConfig 스트림을 위한 기본 워크스페이스 타입입니다. 각 스트림의 워크스페이스 타입 목록에 추가됩니다. |
telemetryStoreId |
string 이 프로젝트의 호드 데이터를 위한 원격 측정 스토어입니다. |
streams |
StreamConfig[] 스트림 목록입니다. |
artifactTypes |
ArtifactTypeConfig[] 아티팩트 타입에 대한 권한입니다. |
acl |
AclConfig ACL 항목입니다. |
ConfigInclude
또 다른 소스의 환경설정 데이터를 병합하기 위한 지시문입니다.
| 이름 |
설명 |
path |
string 환경설정 데이터가 포함될 경로입니다. 포함하는 파일의 위치를 기준으로 할 수 있습니다. |
ConfigMacro
환경설정 매크로를 선언합니다.
| 이름 |
설명 |
name |
string 매크로 프로퍼티의 이름입니다. |
value |
string 매크로 프로퍼티의 값입니다. |
PoolConfig
풀에 대한 변경 가능한 환경설정입니다.
| 이름 |
설명 |
id |
string 이 풀의 고유 ID입니다. |
base |
string 세팅을 복사할 베이스 풀 환경설정입니다. |
name |
string 풀의 이름입니다. |
condition |
string 에이전트가 이 풀에 자동으로 포함되도록 하는 조건입니다. |
properties |
string -> string 이 풀과 관련된 임의 프로퍼티입니다. |
color |
PoolColor 대시보드에서 이 풀에 사용할 컬러입니다. |
enableAutoscaling |
boolean 이 풀에 Auto Scaling을 활성화할지 여부입니다. |
minAgents |
integer 풀에 유지할 최소 에이전트 수입니다. |
numReserveAgents |
integer 예비로 보유할 최소 유휴 에이전트의 수입니다. |
conformInterval |
string 일치 간 간격입니다. 0인 경우 풀이 예약에서 일치를 수행하지 않습니다. |
scaleOutCooldown |
string 스케일 아웃 이벤트 간의 쿨다운 시간입니다. |
scaleInCooldown |
string 스케일 인 이벤트 간의 쿨다운 시간입니다. |
shutdownIfDisabledGracePeriod |
string 비활성화된 에이전트를 종료하기 전에 대기할 시간입니다. |
sizeStrategy |
PoolSizeStrategy |
sizeStrategies |
PoolSizeStrategyInfo[] 이 풀의 풀 크기 조정 전략 목록입니다. 조건이 일치하는 첫 번째 전략이 선택됩니다. |
fleetManagers |
FleetManagerInfo[] 이 풀의 플릿 매니저 목록입니다. 조건이 일치하는 첫 번째 전략이 선택됩니다. 비어 있거나 일치하는 조건이 없는 경우 기본 플릿 매니저가 사용됩니다. |
leaseUtilizationSettings |
LeaseUtilizationSettings 리스 활용 풀 크기 조정 전략의 세팅입니다(사용되는 경우). |
jobQueueSettings |
JobQueueSettings 작업 큐 풀 크기 조정 전략의 세팅입니다(사용되는 경우). |
computeQueueAwsMetricSettings |
ComputeQueueAwsMetricSettings 작업 큐 풀 크기 조정 전략의 세팅입니다(사용되는 경우). |
PoolColor(열거형)
이 풀의 라벨에 사용할 컬러입니다.
| 이름 |
설명 |
Default |
기본 |
Blue |
파란색 |
Orange |
주황색 |
Green |
녹색 |
Gray |
회색 |
PoolSizeStrategy(열거형)
사용할 수 있는 풀 크기 조정 전략입니다.
| 이름 |
설명 |
LeaseUtilization |
리스 활용에 기반한 전략입니다. |
JobQueue |
작업 빌드 큐의 크기에 기반한 전략입니다. |
NoOp |
예비/기본 동작으로 사용되는 작업 없음(No-op) 전략입니다. |
ComputeQueueAwsMetric |
외부 AWS Auto Scaling 정책이 플릿을 스케일 조절하도록 메트릭을 보고하는 작업 없음 전략입니다. |
LeaseUtilizationAwsMetric |
외부 AWS Auto Scaling 정책이 플릿을 스케일 조절하도록 메트릭을 보고하는 작업 없음 전략입니다. |
PoolSizeStrategyInfo
풀 크기 조정 전략을 환경설정 및 선택하기 위한 메타데이터입니다.
| 이름 |
설명 |
type |
PoolSizeStrategy 사용할 전략 구현입니다. |
condition |
string 이 전략을 활성화해야 하는 경우의 조건입니다(현재는 날짜/시간으로 구분함). |
config |
object 전략에 대한 환경설정으로, JSON으로 시리얼라이즈됩니다. |
extraAgentCount |
integer 풀 크기가 계산된 후 추가할 인티저입니다. 음수일 수도 있습니다. |
FleetManagerInfo
플릿 매니저 환경설정 및 선택을 위한 메타데이터입니다.
| 이름 |
설명 |
type |
FleetManagerType 사용할 플릿 매니저 타입 구현입니다. |
condition |
string 이 전략을 활성화해야 하는 경우의 조건입니다(현재는 날짜/시간으로 구분함). |
config |
object 전략에 대한 환경설정으로, JSON으로 시리얼라이즈됩니다. |
FleetManagerType(열거형)
사용할 수 있는 플릿 매니저입니다.
| 이름 |
설명 |
Default |
기본 플릿 매니저입니다. |
NoOp |
작업이 없는 플릿 매니저입니다. |
Aws |
AWS EC2 인스턴스를 처리하기 위한 플릿 매니저입니다. 인스턴스를 처음부터 생성 또는 종료합니다. |
AwsReuse |
AWS EC2 인스턴스를 처리하기 위한 플릿 매니저입니다. 기존 EBS 디스크를 재사용하기 위해 이미 존재하지만 중지된 인스턴스를 시작합니다. |
AwsRecycle |
AWS EC2 인스턴스를 처리하기 위한 플릿 매니저입니다. 기존 EBS 디스크를 재사용하기 위해 이미 존재하지만 중지된 인스턴스를 시작합니다. |
AwsAsg |
AWS EC2 인스턴스를 처리하기 위한 플릿 매니저입니다. 실행 중인 인스턴스 수를 제어하기 위해 EC2 Auto Scaling 그룹을 사용합니다. |
LeaseUtilizationSettings
풀의 리스 활용 크기 조정 세팅입니다.
| 이름 |
설명 |
sampleTimeSec |
integer 각 샘플의 기간입니다. |
numSamples |
integer 리스 활용을 계산하기 위해 수집할 샘플 수입니다. |
numSamplesForResult |
integer 유효한 결과를 얻는 데 필요한 최소 샘플 수입니다. |
minAgents |
integer 풀에 유지할 최소 에이전트 수입니다. |
numReserveAgents |
integer 예비로 보유할 최소 유휴 에이전트의 수입니다. |
JobQueueSettings
풀의 작업 큐 크기 조정 세팅입니다.
| 이름 |
설명 |
scaleOutFactor |
number 에이전트를 추가하여 큐 크기를 변경함으로써 풀을 확장하는 인수입니다. 결과는 항상 가장 가까운 정수로 반올림됩니다. 예시: 큐에 20개의 작업이 있는 경우 인수가 0.25이면 5개의 새 에이전트가 추가됩니다(20 * 0.25). |
scaleInFactor |
number 큐가 비어 있을 때 풀 크기를 이 인수만큼 축소합니다. 결과는 항상 가장 가까운 정수로 반올림됩니다. 예시: 큐 크기가 0인 경우 기본값이 0.9이면 풀이 10% 축소됩니다(현재 에이전트 수 * 0.9). |
samplePeriodMin |
integer 잠재적으로 큐에 있는 작업 배치를 얼마나 오래된 것까지 찾을지 지정합니다. |
readyTimeThresholdSec |
integer 고려되기 전 준비 상태에서 에이전트를 대기하면서 소요된 시간입니다. 작업 배치는 선택 및 실행되기 전에 준비 상태일 수 있습니다. 이 한계치는 이 값보다 오래 대기한 배치만 고려되도록 하는 데 도움이 됩니다. |
ComputeQueueAwsMetricSettings
세팅입니다.
| 이름 |
설명 |
computeClusterId |
string 관찰할 계산 클러스터 ID입니다. |
namespace |
string 메트릭을 작성할 AWS CloudWatch 네임스페이스입니다. |
ProjectCategoryConfig
스트림에 표시할 카테고리에 대한 정보입니다.
| 이름 |
설명 |
name |
string 이 카테고리의 이름입니다. |
row |
integer 이 카테고리를 표시할 행의 인덱스입니다. |
showOnNavMenu |
boolean 내비게이션 메뉴에 이 카테고리를 표시할지 여부입니다. |
includePatterns |
string[] 포함할 스트림 이름의 패턴입니다. |
excludePatterns |
string[] 제외할 스트림 이름의 패턴입니다. |
JobOptions
작업을 실행하기 위한 옵션입니다.
| 이름 |
설명 |
executor |
string 사용할 실행자의 이름입니다. |
useWine |
boolean Linux에서 Wine 에뮬레이션을 사용하여 실행할지 여부입니다. |
runInSeparateProcess |
boolean 별도의 프로세스에서 작업 리스를 실행합니다. |
workspaceMaterializer |
string WorkspaceExecutor에서 사용할 워크스페이스 머티리얼라이저입니다. 워크스페이스 환경설정의 모든 값을 오버라이드합니다. |
container |
JobContainerOptions 컨테이너 내부에서 작업을 실행하기 위한 옵션입니다. |
expireAfterDays |
integer 이 일수가 지나면 작업이 만료됩니다. |
driver |
string 사용할 드라이버의 이름입니다. |
JobContainerOptions
컨테이너 내부에서 작업을 실행하기 위한 옵션입니다.
| 이름 |
설명 |
enabled |
boolean 컨테이너 내부에서 작업을 실행할지 여부입니다. |
imageUrl |
string '컨테이너에 대한 이미지 URL입니다(예: 'quay.io/podman/hello'). |
containerEngineExecutable |
string 컨테이너 엔진 실행 파일입니다(Docker 또는 /usr/bin/podman과 같은 전체 경로) |
extraArguments |
string 컨테이너 엔진에 전달할 추가 실행인자입니다. |
WorkspaceConfig
워크스페이스 타입에 대한 정보입니다.
| 이름 |
설명 |
base |
string 파생시킬 베이스 워크스페이스입니다. |
cluster |
string 사용할 Perforce 서버 클러스터의 이름입니다. |
serverAndPort |
string Perforce 서버 및 포트입니다(예: perforce:1666). |
userName |
string Perforce에 로그인할 사용자입니다(기본값: buildmachine). |
password |
string 워크스페이스에 로그인하는 데 사용할 비밀번호입니다. |
identifier |
string 이 워크스페이스를 다른 워크스페이스와 구별하기 위한 식별자입니다. 기본값은 워크스페이스 타입 이름입니다. |
stream |
string 스트림이 동기화할 오버라이드입니다. |
view |
string[] 워크스페이스의 커스텀 뷰입니다. |
incremental |
boolean 점진적으로 동기화된 워크스페이스를 사용할지 여부입니다. |
useAutoSdk |
boolean AutoSDK를 사용할지 여부입니다. |
autoSdkView |
string[] 동기화할 AutoSDK 경로의 뷰입니다. null인 경우 모든 항목이 동기화됩니다. |
method |
string Perforce에서 데이터를 동기화/머티리얼화할 때 사용할 메서드입니다. |
minScratchSpace |
integer 이 워크스페이스를 동기화한 후 사용할 수 있어야 하는 최소 디스크 공간(단위: MB)입니다. 사용할 수 없는 경우 작업이 중단됩니다. |
conformDiskFreeSpace |
integer 에이전트의 자동 일치를 트리거하는 시점에 대한 한계치입니다. 디스크의 여유 공간을 MB 단위로 측정합니다. null 또는 0으로 설정하면 비활성화됩니다. |
ArtifactTypeConfig
아티팩트에 대한 환경설정입니다.
| 이름 |
설명 |
name |
string 레거시 '이름' 프로퍼티입니다. |
type |
string 아티팩트 타입의 이름입니다. |
acl |
AclConfig 아티팩트 타입의 ACL입니다. |
keepCount |
integer 유지할 아티팩트 수입니다. |
keepDays |
integer 이 타입의 아티팩트를 유지할 일수입니다. |
namespaceId |
string 이 아티팩트 타입에 사용할 스토리지 네임스페이스입니다. |
AclConfig
ACL을 업데이트하는 파라미터입니다.
| 이름 |
설명 |
entries |
AclEntryConfig[] 기존 ACL을 대체할 항목입니다. |
profiles |
AclProfileConfig[] 액션 세트를 명명된 컬렉션으로 그룹화하도록 허용하는 프로파일을 정의합니다. |
inherit |
boolean 부모 ACL에서 권한을 상속할지 여부입니다. |
exceptions |
string[] 상속된 세팅에 대한 예외 목록입니다. |
AclEntryConfig
ACL 내 개별 항목입니다.
| 이름 |
설명 |
claim |
AclClaimConfig 사용자 또는 그룹의 이름입니다. |
actions |
string[] 허용할 액션의 배열입니다. |
profiles |
string[] 부여할 프로파일의 목록입니다. |
AclClaimConfig
생성할 새 클레임입니다.
| 이름 |
설명 |
type |
string 클레임 타입입니다. |
value |
string 클레임 값입니다. |
AclProfileConfig
ACL 프로파일에 대한 환경설정입니다. ACL 항목을 통해 사용자에게 부여할 수 있는 액션의 프리셋 그룹을 정의합니다.
| 이름 |
설명 |
id |
string 이 프로파일의 식별자입니다. |
actions |
string[] 포함할 액션입니다. |
excludeActions |
string[] 상속된 액션에서 제외할 액션입니다. |
extends |
string[] 확장할 다른 프로파일입니다. |
스트림
스트림에 대한 환경설정입니다. (*.stream.json)
| 이름 |
설명 |
id |
string 스트림의 식별자입니다. |
path |
string 스트림 환경설정의 직접 포함 경로입니다. ProjectConfig 오브젝트에서 포함할 때 이전 환경설정 파일과의 호환성을 위해 존재합니다. |
include |
ConfigInclude[] 다른 환경설정 파일의 포함 사항입니다. |
macros |
ConfigMacro[] 이 스트림 내 매크로입니다. |
name |
string 스트림의 이름입니다. |
enginePath |
string 워크스페이스 내 엔진 디렉터리에 대한 경로입니다. UAT를 실행하는 데 사용됩니다. |
clusterName |
string 스트림이 포함된 Perforce 클러스터입니다. |
order |
integer 이 스트림의 순서입니다. |
initialAgentType |
string 템플릿을 위한 기본 초기 에이전트 타입입니다. |
notificationChannel |
string 이 스트림 내 모든 작업에 대한 알림 채널입니다. |
notificationChannelFilter |
string 이 템플릿에 대한 알림 채널 필터입니다. 성공(Success), 실패(Failure) 또는 경고(Warnings)일 수 있습니다. |
triageChannel |
string 문제 분류 알림을 게시할 채널입니다. |
jobOptions |
JobOptions 작업을 실행하기 위한 기본 세팅입니다. |
telemetryStoreId |
string 이 스트림의 호드 데이터를 위한 원격 측정 스토어입니다. |
autoSdkView |
string[] 동기화할 AutoSDK 경로의 뷰입니다. null인 경우 모든 항목이 동기화됩니다. |
defaultPreflightTemplate |
string 기본 프리플라이트 템플릿의 레거시 이름입니다. |
defaultPreflight |
DefaultPreflightConfig 프리플라이트 실행을 위한 기본 템플릿입니다. |
commitTags |
CommitTagConfig[] 커밋에 적용할 태그의 목록입니다. 다양한 커밋 타입을 빠르게 검색하고 분류할 수 있습니다(예: 코드와 콘텐츠). |
tabs |
TabConfig[] 새 스트림에 표시할 탭의 목록입니다. |
environment |
string -> string 이 스트림 내 모든 에이전트의 글로벌 환경 변수입니다. |
agentTypes |
string -> AgentConfig 에이전트 이름을 타입에 매핑합니다. |
workspaceTypes |
string -> WorkspaceConfig 워크스페이스 이름을 타입에 매핑합니다. |
templates |
TemplateRefConfig[] 생성할 템플릿의 목록입니다. |
acl |
AclConfig 이 오브젝트의 커스텀 권한입니다. |
pausedUntil |
string 지정된 날짜까지 스트림 빌드를 일시정지합니다. |
pauseComment |
string 스트림의 빌드를 일시정지하는 이유입니다. |
replicators |
ReplicatorConfig[] 작업자가 커밋 데이터를 호드 스토리지로 리플리케이트하기 위한 환경설정입니다. |
workflows |
WorkflowConfig[] 새로운 문제를 해결하기 위한 워크플로입니다. |
tokens |
TokenConfig[] 각 작업 단계마다 생성할 토큰입니다. |
artifactTypes |
ArtifactTypeConfig[] 아티팩트 타입에 대한 권한입니다. |
ConfigInclude
또 다른 소스의 환경설정 데이터를 병합하기 위한 지시문입니다.
| 이름 |
설명 |
path |
string 환경설정 데이터가 포함될 경로입니다. 포함하는 파일의 위치를 기준으로 할 수 있습니다. |
ConfigMacro
환경설정 매크로를 선언합니다.
| 이름 |
설명 |
name |
string 매크로 프로퍼티의 이름입니다. |
value |
string 매크로 프로퍼티의 값입니다. |
JobOptions
작업을 실행하기 위한 옵션입니다.
| 이름 |
설명 |
executor |
string 사용할 실행자의 이름입니다. |
useWine |
boolean Linux에서 Wine 에뮬레이션을 사용하여 실행할지 여부입니다. |
runInSeparateProcess |
boolean 별도의 프로세스에서 작업 리스를 실행합니다. |
workspaceMaterializer |
string WorkspaceExecutor에서 사용할 워크스페이스 머티리얼라이저입니다. 워크스페이스 환경설정의 모든 값을 오버라이드합니다. |
container |
JobContainerOptions 컨테이너 내부에서 작업을 실행하기 위한 옵션입니다. |
expireAfterDays |
integer 이 일수가 지나면 작업이 만료됩니다. |
driver |
string 사용할 드라이버의 이름입니다. |
JobContainerOptions
컨테이너 내부에서 작업을 실행하기 위한 옵션입니다.
| 이름 |
설명 |
enabled |
boolean 컨테이너 내부에서 작업을 실행할지 여부입니다. |
imageUrl |
string '컨테이너에 대한 이미지 URL입니다(예: 'quay.io/podman/hello'). |
containerEngineExecutable |
string 컨테이너 엔진 실행 파일입니다(Docker 또는 /usr/bin/podman과 같은 전체 경로) |
extraArguments |
string 컨테이너 엔진에 전달할 추가 실행인자입니다. |
DefaultPreflightConfig
프리플라이트를 실행하기 위한 기본값을 지정합니다.
ChangeQueryConfig
사용할 베이스 체인지리스트를 선택하는 쿼리입니다.
| 이름 |
설명 |
name |
string 이 쿼리의 이름으로, 대시보드에 표시하는 용도입니다. |
condition |
string 이 쿼리를 사용하기로 결정하기 전에 평가할 조건입니다. 프리플라이트에서 태그를 쿼리할 수도 있습니다. |
templateId |
string 쿼리할 템플릿 ID입니다. |
target |
string 쿼리할 타깃입니다. |
outcomes |
JobStepOutcome[] 경고가 발생한 작업과 일치시킬지 여부입니다. |
commitTag |
string 이 태그로 마지막 커밋을 찾습니다. |
JobStepOutcome(열거형)
작업 단계의 결과입니다.
| 이름 |
설명 |
Unspecified |
결과를 알 수 없습니다. |
Failure |
단계가 실패했습니다. |
Warnings |
경고가 표시된 상태로 단계가 완료되었습니다. |
Success |
단계가 성공했습니다. |
CommitTagConfig
커스텀 커밋 필터에 대한 환경설정입니다.
| 이름 |
설명 |
name |
string 태그의 이름입니다. |
base |
string 세팅을 복사할 베이스 태그입니다. |
filter |
string[] 이 필터에 포함될 파일의 목록입니다. |
TabConfig
스트림에 대해 대시보드에 표시할 페이지 관련 정보입니다.
| 이름 |
설명 |
title |
string 이 페이지의 제목입니다. |
type |
string 이 탭의 타입입니다. |
style |
TabStyle 이 페이지의 프레젠테이션 스타일입니다. |
showNames |
boolean 이 페이지에 작업 이름을 표시할지 여부입니다. |
showPreflights |
boolean 모든 사용자 프리플라이트를 표시할지 여부입니다. |
jobNames |
string[] 이 페이지에 포함할 작업의 이름입니다. 지정된 이름이 하나밖에 없는 경우 이름 열을 표시할 필요가 없습니다. |
templates |
string[] 이 페이지에 표시할 작업 템플릿 이름의 목록입니다. |
columns |
TabColumnConfig[] 다양한 집계 타입을 표시할 열입니다. |
TabStyle(열거형)
탭을 렌더링하기 위한 스타일입니다.
| 이름 |
설명 |
Normal |
정규 작업 목록입니다. |
Compact |
작업 이름을 생략하여 뷰를 간결하게 표시합니다. |
TabColumnConfig
작업 페이지에 표시할 열을 설명합니다.
| 이름 |
설명 |
type |
TabColumnType 열의 타입입니다. |
heading |
string 이 열의 헤딩입니다. |
category |
string 이 열에 표시할 집계의 카테고리입니다. null인 경우 다른 열과 일치하지 않는 모든 집계를 포함합니다. |
parameter |
string 이 열에 표시할 파라미터입니다. |
relativeWidth |
integer 이 열의 상대적 너비입니다. |
TabColumnType(열거형)
작업 탭에 있는 열의 타입입니다.
| 이름 |
설명 |
Labels |
라벨이 포함됩니다. |
Parameter |
파라미터가 포함됩니다. |
AgentConfig
BuildGraph 에이전트 타입과 팜의 머신 세트의 매핑입니다.
| 이름 |
설명 |
base |
string 세팅을 상속할 베이스 에이전트 환경설정입니다. |
pool |
string 이 에이전트 타입에 사용할 에이전트의 풀입니다. |
workspace |
string 동기화할 워크스페이스의 이름입니다. |
tempStorageDir |
string 임시 스토리지 디렉터리에 대한 경로입니다. |
environment |
string -> string 작업을 실행할 때 설정될 환경 변수입니다. |
tokens |
TokenConfig[] 이 에이전트 타입에 할당할 토큰입니다. |
TokenConfig
각 작업에 액세스 토큰을 할당하기 위한 환경설정입니다.
| 이름 |
설명 |
url |
string 토큰을 요청할 URL입니다. |
clientId |
string 새 토큰을 요청하는 데 사용할 클라이언트 ID입니다. |
clientSecret |
string 새 액세스 토큰을 요청하기 위한 클라이언트 암호입니다. |
envVar |
string 액세스 토큰으로 설정할 환경 변수입니다. |
WorkspaceConfig
워크스페이스 타입에 대한 정보입니다.
| 이름 |
설명 |
base |
string 파생시킬 베이스 워크스페이스입니다. |
cluster |
string 사용할 Perforce 서버 클러스터의 이름입니다. |
serverAndPort |
string Perforce 서버 및 포트입니다(예: perforce:1666). |
userName |
string Perforce에 로그인할 사용자입니다(기본값: buildmachine). |
password |
string 워크스페이스에 로그인하는 데 사용할 비밀번호입니다. |
identifier |
string 이 워크스페이스를 다른 워크스페이스와 구별하기 위한 식별자입니다. 기본값은 워크스페이스 타입 이름입니다. |
stream |
string 스트림이 동기화할 오버라이드입니다. |
view |
string[] 워크스페이스의 커스텀 뷰입니다. |
incremental |
boolean 점진적으로 동기화된 워크스페이스를 사용할지 여부입니다. |
useAutoSdk |
boolean AutoSDK를 사용할지 여부입니다. |
autoSdkView |
string[] 동기화할 AutoSDK 경로의 뷰입니다. null인 경우 모든 항목이 동기화됩니다. |
method |
string Perforce에서 데이터를 동기화/머티리얼화할 때 사용할 메서드입니다. |
minScratchSpace |
integer 이 워크스페이스를 동기화한 후 사용할 수 있어야 하는 최소 디스크 공간(단위: MB)입니다. 사용할 수 없는 경우 작업이 중단됩니다. |
conformDiskFreeSpace |
integer 에이전트의 자동 일치를 트리거하는 시점에 대한 한계치입니다. 디스크의 여유 공간을 MB 단위로 측정합니다. null 또는 0으로 설정하면 비활성화됩니다. |
TemplateRefConfig
스트림 내에서 템플릿을 생성하는 파라미터입니다.
| 이름 |
설명 |
id |
string 이 레퍼런스에 대한 선택적 식별자입니다. 지정되지 않은 경우 ID가 이름에서 생성됩니다. |
base |
string 복사할 베이스 템플릿 ID입니다. |
showUgsBadges |
boolean 이러한 작업에서 UGS에 배지를 표시할지 여부입니다. |
showUgsAlerts |
boolean 이러한 작업에서 UGS에 경고를 표시할지 여부입니다. |
notificationChannel |
string 이 템플릿에 대한 알림 채널입니다. 설정된 경우 스트림 채널을 오버라이드합니다. |
notificationChannelFilter |
string 이 템플릿에 대한 알림 채널 필터입니다. '성공(Success)', '실패(Failure)', '경고(Warnings)'의 조합이 될 수 있으며, 파이프 문자로 구분됩니다. |
triageChannel |
string 이 템플릿에 대한 분류 채널입니다. 설정된 경우 스트림 채널을 오버라이드합니다. |
workflowId |
string 이 스트림에 사용할 워크플로입니다. |
annotations |
string -> string 이 템플릿의 노드에 적용할 기본 주석입니다. |
schedule |
ScheduleConfig 이 템플릿을 실행할 예약입니다. |
chainedJobs |
ChainedJobTemplateConfig[] 연쇄 작업 트리거의 목록입니다. |
acl |
AclConfig 이 템플릿에 대한 ACL입니다. |
name |
string 새 템플릿의 이름입니다. |
description |
string 템플릿에 대한 설명입니다. |
priority |
Priority 이 작업의 기본 우선순위입니다. |
allowPreflights |
boolean 이 템플릿의 프리플라이트를 허용할지 여부입니다. |
updateIssues |
boolean 이 템플릿을 사용하는 모든 작업에 대해 문제를 업데이트할지 여부입니다. |
promoteIssuesByDefault |
boolean 이 템플릿에서 기본적으로 문제를 승격할지 여부입니다. 문제를 승격하면 사용자 알림이 생성됩니다. |
initialAgentType |
string BuildGraph 스크립트를 파싱할 초기 에이전트 타입입니다. |
submitNewChange |
string 작업의 새 체인지리스트를 생성하기 위해 제출할 스트림 내 파일에 대한 경로입니다. |
submitDescription |
string 새 체인지리스트에 대한 설명입니다. |
defaultChange |
ChangeQueryConfig[] 빌드할 기본 변경사항입니다. 각 오브젝트에는 어떤 변경사항을 사용할지 결정하기 위해 서버에서 평가할 수 있는 조건 파라미터가 있습니다. |
arguments |
string[] 새 작업의 고정 실행인자입니다. |
parameters |
TextParameterData/ListParameterData/BoolParameterData[] 이 템플릿에 대한 파라미터입니다. |
jobOptions |
JobOptions 작업의 기본 세팅입니다. |
ScheduleConfig
새 예약을 생성하는 파라미터입니다.
| 이름 |
설명 |
claims |
AclClaimConfig[] 이 예약에 대해 가장할 역할입니다. |
enabled |
boolean 예약이 활성화되어야 하는지 여부입니다. |
maxActive |
integer 한 번에 활성화할 수 있는 최대 빌드 수입니다. |
maxChanges |
integer 예약이 헤드 리비전보다 늦어질 수 있는 최대 변경사항 수입니다. 0보다 큰 경우 백로그가 이 크기가 될 때까지 체인지리스트가 제출될 때마다 빌드가 트리거됩니다. |
requireSubmittedChange |
boolean 빌드에서 변경사항 제출이 필요한지 여부입니다. |
gate |
ScheduleGateConfig 예약이 트리거되도록 허용하는 게이트입니다. |
commits |
string[] 이 예약의 커밋 태그입니다. |
filter |
ChangeContentFlags[] 실행할 변경사항의 타입입니다. |
files |
string[] 작업이 트리거되도록 해야 하는 파일입니다. |
templateParameters |
string -> string 템플릿의 파라미터입니다. |
patterns |
SchedulePatternConfig[] 예약의 새 패턴입니다. |
AclClaimConfig
생성할 새 클레임입니다.
| 이름 |
설명 |
type |
string 클레임 타입입니다. |
value |
string 클레임 값입니다. |
ScheduleGateConfig
예약이 트리거되도록 허용하는 게이트입니다.
| 이름 |
설명 |
templateId |
string 종속성이 포함된 템플릿입니다. |
target |
string 대기할 타깃입니다. |
ChangeContentFlags(열거형)
체인지리스트의 콘텐츠를 식별하는 플래그입니다.
| 이름 |
설명 |
ContainsCode |
변경사항에 코드가 포함됩니다. |
ContainsContent |
변경사항에 콘텐츠가 포함됩니다. |
SchedulePatternConfig
새 예약을 생성하는 파라미터입니다.
| 이름 |
설명 |
daysOfWeek |
DayOfWeek[] 이 예약을 실행할 요일입니다. null인 경우 예약이 매일 실행됩니다. |
minTime |
string 첫 번째 예약이 트리거되는 하루 중 시간입니다. 자정부터 분 단위로 측정됩니다. |
maxTime |
string 마지막 예약이 트리거되는 하루 중 시간입니다. 자정부터 분 단위로 측정됩니다. |
interval |
string 각 예약 트리거 사이의 간격입니다. |
DayOfWeek(열거형)
| 이름 |
설명 |
Sunday |
일요일 |
Monday |
월요일 |
Tuesday |
화요일 |
Wednesday |
수요일 |
Thursday |
목요일 |
Friday |
금요일 |
Saturday |
토요일 |
ChainedJobTemplateConfig
다른 템플릿에 대한 트리거입니다.
| 이름 |
설명 |
trigger |
string 다른 템플릿을 시작하기 전에 완료해야 하는 타깃의 이름입니다. |
templateId |
string 트리거할 템플릿의 ID입니다. |
useDefaultChangeForTemplate |
boolean 부모 작업의 변경사항이 아닌 템플릿의 기본 변경사항을 사용할지 여부입니다. |
AclConfig
ACL을 업데이트하는 파라미터입니다.
| 이름 |
설명 |
entries |
AclEntryConfig[] 기존 ACL을 대체할 항목입니다. |
profiles |
AclProfileConfig[] 액션 세트를 명명된 컬렉션으로 그룹화하도록 허용하는 프로파일을 정의합니다. |
inherit |
boolean 부모 ACL에서 권한을 상속할지 여부입니다. |
exceptions |
string[] 상속된 세팅에 대한 예외 목록입니다. |
AclEntryConfig
ACL 내 개별 항목입니다.
| 이름 |
설명 |
claim |
AclClaimConfig 사용자 또는 그룹의 이름입니다. |
actions |
string[] 허용할 액션의 배열입니다. |
profiles |
string[] 부여할 프로파일의 목록입니다. |
AclProfileConfig
ACL 프로파일에 대한 환경설정입니다. ACL 항목을 통해 사용자에게 부여할 수 있는 액션의 프리셋 그룹을 정의합니다.
| 이름 |
설명 |
id |
string 이 프로파일의 식별자입니다. |
actions |
string[] 포함할 액션입니다. |
excludeActions |
string[] 상속된 액션에서 제외할 액션입니다. |
extends |
string[] 확장할 다른 프로파일입니다. |
Priority(열거형)
작업 또는 단계의 우선순위입니다.
| 이름 |
설명 |
Unspecified |
지정되지 않음 |
Lowest |
우선순위 가장 낮음 |
BelowNormal |
우선순위 보통 미만 |
Normal |
우선순위 보통 |
AboveNormal |
우선순위 보통 초과 |
High |
우선순위 높음 |
Highest |
우선순위 가장 높음 |
TextParameterData
자유 형식의 텍스트 입력 파라미터입니다.
| 이름 |
설명 |
type |
텍스트 타입 판별기입니다. |
id |
string 이 파라미터의 식별자입니다. |
label |
string 이 파라미터와 연관된 파라미터의 이름입니다. |
argument |
string 실행자에 전달할 실행인자입니다. |
default |
string 이 실행인자의 기본값입니다. |
scheduleOverride |
string 예약된 빌드를 실행할 때 이 파라미터의 기본값에 대한 오버라이드입니다. |
hint |
string 이 파라미터의 힌트 텍스트입니다. |
validation |
string 이 파라미터의 유효성을 검사하는 데 사용되는 정규 표현식입니다. |
validationError |
string 유효성 검사에 실패하면 표시되는 메시지로, 사용자에게 유효한 값을 알립니다. |
toolTip |
string 표시할 툴팁 텍스트입니다. |
ListParameterData
사용자가 제한된 선택지 목록에서 값을 선택하도록 허용합니다.
ListParameterStyle(열거형)
목록 파라미터의 스타일입니다.
| 이름 |
설명 |
List |
일반적인 드롭다운 목록입니다. 하나의 항목이 항상 선택됩니다. |
MultiList |
체크 박스가 있는 드롭다운 목록입니다. |
TagPicker |
옵션 목록의 태그 선택 툴입니다. |
ListParameterItemData
목록 파라미터에 가능한 옵션입니다.
| 이름 |
설명 |
id |
string 이 파라미터의 식별자입니다. |
group |
string 선택 툴 스타일이 지원하는 경우 아래에 이 항목을 표시할 선택적 그룹 헤딩입니다. |
text |
string 이 목록과 연관된 파라미터의 이름입니다. |
argumentIfEnabled |
string 이 파라미터로 전달할 단일 실행인자입니다. |
argumentsIfEnabled |
string[] 이 파라미터로 전달할 다수의 실행인자입니다. |
argumentIfDisabled |
string 이 파라미터로 전달할 단일 실행인자입니다. |
argumentsIfDisabled |
string[] 이 파라미터가 비활성화된 경우 전달할 다수의 실행인자입니다. |
default |
boolean 이 항목이 기본적으로 선택되는지 여부입니다. |
scheduleOverride |
boolean 예약 빌드에서 이 프로퍼티에 오버라이드된 값입니다. |
BoolParameterData
사용자가 옵션을 토글하여 켜거나 끌 수 있도록 허용합니다.
| 이름 |
설명 |
type |
부울 타입 판별기입니다. |
id |
string 이 파라미터의 식별자입니다. |
label |
string 이 파라미터와 연관된 파라미터의 이름입니다. |
argumentIfEnabled |
string 이 파라미터가 활성화된 경우 추가할 단일 실행인자입니다. |
argumentsIfEnabled |
string[] 이 파라미터가 활성화된 경우 추가할 다수의 실행인자입니다. |
argumentIfDisabled |
string 이 파라미터가 비활성화된 경우 추가할 단일 실행인자입니다. |
argumentsIfDisabled |
string[] 이 파라미터가 비활성화된 경우 추가할 다수의 실행인자입니다. |
default |
boolean 이 실행인자가 기본적으로 활성화되는지 여부입니다. |
scheduleOverride |
boolean 예약된 빌드에서 이 파라미터에 대한 오버라이드입니다. |
toolTip |
string 표시할 툴팁 텍스트입니다. |
ReplicatorConfig
스트림 리플리케이터에 대한 환경설정입니다.
| 이름 |
설명 |
id |
string 현재 스트림 내 리플리케이터의 식별자입니다. |
enabled |
boolean 리플리케이터가 활성화되는지 여부입니다. |
minChange |
integer 리플리케이트할 최소 변경사항 수입니다. |
maxChange |
integer 리플리케이트할 최대 변경사항 수입니다. |
includeContent |
boolean 리플리케이션에 콘텐츠를 포함할지 또는 메타데이터만 포함할지 여부입니다. |
namespaceId |
string 데이터를 리플리케이트할 네임스페이스입니다. |
WorkflowConfig
문제 워크플로에 대한 환경설정입니다.
| 이름 |
설명 |
id |
string 이 워크플로의 식별자입니다. |
reportTimes |
string[] 리포트를 전송할 하루 중 시간입니다. |
summaryTab |
string 요약 데이터를 게시할 탭의 이름입니다. |
reportChannel |
string 이 템플릿에 대한 요약 정보를 게시할 채널입니다. |
reportWarnings |
boolean 요약에 경고 상태인 문제를 포함할지 여부입니다. |
groupIssuesByTemplate |
boolean 리포트에서 템플릿으로 문제를 그룹화할지 여부입니다. |
triageChannel |
string 새로운 문제를 분류하기 위한 스레드를 게시할 채널입니다. |
triagePrefix |
string 모든 분류 메시지의 접두사입니다. |
triageSuffix |
string 모든 분류 메시지의 접미사입니다. |
triageInstructions |
string 스레드를 분류하기 위해 게시된 인스트럭션입니다. |
triageAlias |
string 기본적으로 문제에 할당된 사람이 없는 경우 핑할 Slack 사용자/에일리어스의 사용자 ID입니다. |
triageTypeAliases |
string -> string 기본적으로 문제에 할당된 사람이 없는 경우 특정 문제 타입(예: Systemic)에 핑할 Slack 사용자/에일리어스입니다. |
escalateAlias |
string 문제가 일정 시간 동안 해결되지 않은 경우 핑할 에일리어스입니다. |
escalateTimes |
integer[] 문제가 공개된 후 위의 에일리어스로 에스컬레이트하기까지의 시간입니다(단위: 분). 목록 끝에 도달하면 마지막 간격으로 계속 알림을 보냅니다. |
maxMentions |
integer 분류 스레드에서 언급할 최대 인원수입니다. |
allowMentions |
boolean 이 스레드에서 사람을 언급할지 여부입니다. 테스트를 위해 비활성화하는 데 유용합니다. |
inviteRestrictedUsers |
boolean 채널에 사용자를 초대하는 데 admin.conversations.invite API를 사용합니다. |
skipWhenEmpty |
boolean 활성 상태의 문제가 없으면 리포트 전송을 건너뜁니다. |
showMergeWarnings |
boolean 변경사항을 원본 스트림으로 병합하는 것에 대한 경고를 표시할지 여부입니다. |
annotations |
string -> string 이 워크플로에서 묵시적인 추가 노드 주석입니다. |
externalIssues |
ExternalIssueConfig 이 워크플로에 대한 외부 문제 트래킹 환경설정입니다. |
issueHandlers |
string[] 이 워크플로에 활성화된 추가 문제 핸들러입니다. |
ExternalIssueConfig
워크플로에 대한 외부 문제 트래킹 환경설정입니다.
| 이름 |
설명 |
projectKey |
string 외부 이슈 트래커 내 프로젝트 키입니다. |
defaultComponentId |
string 워크플로를 사용하는 문제의 기본 컴포넌트 ID입니다. |
defaultIssueTypeId |
string 워크플로를 사용하는 문제의 기본 문제 타입 ID입니다. |
ArtifactTypeConfig
아티팩트에 대한 환경설정입니다.
| 이름 |
설명 |
name |
string 레거시 '이름' 프로퍼티입니다. |
type |
string 아티팩트 타입의 이름입니다. |
acl |
AclConfig 아티팩트 타입의 ACL입니다. |
keepCount |
integer 유지할 아티팩트 수입니다. |
keepDays |
integer 이 타입의 아티팩트를 유지할 일수입니다. |
namespaceId |
string 이 아티팩트 타입에 사용할 스토리지 네임스페이스입니다. |
원격 측정
메트릭에 대한 환경설정입니다. (*.telemetry.json)
AclConfig
ACL을 업데이트하는 파라미터입니다.
| 이름 |
설명 |
entries |
AclEntryConfig[] 기존 ACL을 대체할 항목입니다. |
profiles |
AclProfileConfig[] 액션 세트를 명명된 컬렉션으로 그룹화하도록 허용하는 프로파일을 정의합니다. |
inherit |
boolean 부모 ACL에서 권한을 상속할지 여부입니다. |
exceptions |
string[] 상속된 세팅에 대한 예외 목록입니다. |
AclEntryConfig
ACL 내 개별 항목입니다.
| 이름 |
설명 |
claim |
AclClaimConfig 사용자 또는 그룹의 이름입니다. |
actions |
string[] 허용할 액션의 배열입니다. |
profiles |
string[] 부여할 프로파일의 목록입니다. |
AclClaimConfig
생성할 새 클레임입니다.
| 이름 |
설명 |
type |
string 클레임 타입입니다. |
value |
string 클레임 값입니다. |
AclProfileConfig
ACL 프로파일에 대한 환경설정입니다. ACL 항목을 통해 사용자에게 부여할 수 있는 액션의 프리셋 그룹을 정의합니다.
| 이름 |
설명 |
id |
string 이 프로파일의 식별자입니다. |
actions |
string[] 포함할 액션입니다. |
excludeActions |
string[] 상속된 액션에서 제외할 액션입니다. |
extends |
string[] 확장할 다른 프로파일입니다. |
MetricConfig
서버에서 집계할 메트릭을 환경설정합니다.
| 이름 |
설명 |
id |
string 이 메트릭의 식별자입니다. |
filter |
string 포함할 이벤트를 결정하기 위해 평가할 필터 표현식입니다. 이 쿼리는 배열에 대해 평가됩니다. |
property |
string 집계할 프로퍼티입니다. |
groupBy |
string 그룹화할 프로퍼티입니다. JSON 경로 표현식의 쉼표로 구분된 목록으로 지정됩니다. |
function |
AggregationFunction 이 메트릭의 샘플을 집계하는 방식입니다. |
percentile |
integer 백분위수 함수에서 측정할 백분위수를 지정합니다. |
interval |
string 각 메트릭의 간격입니다. '2일(2d)', '1시간(1h)', '1시간 30분(1h30m)', '20초(20s)'와 같은 시간을 지원합니다. |
AggregationFunction(열거형)
샘플을 메트릭으로 집계하기 위한 메서드입니다.
| 이름 |
설명 |
Count |
일치하는 엘리먼트의 수를 셉니다. |
Min |
모든 샘플의 최솟값을 받습니다. |
Max |
모든 샘플의 최댓값을 받습니다. |
Sum |
보고된 모든 값을 합산합니다. |
Average |
모든 샘플의 평균을 냅니다. |
Percentile |
특정 백분위수로 값을 추정합니다. |
TelemetryViewConfig
관련 메트릭의 원격 측정 뷰로, 여러 카테고리로 나뉩니다.
TelemetryVariableConfig
차트 데이터를 필터링하는 데 사용되는 원격 측정 뷰 변수입니다.
| 이름 |
설명 |
name |
string 표시 용도의 변수 이름입니다. |
group |
string 변수에 어태치된 연관 데이터 그룹입니다. |
defaults |
string[] 선택할 기본값입니다. |
TelemetryCategoryConfig
차트 카테고리로, 연관 피벗 아래 대시보드에 표시됩니다.
TelemetryChartConfig
원격 측정 차트 환경설정입니다.
TelemetryMetricUnitType(열거형)
원격 측정을 표시하는 데 사용되는 유닛입니다.
| 이름 |
설명 |
Time |
지속 시간입니다. |
Ratio |
비율(0~100%)입니다 |
Value |
임의의 숫자 값입니다 |
TelemetryMetricGraphType(열거형)
타입입니다.
| 이름 |
설명 |
Line |
선 그래프입니다. |
Indicator |
한계치가 있는 핵심 성과 지표(Key Performance Indicator, KPI) 차트입니다. |
TelemetryChartMetricConfig
원격 측정 차트에 어태치된 메트릭입니다.
| 이름 |
설명 |
id |
string 연관된 메트릭 ID입니다. |
threshold |
integer KPI 값의 한계치입니다. |
alias |
string 표시 용도의 메트릭 에일리어스입니다. |
ConfigInclude
또 다른 소스의 환경설정 데이터를 병합하기 위한 지시문입니다.
| 이름 |
설명 |
path |
string 환경설정 데이터가 포함될 경로입니다. 포함하는 파일의 위치를 기준으로 할 수 있습니다. |
ConfigMacro
환경설정 매크로를 선언합니다.
| 이름 |
설명 |
name |
string 매크로 프로퍼티의 이름입니다. |
value |
string 매크로 프로퍼티의 값입니다. |
