문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문
Visual Studio 2017을 사용하는 것이 좋습니다.

Visual Studio Online에서 온-프레미스 TFS로 전환

Visual Studio Online에서 프로젝트 및 데이터를 내보내어 TFS(Team Foundation Server) 2013 업데이트 2의 온-프레미스 배포로 복원할 수 있습니다. 이 내보내기 프로세스는 Visual Studio Online에서 온-프레미스 TFS로의 단방향 전환입니다. 전환 후 온-프레미스 TFS에서 소프트웨어 개발을 계속할 수 있습니다. 내보내기 프로세스에서는 프로젝트 및 데이터 기록을 유지 관리합니다.

다음과 같은 경우에 데이터를 내보낼 수 있습니다.

  • 서비스와 조정되지 않는 데이터 추적 요구 사항이 있는 경우

  • 서비스가 일반 제공됨에 따라 서비스를 계속하는 것에 관심이 없는 경우

  • 온라인 프로젝트가 모두 완료되어 이를 보관하려는 경우

내보낸 후에는 TFS의 온-프레미스 버전에 제공되지 않는 기능을 제외하고는 온라인 서비스에서 사용한 모든 소스 코드, 작업 항목, 권한 및 기타 기능에 액세스할 수 있습니다. 모든 권한이 필요한 기능은 기본적으로 사용하지 않도록 설정됩니다. 적절한 라이선스가 있는 경우 해당 사용자를 위해 이러한 기능을 사용하도록 설정할 수 있습니다. 또한 Application Insights 및 클라우드 기반 부하 테스트와 같은 일부 Visual Studio Online 기능은 온-프레미스 TFS의 일부로 사용할 수 없습니다. TFS는 다른 활동에 사용하면서 이러한 기능은 Visual Studio Online 계정을 통해 계속 사용할 수 있습니다.

중요 중요

데이터 내보내기 기능은 기본적으로 사용하지 않도록 설정되어 있으며, 얼리 어답터 FAQ에 공개되어 있는 것처럼 제한된 시간 동안만 사용할 수 있습니다. 데이터 내보내기 기능을 사용하도록 설정하려면 Visual Studio Online(VSOExportSupport@Microsoft.com)으로 메일을 보내야 합니다.

이동을 시작하기 전에 온-프레미스 TFS로 기능을 이동할 때 프로젝트에 더 이상 사용할 수 없는 기능을 검토해야 합니다. 또한 다음 사항을 확인해야 합니다.

  • 프로젝트에 대해 데이터 내보내기를 사용하도록 설정하기 위해 지원에 문의했습니다.

  • 온-프레미스 TFS를 Team Foundation Server 2013 업데이트 2로 업데이트했습니다.

  • Visual Studio Online에서 프로젝트의 계정 소유자입니다.

  • 온-프레미스 TFS에서 Team Foundation Administrator이며 이를 지원하는 SQL Server 인스턴스의 sysadmin입니다.

  • 데이터를 내보내기 위한 시간을 선택했으며, 사전에 사용자에게 이러한 사실을 알렸습니다. 내보내기 중에는 사용자가 프로젝트에 액세스할 수 없으며, 보유한 데이터 양에 따라 이러한 내보내기에 걸리는 시간은 몇 분에서 1시간 이상에 이르기까지 다양합니다.

  • 사용자에게 내보내기 이후에는 온라인 프로젝트를 변경하지 않도록 알렸습니다. 이러한 변경 내용은 온-프레미스 TFS로 마이그레이션한 데이터에 포함되지 않기 때문입니다.

Microsoft 지원에서 사용자의 계정에 대해 데이터 내보내기를 사용하도록 설정하고 나면 내보내기 프로세스를 시작할 준비가 된 것입니다.

  1. 계정 소유자로 Visual Studio Online(youraccount.visualstudio.com)에 로그인합니다. (계정 소유자를 찾는 방법)

  2. 계정 홈 페이지에서 페이지 오른쪽 상단에 있는 기어 아이콘을 선택하여 관리 페이지를 엽니다.

  3. 내보내기 탭에서 시작을 선택합니다. 경고 대화 상자가 나타나면, 더 이상 사용할 수 없는 기능을 검토하는 링크를 연 다음(아직 검토하지 않은 경우) 계속합니다.

    이 기능을 사용하려면 Microsoft에 문의해야 합니다.
  4. 내보내기 프로세스가 완료되면 .zip 파일을 다운로드하여 온-프레미스 TFS에서 액세스할 수 있는 위치에 저장합니다. 파일이 자동으로 삭제되기 전에 10일간 파일을 다운로드할 수 있습니다.

    .zip 파일로 다운로드
  5. 파일의 압축을 풉니다. 파일에는 설정 파일(.ini), 프로젝트 사용자의 쉼표로 구분된 파일(.csv) 및 추가 정보가 포함되어 있습니다. 실제로 .zip 파일에는 온라인 프로젝트의 데이터가 포함되어 있지 않지만 가져오기 프로세스 중에 데이터를 다운로드하는 데 사용한 정보가 포함되어 있습니다.

데이터를 내보낸 후 온-프레미스 TFS에 팀 프로젝트 컬렉션으로 가져옵니다. 이 컬렉션은 사용자가 가져오기 프로세스 중에 다른 이름을 선택하지 않는 한 Tfs_youraccount로 이름이 지정됩니다. 이 컬렉션은 기본 팀 프로젝트 컬렉션이나 다른 모든 팀 프로젝트 컬렉션의 일부가 아닙니다. 대신 이 컬렉션은 새로운 별도의 팀 프로젝트 컬렉션입니다.

컬렉션을 연결하기 전에 먼저 데이터의 압축을 푼 다음 온라인 사용자를 도메인 또는 작업 그룹에 속하는 사용자로 매핑하도록 .csv 파일을 수정해야 합니다.

  1. 관리자 권한으로 명령 프롬프트를 열고 Team Foundation Server의 도구 디렉터리로 이동합니다. 기본적으로 이러한 도구는 Drive:\%programfiles%\Microsoft Team Foundation Server 12.0\Tools에 있습니다.

  2. 다음 명령을 입력합니다. 여기서 SQLServerInstanceName은 TFS를 지원하는 SQL Server 인스턴스의 이름이며, SettingsFileName은 방금 Visual Studio Online에서 내보낸 설정 파일의 이름입니다(해당 파일 경로 포함).

    TFSConfig CloudImport /SQLInstance:SQLServerInstanceName /SettingsFile:SettingsFileName.ini
    

    TFSConfig CloudImport 명령이 인식되지 않는 경우 Visual Studio Online에서 데이터 내보내기를 지원하는 TFS에 필요한 업데이트를 설치하지 않은 것입니다.

    팁

    가져오기 프로세스가 완료되기 전에 중단되는 경우 TFSConfig CloudImport 명령을 다시 실행해 보세요. 그러면 가져오기 프로세스의 일부로 부분적으로 만들어진 모든 데이터베이스가 삭제됩니다.

    TFSConfig CloudImport 명령에서는 사용자가 지정한 설정 파일을 사용하여 내보낸 데이터에 액세스하고 이를 지정된 SQL Server 인스턴스로 마이그레이션합니다. 설정 파일에는 내보낸 데이터를 찾고 이러한 데이터에 대한 액세스 잠금을 해제하는 데 필요한 정보가 포함되어 있습니다. 설정 파일에는 데이터에 액세스할 수 있는 중요한 정보가 포함되어 있으므로 이 파일을 다른 사용자와 공유해서는 안 됩니다. 또한 설정 파일에는 명령에서 만드는 SQL Server 데이터베이스의 이름이 포함되어 있습니다. 기본적으로 데이터베이스 이름은 Tfs_accountname으로 지정되지만 파일을 열어 이 값을 재정의할 수 있습니다.

  3. 이제 메모장이나 Microsoft Excel과 같은 지원되는 편집기로 .zip 파일에 포함된 .csv 파일을 엽니다.

  4. 적절한 열에 이름을 추가하여 로컬 또는 도메인 ID와 파일에 포함된 각 온라인 사용자를 연결합니다. 그런 다음 파일을 저장합니다. 프로젝트에 더 이상 참여하지 않더라도 모든 온라인 사용자는 제거하지 마세요. 온라인 사용자를 온-프레미스 ID에 매핑하지 않으려는 경우 해당 이름의 로컬 ID 열에 [NOMAPPING]을 입력합니다. 그러면 온라인 사용자와 연결된 기록 및 정보는 유지되지만 해당 사용자는 온-프레미스 TFS에서 활성 사용자가 아니게 됩니다.

    중요 중요

    연결하는 각 사용자 이름은 여기에 표시된 것처럼 DomainName\UserName 또는 MachineName\UserName 형식이어야 합니다.

    LocalIdentity에 로컬 또는 도메인 계정 추가
  5. 가져온 데이터에 다른 데이터베이스 이름을 사용하려면 메모장과 같은 일반 텍스트 편집기를 사용하여 Settings.ini 파일을 열고 내보낸 데이터베이스에 지정할 이름을 수정합니다. 파일의 명명 지침을 따릅니다.

  6. 내보내기가 완료된 후 SQL Server Management Studio를 열고 내보낸 데이터용으로 만든 SQL Server 데이터베이스를 백업합니다. 이 단계는 데이터베이스를 연결하려는 첫 번째 시도가 실패할 경우 데이터베이스를 정상 상태로 복원하여 팀 프로젝트 컬렉션으로 다시 연결하려는 시도를 가능하게 해주는 중요한 단계입니다.

이제 데이터를 온-프레미스 TFS에서 팀 프로젝트 컬렉션으로 가져올 준비가 되었습니다.

  1. TFS의 관리 콘솔을 열고 팀 프로젝트 컬렉션 페이지에서 컬렉션 연결을 선택하여 마법사를 시작합니다.

    관리 콘솔에서 마법사 시작
  2. TFS 인스턴스는 기본적으로 선택되어 있으며, 내보낸 데이터가 사용 가능한 데이터베이스로 표시되어야 합니다. 그렇지 않으면 사용 가능한 데이터베이스를 나열한 다음 선택합니다.

  3. ID 매핑 페이지에서 사용자 연결 정보로 수정한 .csv 파일로 이동하여 해당 파일을 엽니다. 목록에 사용자가 연결 정보와 함께 표시되어야 합니다. 내용을 검토하여 세부 정보가 올바른지 확인한 다음 마법사를 완료합니다.

    오류는 나중에 수정할 수 없습니다. 검토하십시오!
    주의 정보 주의

    연결 프로세스가 완료된 후에는 매핑을 변경할 수 없으므로 정보를 검토하여 올바른지 확인하는 것이 매우 중요합니다. ID 매핑에서의 모든 실수는 연결된 컬렉션에 영구적으로 영향을 미칩니다. 일부 경우 컬렉션을 분리하고 삭제한 후 데이터 내보내기 및 연결 프로세스를 다시 거쳐야 할 수도 있습니다.

  4. 이제 데이터가 온-프레미스 TFS에 컬렉션으로 표시됩니다.

    내보낸 데이터가 컬렉션으로 연결됩니다.

데이터가 팀 프로젝트 컬렉션으로 연결되고 나면 주의할 세부 정보는 몇 가지밖에 더 없습니다.

  • Visual Studio Online에서나 로컬에서 빌드 리소스를 사용 중인 경우 빌드 컨트롤러를 제거한 다음 새 빌드 컨트롤러를 구성해야 합니다. 자세한 내용은 빌드 컨트롤러 배포 및 구성을 참조하십시오.

  • Visual Studio Online에서는 프록시 구성을 사용하여 서비스를 가속화합니다. 이제 컬렉션을 온-프레미스 TFS로 이동했으므로 다음 중 하나를 수행하여 프록시 정보를 다시 구성해야 합니다.

    • 내보낸 후에 Visual Studio Online을 사용하지 않으려는 경우 서버에 대해 프록시가 구성된 아무 TFS에나 로그온하고 Proxy 명령을 사용하여 해당 끝점을 삭제합니다.

    • 컬렉션을 온-프레미스에 연결한 후 해당 컬렉션에 대한 프록시를 구성하려는 경우 Proxy 명령을 사용하여 이 끝점을 기존 프록시 서버에 추가하거나, 마법사를 사용하여 이 컬렉션에 대한 새 프록시 구성을 수행합니다.

  • Visual Studio를 열고 가져온 팀 프로젝트 컬렉션에 연결합니다. 사용자가 해당 프로젝트 및 데이터에 액세스할 수 있는지와 컬렉션이 예상대로 작동하는지 확인합니다. 예를 들면 다음과 같습니다.

    • 응용 프로그램 계층을 호스트하지 않는 컴퓨터에서 웹 브라우저를 열고 팀 홈 페이지로 이동합니다.

    • 관리 페이지를 포함하여, Team Web Access에서 팀과 프로젝트에 액세스할 수 있는지 확인합니다.

    • 버전 제어를 열고 코드에 액세스할 수 있는지와 보류 집합 및 변경 집합 세부 정보를 볼 수 있는지 확인합니다.

    • 사용자에게 할당된 작업 항목을 검토하고 작업 항목 하나를 열어 해당 작업 항목을 편집할 수 있는지 확인합니다. 사용자에게 할당된 작업 항목이 없는 경우 작업 항목을 하나 만들어 본인에게 할당한 후 닫았다가 열고 편집한 후 저장합니다.

  • 온-프레미스 TFS 사용자에게 이제 컬렉션을 사용할 수 있다고 알리고 연결 정보를 제공합니다.

  • Visual Studio Online에서 데이터 내보내기 파일을 삭제합니다. ( 10일 후 Visual Studio Online에서 데이터 내보내기 파일이 자동으로 삭제됩니다.)

  • 더 이상 Visual Studio Online을 사용하지 않으려면 고객 지원에 계정 사용 중지에 대해 문의하세요. 계정을 계속 사용하려면 온라인에서 프로젝트에 대해 수행하는 모든 변경 내용이 온-프레미스 TFS에 반영되지 않는다는 점에 유의하세요. 내보낸 프로젝트에 대한 사용자의 액세스 라이선스를 해지하여 해당 온라인 프로젝트에 대한 추가 변경이 수행되지 않도록 할 수 있습니다.

A: TFS 관리 작업에는 데이터 백업, 서버 유지 관리 및 사용자 관리와 같은 많은 활동이 포함됩니다. 관리 설명서에서 필요한 정보를 얻을 수 있습니다.

A: 사용자가 팀의 일부로 작업하는 경우 사용자 추가 작업은 Visual Studio Online에서의 사용자 추가 작업과 매우 유사합니다. 그냥 팀에 사용자를 추가하면 됩니다.

표시: