명명 제한 사항 및 규칙
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Azure DevOps의 대부분의 구성 요소는 명명 제한 및 규칙을 따라야 합니다. 제한 사항은 일관된 사용자 환경을 보장하고 다른 애플리케이션과의 호환성을 제공하는 데 도움이 됩니다.
일반적인 제한 사항에는 이름의 문자 길이를 초과하지 않고 특수 문자를 포함하지 않고 개체 집합 내에서 이름의 고유성을 유지하는 것이 포함됩니다.
Important
UI(사용자 인터페이스) 대신 API를 사용하는 경우 API를 사용하면 UI에서 제한될 수 있는 문자를 포함하는 이름을 직접 지정할 수 있습니다.
모범 사례:
- 일관성을 유지하고 의도하지 않은 문제를 방지하려면 UI 제한에 따릅니다.
- 프로그래밍 방식으로 이름의 유효성을 검사하고 특수 문자를 적절하게 처리합니다.
일반적인 고려 사항
이 문서의 길이 제한은 허용되는 유니코드 문자 수로 측정됩니다. 서로게이트 문자는 길이 제한에 대해 두 문자로 계산되는 두 개의 유니코드 문자로 구성됩니다. 자세한 내용은 유니코드 및 문자 집합 정보를 참조 하세요.
다른 운영 체제 파일과 마찬가지로 ASCII 컨트롤 문자(ASCII 1-31) 및 서로게이트 조합도 허용되지 않습니다. 파일 이름에 적용되는 운영 체제 제한 사항에 대한 일반적인 내용은 파일 이름 지정, 경로 및 네임스페이스를 참조 하세요.
참고 항목
- 정의할 수 있는 항목 수에 대한 제한은 작업 추적, 프로세스 및 프로젝트 제한을 참조 하세요.
시스템 예약 이름
다음 예제와 같이 시스템 예약 이름을 사용하지 않도록 합니다.
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- CON
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- 웹 또는 웹
예약된 이름에 대한 자세한 내용은 파일 이름, 경로 및 네임스페이스를 참조 하세요.
Azure Artifacts
유니버설 패키지는 다음 제한을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
패키지 이름 | - 소문자여야 합니다. - 문자 또는 숫자로 시작하고 끝나야 합니다. - 문자, 숫자 및 비보안 대시, 밑줄 또는 마침표만 포함해야 합니다. |
패키지 버전 | 빌드 메타데이터가 없으면 소문자여야 합니다. |
Azure Boards
작업 항목을 사용하여 정보를 캡처하여 소프트웨어 개발 프로젝트를 계획하고 추적합니다. 작업 항목을 사용하여 수행할 작업을 설명하고, 작업을 할당하고, 상태를 추적하고, 팀 내에서 작업을 조정할 수 있습니다. 사용자 스토리, 작업, 버그 및 문제와 같은 다양한 유형의 작업 항목은 다양한 유형의 정보를 추적합니다. 자세한 내용은 Azure Boards 설명서를 참조 하세요.
모든 작업 항목 추적 개체는 하나 이상의 이름과 연결됩니다. 작업 항목 유형 및 참조 이름과 연결된 전역 목록을 제외하고 대부분 표시 이름이 있습니다. 친숙한 이름은 필드에 대해 사용자가 볼 수 있는 고유한 식별자입니다. 친숙한 이름을 사용하면 프로젝트 컬렉션의 프로젝트 및 작업 항목 형식 간에 일관성을 유지할 수 있습니다. 시스템은 내부적으로 참조 이름을 사용하며 정의한 후에는 변경할 수 없습니다.
참조 및 친숙한 이름, 필드 이름 및 첨부 파일 크기를 포함하여 작업 항목과 연결된 여러 요소에 대한 제한 사항이 있습니다.
영역 및 반복 경로
작업 항목 필드 두 개인 영역 경로 및 반복 경로는 작업 그룹화를 위한 트리 구조 계층 구조를 제공합니다. 영역 경로는 제품, 기능 또는 기능 영역별로 작업 항목을 그룹화합니다. 반복 경로는 작업 항목을 스프린트, 중요 시점 또는 해당 작업 항목의 주소를 지정하기 위한 기간으로 그룹화합니다.
이러한 다중 노드 필드는 백슬래시 \
문자를 사용하여 트리 구조 내의 노드 계층 구조를 나타냅니다.
이러한 필드에 자식 노드에 할당하는 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
노드 길이 | 255자를 초과하지 않아야 합니다. |
예약된 이름 | - 마침표 또는 두 개의 마침표 . .. 로만 구성해서는 안 됩니다.- PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON 또는 AUX와 같은 시스템 예약 이름이 아니어야 합니다. 예약된 이름에 대한 자세한 내용은 파일 이름, 경로 및 네임스페이스를 참조 하세요. |
노드에 대한 특수 문자 | - 유니코드 컨트롤 문자를 포함해서는 안됩니다. - 다음 문자 \ / : * ? " < > | # $ & * + 중 하나를 포함하지 않아야 합니다.- 로컬 파일 시스템에서 금지된 문자를 포함해서는 안 됩니다. Windows 문자 제한에 대한 자세한 내용은 파일 이름 지정, 경로 및 네임스페이스를 참조 하세요. |
경로 길이 | 4,000자를 초과하는 유니코드 문자를 포함해서는 안됩니다. |
경로 계층 구조 깊이 | 깊이는 14개 미만이어야 합니다. |
첨부 파일
작업 항목에 연결된 파일은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
파일 크기 | 최대 크기를 초과하지 않아야 합니다. - 기본 최대 크기: 4,096킬로바이트. - 절대 최대 크기: 2GB. |
제한 유형 | 제한 사항 |
---|---|
파일 크기 | 최대 크기를 초과하지 않아야 합니다. - 기본 최대 크기: 4,096킬로바이트. - 절대 최대 크기: 2GB. 자세한 내용은 작업 항목의 최대 첨부 파일 크기 변경을 참조 하세요. |
보드 열 및 스윔 레인 이름
보드는 백로그를 대화형 간판으로 전환하여 시각적 작업 흐름을 제공합니다. 아이디어 구상에서 제품 완성까지의 작업을 진행하는 과정에서 보드의 항목을 업데이트합니다. 각 열은 작업 단계를 나타내며 각 카드는 해당 작업 단계의 사용자 스토리(파란색 카드) 또는 버그(빨간색 카드)를 나타냅니다.
열과 스윔 레인을 추가, 제거 또는 이름을 변경하여 보드를 사용자 지정합니다. 열은 전반적으로 작업 흐름을 지원합니다. 스윔 레인을 사용하면 보드의 가로 차선으로 다양한 작업 클래스를 관리할 수 있습니다.
열 및 스윔 레인 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 256자를 초과하는 유니코드 문자를 포함해서는 안됩니다. |
고유성 | - 열 이름은 보드의 다른 열 이름과 동일하지 않아야 합니다. - 스윔 레인 이름은 보드의 다른 스윔 레인 이름과 동일하지 않아야 합니다. |
특수 문자 | 유니코드 컨트롤 문자 또는 서로게이트 문자를 포함해서는 안됩니다. |
필드 이름
각 작업 항목 유형에는 하나 이상의 작업 항목 필드가 포함됩니다. 이러한 필드는 작업 항목 유형에 따라 작업 항목에 저장된 정보를 정의합니다. 각 작업 항목 필드에는 연결된 필드 참조 이름이 있습니다. 필드 참조 이름은 각 필드를 고유하게 식별하며 할당된 후에는 변경할 수 없습니다. 기본 작업 항목 필드에 대한 자세한 내용은 작업 항목 필드 인덱스입니다.
작업 항목 필드 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 128자 이상의 유니코드 문자를 포함해서는 안됩니다. |
고유성 | - 필드 이름에 알파벳 문자가 하나 이상 포함되어야 합니다. - 다음 문자 . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - 중 하나를 포함하지 않아야 합니다. |.- 선행 또는 후행 공백을 포함해서는 안됩니다. - 두 개 이상의 연속 공백을 포함해서는 안됩니다. |
특수 문자 | 조직 또는 프로젝트 컬렉션 내에서 고유해야 합니다. 작업 항목 필드 이름은 프로젝트 컬렉션으로 범위가 지정됩니다. 필드 이름의 이름을 바꾸면 컬렉션의 모든 프로젝트 내에 정의된 모든 작업 항목 및 WIT에 대해 변경합니다. |
필드 참조 이름 및 이식성
작업 항목 형식 정의 언어에는 필드 참조 이름의 개념이 포함됩니다. 필드 참조 이름을 사용하면 Team Foundation 프로젝트 컬렉션 간에 정의를 이식하고 Microsoft가 아닌 통합에서 특정 필드를 찾아서 참조할 수 있습니다. .NET Framework 애플리케이션의 네임스페이스가 전역적으로 고유한 것처럼 이러한 이름은 전역적으로 고유합니다.
시스템 네임스페이스는 Team Foundation 시스템 함수에 필수인 모든 핵심 시스템 필드를 정의하는 데만 사용됩니다. 기능을 방해할 수 있으므로 고유한 System.X 필드를 만들 수 없습니다.
Microsoft 네임스페이스는 작업 항목 추적 필드를 정의하는 데 사용됩니다. 이러한 필드는 프로세스 템플릿의 작업 항목 형식 정의에 정의됩니다.
고객과 파트너는 사용자 지정 작업 항목 유형에 대한 고유한 필드 네임스페이스를 만들 수 있습니다. 기본 프로세스 템플릿에 정의된 시스템 필드 및 필드에 대한 설명은 작업 항목 필드의 인덱스를 참조 하세요.
Important
- 필드 참조 이름은 이름을 바꿀 수 없습니다. 예를 들어 필드 이름 "Title"을 "Header"로 변경한 경우 해당 필드의 필드 참조 이름은 동일하게 유지됩니다. 필드의 통합 및 내부 표현은 필드 이름 자체에 따라 달라지는 대신 필드 참조 이름을 사용해야 합니다.
- 고유한 Microsoft.X 필드를 만들 수 있지만 기능 구성 마법사가 업그레이드 후 프로젝트를 성공적으로 업데이트하는 데 방해가 될 수 있으므로 그렇게 하지 않는 것이 좋습니다.
필드 참조 이름의 예
다음 예제에서는 다양한 네임스페이스에서 유효한 필드 참조 이름을 보여 줍니다. 고객 및 파트너는 사용자 지정 작업 항목 유형을 지원하기 위해 고유한 네임스페이스를 정의할 수도 있습니다.
시스템 네임스페이스 예제 | Microsoft 네임스페이스 예제 | 기타 네임스페이스 예제 |
---|---|---|
System.Id, System.Title, System.CreatedBy, System.CreatedDate, System.ChangedBy, System.ChangedDate, System.State, System.Reason | Microsoft.VSTS.Build.FoundIn, Microsoft.VSTS.Common.Activity, Microsoft.VSTS.Common.Discipline, Microsoft.VSTS.Common.Priority, Microsoft.VSTS.CMMI.TaskType, Microsoft.VSTS.TCM.AutomationStatus, Microsoft.VSTS.TCM.TestSuiteType | 가상의 회사인 Fabrikam Fiber는 다음과 같은 사용자 지정 작업 항목 필드를 정의할 수 있습니다. FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution 가상의 소프트웨어 회사 Contoso Corporation은 다음 작업 항목 필드를 정의할 수 있습니다. Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase |
필드 도움말 텍스트
시스템은 런타임에 도움말 텍스트를 표시하여 사용자가 필드에 입력할 내용을 알 수 있도록 합니다. 도움말 텍스트의 범위는 특정 프로젝트의 특정 작업 항목 유형으로 지정됩니다.
상속 프로세스의 경우 필드 편집 대화 상자, 정의 탭, 설명을 통해 필드에 대한 도움말 텍스트를 지정합니다. 작업 항목 형식에 사용자 지정 필드 추가를 참조 하세요. 온-프레미스 XML 프로세스의 경우 요소를 사용하여 도움말 텍스트를 지정합니다 HELPTEXT
. 작업 추적에 대한 필드 추가 또는 수정을 참조하세요.
추가하는 도움말 텍스트는 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 255자를 초과하는 유니코드 문자를 포함해서는 안됩니다. |
전역 목록
전역 목록은 온-프레미스 Azure DevOps Server 인스턴스 내의 모든 프로젝트 컬렉션에서 전역적으로 사용할 수 있는 목록 항목 값 집합입니다. 작업 항목 유형을 정의할 때 일부 작업 항목 필드가 허용되거나 제안된 값과 동일한 집합을 공유한다는 것을 확인할 수 있습니다. 전역 목록을 사용하면 이러한 값을 한 번 정의하고 여러 작업 항목 유형 및 프로젝트에서 공유할 수 있습니다. 자세한 내용은 전역 목록 정의를 참조 하세요.
요소를 사용하여 정의된 전역 목록에는 요소를 사용하여 GLOBALLIST
지정된 하나 이상의 목록 항목이 LISTITEM
포함됩니다.
LISTITEM
이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | - 254자 이상의 유니코드 문자를 포함해서는 안됩니다. - 비어 있지 않아야 합니다. |
특수 문자 | - 선행 또는 후행 공백을 포함해서는 안 합니다. - 두 개의 연속 공백을 포함해서는 안됩니다. - 백슬래시 \ 문자를 포함해서는 안 됩니다. |
범위 | 전역 목록은 모든 프로젝트에서 사용할 수 있으므로 프로젝트 수준에서 정의된 요소(예: 프로젝트별 그룹 계정 정의)를 포함해서는 안 됩니다. |
전역 목록은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
항목 수 | 비워 둘 수 없습니다. 전역 목록에는 하나 LISTITEM 이상의 요소가 포함되어야 합니다. |
고유성 | 비워 둘 수 없습니다. 전역 목록에는 하나 LISTITEM 이상의 요소가 포함되어야 합니다. |
링크 형식 및 범주 참조 이름
링크 형식 또는 범주를 추가하거나 만들 때마다 참조 이름을 정의합니다. 모든 참조 이름은 최대 70자까지 유니코드 문자가 될 수 있습니다.
영숫자 문자, 밑줄 문자 및 하이픈 문자를 사용하여 참조 이름을 정의합니다. 각 참조 이름에는 하나 이상의 마침표 .
가 포함되어야 하지만 이름의 시작 또는 끝에는 마침표가 나타나지 않습니다. 참조 이름은 숫자나 밑줄로 시작해서는 안 되며 다음과 같이 --
연속된 하이픈을 여러 개 가질 수 없습니다.
제한 유형 | 제한 사항 |
---|---|
Length | 70개 이상의 유니코드 문자를 포함해서는 안됩니다. |
고유성 | - 프로젝트 컬렉션 내의 다른 필드 참조 이름과 동일하지 않아야 합니다. - 모든 마침표 . 가 밑 _ 줄로 바꾸기 위해 컴퓨터에서 해당 이름을 처리한 후에는 다른 필드 참조 이름과 동일하지 않아야 합니다. 예를 들어 필드가 이름을 My.*Field* 참조하고 My.Field 둘 다 동일한 이름으로 처리합니다. My__Field |
특수 문자 | - 하이픈을 포함해서는 안 됩니다.- - 마침표 . 가 하나 이상 포함되어야 합니다.- 마침표 . 로 시작하거나 끝내서는 안됩니다.- numberMust로 시작하지 않아야 하며 밑줄 _ 로 시작하지 않아야 합니다. |
작업 항목 태그
작업 항목 태그는 백로그, 보드 및 쿼리와 같은 작업 추적 도구를 필터링하거나 쿼리를 정의하는 하나 또는 두 개의 키워드 구에 해당합니다. 자세한 내용은 작업 항목 태그 추가를 참조 하여 목록 및 보드를 분류하고 필터링합니다.
태그 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | - 400자 이상의 유니코드 문자를 포함해서는 안됩니다. - null이거나 비어 있지 않아야 합니다. |
특수 문자 | - 구분 기호 문자를 , 포함하지 않아야 합니다. 또는 ; .- 줄 바꿈, 단락 구분 기호, 캐리지 리턴 또는 기타 일치하지 않는 서로게이트 문자와 같은 유니코드 컨트롤 또는 서식 문자를 포함해서는 안됩니다. |
범위 | 전역 목록은 모든 프로젝트에서 사용할 수 있으므로 프로젝트 수준에서 정의된 요소(예: 프로젝트별 그룹 계정 정의)를 포함해서는 안 됩니다. |
Azure Pipelines
Azure Pipeline 정의는 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
작업 이름 | - 영숫자 문자와 '_' .- 숫자로 시작하지 않아야 합니다. - 고유한 이름이 있어야 합니다. - 키워드(예: "deployment")를 포함해서는 안 됩니다. |
스테이지 이름 | - 영숫자 문자와 '_' .- 숫자로 시작하지 않아야 합니다. - 키워드(예: "deployment")를 포함해서는 안 됩니다. |
식 | 시작하거나_AND , 그 뒤에 a-Z , 0-9 또는 _ .로 a-Z 시작해야 합니다. |
자세한 내용은 Azure Policy 설명서를 참조하세요.
Azure Repos(Git)
각 Azure DevOps 프로젝트에는 여러 Git 리포지토리가 포함될 수 있습니다. Git 리포지토리에 할당하는 이름은 다음 제한 사항을 준수해야 합니다. 자세한 내용은 Azure Repos Git 설명서를 참조 하세요. 분기 및 태그와 같은 다른 Git 항목의 명명 제한에 대한 자세한 내용은 git check-ref-format을 참조 하세요.
Important
리포지토리 이름 내에 공백을 포함할 수 있지만 그렇게 하는 것은 권장되지 않습니다.
제한 유형 | 제한 사항 |
---|---|
Length | 64자 이상의 유니코드 문자를 포함해서는 안됩니다. |
고유성 | 프로젝트의 다른 Git 리포지토리 이름과 동일하지 않아야 합니다. |
특수 문자 | - 유니코드 제어 문자나 서로게이트 문자를 포함할 수 없습니다. - 다음 인쇄 가능한 문자를 \ / : * ? " < > ; # $ * { } , + = [ ] 포함해서는 안됩니다. |.- 밑 _ 줄로 시작하지 않아야 합니다.- 마침표 . 로 시작하거나 끝내서는 안됩니다.- 시스템 예약 이름이 아니어야 합니다. |
Azure Repos(TFVC)
TFVC(Team Foundation 버전 제어)는 팀 전체에서 해당 파일을 관리하는 데 필요한 파일 및 명령에 대한 중앙 리포지토리를 제공합니다. 또한 사용자 지정 가능한 체크 인 정책, 분기, 병합, 선반 및 기타 많은 기능을 제공합니다. 자세한 내용은 Azure Repos TFVC 설명서를 참조 하세요.
버전 제어 경로는 다음 제한 사항을 준수해야 합니다. 작업 영역 최적화도 참조하세요.
제한 유형 | 제한 사항 |
---|---|
서버 소스 제어 폴더 경로 길이 | - 단일 폴더 또는 파일 이름에 대해 259자 이상의 유니코드 문자를 포함해서는 안됩니다. - 디렉터리에 대해 388자 이상의 유니코드 문자를 포함해서는 안됩니다. - 결합된 디렉터리 및 파일 이름에 대해 399자 이상의 유니코드 문자를 포함해서는 안됩니다. |
로컬 폴더 경로 길이 | - 디렉터리에 대해 248자 이상의 유니코드 문자를 포함해서는 안됩니다. - 결합된 디렉터리 및 파일 이름에 대해 260개 이상의 유니코드 문자를 포함해서는 안됩니다. |
웹 포털 및 REST 관련 길이 제한 | 결합된 프로젝트 이름, 디렉터리 및 파일 이름에 대해 215자 이상의 유니코드 문자를 포함해서는 안됩니다. |
웹 포털 및 REST API에서 특정 작업에는 Visual Studio 및 TF.exe 클라이언트보다 더 제한적인 경로 길이가 있습니다. 이러한 작업에는 편집, 이름 바꾸기 및 삭제가 포함되며, 웹 포털/REST가 변경 내용을 보류할 때 동시성을 위해 임의로 생성된 작업 영역을 사용하기 때문에 발생합니다.
TFVC 파일
버전 제어 시스템은 다양한 형식의 파일을 저장합니다. 개발 머신 에서 Team Foundation 버전 제어를 설정하면 기존 Visual Studio 프로젝트 또는 솔루션을 추가하는 방법에 대한 세부 정보가 제공됩니다.
Team Foundation 버전 제어에 추가하는 파일 및 폴더는 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
파일 및 폴더 | - 이름에 다음과 같은 인쇄 가능한 문자 \ / : * ? " < > ; 가 포함되어서는 안됩니다.- 폴더는 현재 작업 영역의 매핑된 디렉터리 외부에 있지 않아야 합니다. |
파일 이름 | - 로 시작 $ 해서는 안됩니다.- 다음 인쇄 가능한 문자를 \ / : * ? " < > ; 포함해서는 안됩니다. |. |
TFVC 레이블
TFVC(Team Foundation 버전 제어)에서 레이블은 특정 수정 버전 집합에 적용되는 이름입니다. 버전 제어에서 관련 없는 파일 집합에 레이블을 첨부할 수 있으므로 파일을 검색하거나 그룹으로 작업할 수 있습니다. 다음 표에서는 레이블 이름에 적용된 제한 사항에 대해 설명합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 64자 이상의 유니코드 문자를 포함해서는 안됩니다. |
특수 문자 | - 공백 ( ) 또는 마침표 . 로 끝날 수 없습니다.- 다음 인쇄 가능한 문자를 \ / : * ? " < > ; @ 포함해서는 안됩니다. |. |
TFVC 선반
선반 집합을 사용하면 보류 중인 변경 내용의 일괄 처리를 일시적으로 따로 설정한 다음 옵션으로 작업 영역에서 보류 중인 변경 내용을 제거할 수 있습니다. 나중에 선반의 변경 내용을 작업 영역으로 복원하거나 다른 사용자의 작업 영역에 배치할 수 있습니다.
선반 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 64자 이상의 유니코드 문자를 포함해서는 안됩니다. |
특수 문자 | 다음 인쇄 가능한 문자를 \ / : * ? " < > & ; 포함하면 안됩니다. |. |
TFVC 작업 영역
작업 영역은 TFVC(Team Foundation 버전 제어)에 있는 파일 및 폴더의 클라이언트 쪽 복사본입니다. 여러 작업 영역을 만들 때 클라이언트 컴퓨터에서 동일한 버전 제어 폴더의 다른 버전을 가질 수 있습니다. 작업 영역을 만들고 작업하면 자세한 정보가 제공됩니다.
작업 영역 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 64자 이상의 유니코드 문자를 포함해서는 안됩니다. |
특수 문자 | - 공백 ( ) 으로 끝나서는 안 되며- 다음 인쇄 가능한 문자를 \ / : * ? " < > ; 포함해서는 안됩니다. |. |
컴퓨터 이름
Azure DevOps를 설치하는 컴퓨터 이름은 서버 이름과 연결됩니다. 운영 체제와 Active Directory는 다음 문서에 설명된 대로 컴퓨터 이름에 특정 제한을 적용합니다.
조직 이름
Important
조직 이름을 만들 때 다음 지침을 준수합니다.
- 영어 알파벳의 문자만 사용
- 문자 또는 숫자로 조직 이름 시작
- 초기 문자 뒤의 문자, 숫자 또는 하이픈 사용
- 조직에서 유니코드 문자 50자를 초과하지 않는지 확인합니다.
- 문자 또는 숫자로 끝
허용되지 않는 문자를 사용하는 경우 다음 오류 메시지가 표시됩니다. VS850015: 지정된 이름을 사용할 수 없습니다. {조직 이름}.
템플릿 처리 및 처리
프로세스는 프로젝트에 연결한 후 액세스할 수 있는 작업 항목 추적 시스템 및 기타 하위 시스템의 구성 요소를 정의합니다.
참고 항목
용어: "프로세스" 및 "프로세스 템플릿"은 프로젝트를 만드는 데 사용되는 상호 종속된 파일 집합을 참조합니다. 자세한 내용은 사용 가능한 세 가지 기본 프로세스 간의 차이점을 설명하는 프로세스 및 프로세스 템플릿 정보를 참조하세요.
정의하거나 사용자 지정하는 프로세스는 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 256자를 초과하는 유니코드 문자를 포함해서는 안됩니다. |
고유성 | - Azure DevOps에서 고유해야 합니다. - 기존 템플릿과 이름이 같은 템플릿을 업로드하면 기존 템플릿을 덮어씁니다. |
프로세스 템플릿 파일 크기 | 2GB(기가바이트)를 초과하지 않아야 합니다. |
프로젝트 컬렉션
프로젝트 컬렉션은 프로젝트 그룹 및 해당 프로젝트와 연결된 리소스를 식별합니다. Azure DevOps Server에 대해 정의된 프로젝트 그룹을 정의하고 제어하는 데 사용할 수 있는 구성 구조를 제공합니다.
또한 컬렉션 이름은 팀 구성원을 프로젝트에 연결하는 데 사용되는 연결 문자열 일부입니다. 할당된 기본값은 DefaultCollection에 해당합니다. 프로젝트 컬렉션 관리에서는 자세한 정보를 제공합니다.
프로젝트 컬렉션에 할당하는 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 64자 이상의 유니코드 문자를 포함해서는 안됩니다. |
고유성 | - 온-프레미스 배포의 다른 컬렉션 이름과 동일하지 않아야 합니다. - 배포에 SharePoint 제품 또는 SQL Server Reporting Services가 포함된 경우 기존 SharePoint 사이트, 보고서 서버 또는 Reporting Services 웹 사이트의 이름 및 전체 경로와 동일할 수 없습니다. |
예약된 이름 | 시스템 예약 이름이 아니어야 합니다. |
특수 문자 | - 유니코드 제어 문자나 서로게이트 문자를 포함할 수 없습니다. - 다음 인쇄 가능한 문자를 \ / : * ? " < > ; # $ * { } , + = [ ] 포함해서는 안됩니다. |. - 줄임표 ... 또는 이중 마침 .. 표를 포함해서는 안 됩니다.- 밑 _ 줄로 시작하지 않아야 합니다.- 마침표 . 로 시작하거나 끝내서는 안됩니다. |
프로젝트 이름
프로젝트는 소스 코드에 대한 리포지토리를 설정하고 팀이 진행 상황을 계획하고 추적하고 공동 작업할 수 있는 장소를 설정합니다. 프로젝트 이름은 팀 구성원을 프로젝트에 연결하는 데 사용되는 연결 문자열 일부입니다.
만든 프로젝트에 할당하는 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 64자 이상의 유니코드 문자를 포함해서는 안됩니다. |
고유성 | 프로젝트 컬렉션의 다른 이름, 컬렉션을 지원하는 SharePoint 웹 애플리케이션 또는 컬렉션을 지원하는 SQL Server Reporting Services 인스턴스와 동일하지 않아야 합니다. |
예약 이름 | - 시스템 예약 이름이 아니어야 합니다. - App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin 또는 web.config와 같은 IIS 요청 필터링에 사용되는 숨겨진 세그먼트 중 하나일 수 없습니다. |
특수 문자 | - 유니코드 제어 문자나 서로게이트 문자를 포함할 수 없습니다. - 다음 인쇄 가능한 문자를 \ / : * ? " < > ; # $ * { } , + = [ ] 포함해서는 안됩니다. |. - 밑 _ 줄로 시작하지 않아야 합니다.- 마침표 . 로 시작하거나 끝내서는 안됩니다. |
보안 그룹
Azure DevOps 보안 그룹을 사용하면 사용자 그룹에 특정 권한 또는 권한을 적용할 수 있습니다.
온-프레미스 그룹은 Active Directory 그룹 계정, Azure DevOps 보안 그룹, Windows 사용자 계정, Windows 그룹 계정 또는 이러한 유형의 혼합으로 구성될 수 있습니다. 자세한 내용은 기본 제공 보안 그룹에 Active Directory/Microsoft Entra 사용자 또는 그룹 추가를 참조하세요.
보안 그룹은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
보안 그룹 계정 이름 길이 | 256자를 초과하는 유니코드 문자를 포함해서는 안됩니다. |
고유성 | - 프로젝트 수준 그룹 계정은 동일한 프로젝트의 다른 그룹 이름과 일치하지 않아야 합니다. - 컬렉션 수준 그룹 계정은 프로젝트 컬렉션에 있는 그룹 계정의 다른 이름과 일치하지 않아야 합니다. |
예약된 그룹 이름 | 프로젝트 또는 서버 수준에서 $NAMESPACE 이름을 지정해서는 안 됩니다. |
특수 문자 | - 유니코드 제어 문자나 서로게이트 문자를 포함할 수 없습니다. - 다음 인쇄 가능한 문자를 / \ [ ] : < > + = ; ? * 포함해서는 안됩니다. |. - ASCII 값 범위 1-31에 인쇄할 수 없는 문자를 포함해서는 안 됩니다. - 마침표 . 로 끝나서는 안됩니다.- 쉼표는 포함하지 않아야 합니다. , |
Team Foundation Build
Team Foundation Build를 사용하면 단일 컴퓨터에서 빌드 프로세스의 모든 측면을 관리할 수 있습니다. Team Foundation Build를 사용하면 원본을 동기화하고, 애플리케이션을 컴파일하고, 연결된 단위 테스트를 실행하고, 코드 분석을 수행하고, 파일 서버에서 빌드를 릴리스하고, 빌드 보고서를 게시할 수 있습니다.
컴퓨터 빌드
Team Foundation Build는 Azure DevOps Server 애플리케이션 계층, 데이터 계층 또는 Visual Studio 클라이언트와는 별도로 설치됩니다. 별도의 컴퓨터를 선택할 수 있습니다. 그렇지 않으면 클라이언트 컴퓨터 또는 서버에 빌드를 나란히 설치할 수 있습니다.
온-프레미스 빌드 컴퓨터는 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
디스크 공간 | 빌드에 충분한 공간을 포함해야 합니다(공간이 부족하여 실패한 빌드로 이어질 수 없음). |
빌드 디렉터리 | 로컬 경로(예: C:\BuildDirectory )여야 합니다. |
위치 디렉터리 삭제 | UNC 경로(예: \server\share )여야 합니다. |
위치 권한 삭제 | 생성된 각 빌드는 드롭 폴더의 새 디렉터리에 배치됩니다. - Team Foundation Server 서비스 계정(예: Domain\TFSSERVICE )에는 UNC 삭제 위치에 대한 모든 권한 권한이 있어야 합니다.- UNC 삭제 위치는 공유 폴더여야 합니다. |
Team Foundation Build Service 계정 | 초기 설치 후 TFS 서비스 계정을 변경하는 경우 다음 조건이 충족되는지 확인해야 합니다. - 계정이 Build Services 그룹의 구성원입니다. - 계정에 임시 폴더 및 ASP.NET 임시 폴더에 대한 읽기/쓰기 권한이 있습니다. - 계정에 빌드 디렉터리 및 삭제 위치에 대한 모든 권한이 있습니다. |
방화벽 문제 | 빌드 컴퓨터가 방화벽을 사용하도록 설정된 경우 프로그램 tfsbuildservice가 예외 목록에 있는지 확인합니다. |
빌드 형식
빌드 형식은 프로젝트의 단일 솔루션 또는 솔루션 집합이 빌드되는 조건을 구성합니다. 빌드를 수행하려면 새 빌드 형식을 만들거나 기존 빌드 형식을 사용해야 합니다.
빌드 형식 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
고유성 | 프로젝트의 다른 빌드 형식 이름과 동일하지 않아야 합니다. |
특수 문자 | 다음 인쇄 가능한 문자를 $ 포함하면 안됩니다. |
빌드 품질
빌드 품질을 사용하면 품질 수준 또는 완료 상태를 완료된 빌드에 연결할 수 있습니다. Team Foundation Build를 사용하면 빌드 품질 유형에 대한 새 값을 만들 수도 있습니다. 기본 빌드 품질 값 목록은 완료된 빌드의 품질 속도를 참조하세요.
빌드 품질 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 256자를 초과하는 유니코드 문자를 포함해서는 안됩니다. |
고유성 | Team Foundation Build 컴퓨터의 다른 빌드 품질 이름과 동일하지 않아야 합니다. |
팀 이름
팀 이름은 프로젝트에서 팀으로 공동으로 작업하는 개인 또는 그룹의 그룹을 식별합니다. 팀 구성원은 이 이름을 사용하여 팀에 연결하거나 팀에 대해 정의된 멤버에 대해 쿼리합니다.
팀 이름은 유효한 URL의 일부로 렌더링할 수 있는 규칙을 준수해야 합니다. 각 팀 이름은 단일 프로젝트 내에서 고유해야 합니다. 그러나 프로젝트 컬렉션 내의 다른 프로젝트에서 동일한 팀 이름을 사용하는 데는 제한이 없습니다. 자세한 내용은 다른 팀 또는 팀의 계층 구조 추가를 참조 하세요.
팀 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
Length | 64자 이상의 유니코드 문자를 포함해서는 안됩니다. |
고유성 | 프로젝트의 다른 이름과 동일하지 않아야 합니다. |
예약된 이름 | 시스템 예약 이름이 아니어야 합니다. |
특수 문자 | - 유니코드 제어 문자나 서로게이트 문자를 포함할 수 없습니다. - 다음 인쇄 가능한 문자를 \ / : * ? " < > ; # $ * { } , + = [ ] 포함해서는 안됩니다. |.- 줄임표 ... 또는 이중 마침 .. 표를 포함해서는 안 됩니다.- 밑 _ 줄로 시작하지 않아야 합니다.- 마침표 . 로 시작하거나 끝내서는 안됩니다. |
사용자 계정 이름
사용자 계정은 프로젝트 또는 프로젝트 컬렉션에 추가된 사용자를 식별합니다. 사용자 계정은 Active Directory, Microsoft Entra ID, Windows 서버 그룹 내의 항목에 해당할 수 있습니다.
조직 또는 컬렉션에 추가하는 사용자 계정은 다음 제한 사항을 준수해야 합니다. 프로젝트에 사용자 계정을 추가하려면 프로젝트 또는 팀에 사용자 추가를 참조하세요.
제한 유형 | 제한 사항 |
---|---|
계정 이름 길이 | 256자를 초과하는 유니코드 문자를 포함해서는 안됩니다. |
고유성 | 프로젝트 컬렉션에 추가된 다른 사용자 계정과 일치하지 않아야 합니다. |
예약된 그룹 이름 | 프로젝트 또는 서버 수준에서 이름을 지정 $NAMESPACE 해서는 안 됩니다. |
특수 문자 | - 다음 인쇄 가능한 문자를 "/ \ [ ] : < > + = ; ? * 포함해서는 안됩니다. |.- ASCII 값 범위 1-31에 인쇄할 수 없는 문자를 포함해서는 안 됩니다. - 마침표 . 나 달러 기호 $ 로 끝나서는 안 됩니다.- 쉼표는 포함하지 않아야 합니다. , - 다음 유니코드 범주를 포함해서는 안 됩니다. LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Wiki 페이지 및 파일 이름
각 Wiki 페이지는 Wiki Git 리포지토리 내의 파일에 해당합니다. Wiki 페이지 제목에 할당하는 이름은 다음 제한 사항을 준수해야 합니다.
제한 유형 | 제한 사항 |
---|---|
파일 이름 | 정규화된 페이지 경로는 235자를 초과할 수 없습니다. |
고유성 | 페이지 제목은 대/소문자를 구분하며 Wiki 계층 내에서 고유해야 합니다. |
특수 문자 | - 유니코드 제어 문자나 서로게이트 문자를 포함할 수 없습니다. - 다음 인쇄 가능한 문자를 / \ # 포함하면 안됩니다.- 마침표 . 로 시작하거나 끝내서는 안됩니다. |
파일 크기 | 최대 18MB를 초과하지 않아야 합니다. |
첨부 파일 크기 | 최대 19MB를 초과할 수 없습니다. |
Wiki 페이지 제목의 특수 문자
이러한 특수 문자 : < > * ? | -
중 하나 이상을 포함하는 페이지 제목을 지정할 수 있습니다. 예를 들어 Markdown 파일의 이름을 "FAQ?" 또는 "설정 가이드"로 지정할 수 있습니다. 문자에는 다음과 같은 URI로 인코딩된 문자열이 있습니다.
캐릭터 | 인코딩된 문자열 |
---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22% |