> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Git 제공업체 앱 설치

> GitHub App 설치 또는 GitLab 그룹 권한 부여로 백그라운드 환경 빌드에 승인된 저장소 접근 권한을 제공하세요.

Git 제공업체를 연결해 Replit이 공유 환경 빌드를 위해 저장소에 접근할 수 있도록 하세요. 이 안내는 GitHub를 기준으로 하며, [GitLab 그룹을 연결](#gitlab-그룹-연결-및-프로젝트-선택)할 수도 있습니다.

환경 빌드는 개인 채팅 세션 없이 실행되므로 개인 계정 연결이 아니라 워크스페이스 연결이 필요합니다. 공유 접근을 구성하려면 워크스페이스 관리자여야 합니다. 멤버는 이를 확인하고 자신의 개인 로그인을 관리할 수 있습니다.

> [!NOTE]
>
> 이 얼리 액세스 워크플로는 모든 워크스페이스에서 사용할 수 있는 것은 아닙니다.

## GitHub: Replit GitHub App 설치

**1. GitHub 연결 열기**

[Repositories](https://replit.com/repos)를 열고 GitHub 카드에서 **Manage**를 선택하세요. 아직 연결하지 않았다면 **Connect**를 선택하고 먼저 로그인하세요.

![GitHub 및 GitLab 연결 카드가 강조 표시된 Repositories 페이지.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/provider-cards.jpg?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=ca5ffa6fc9d3849fc57a26746f4030f9)

**2. 공유 접근 구성**

**GitHub App** 옆의 **Configure**를 선택하세요.

![Configure 버튼이 강조 표시된 GitHub 연결 대화 상자.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/configure-github.jpg?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=78c6766b8632ed165ee1b8d2e11251ae)

**3. 조직 추가**

**Add GitHub organization**을 선택해 GitHub의 설치 페이지를 여세요.

![Add GitHub organization이 강조 표시된 GitHub 조직 설정.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/add-organization.jpg?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=9d708646d465c53b69dca7acbf7b10ee)

Replit을 설치할 조직을 선택하세요. 기존 설치가 있다면 **Configure**를 선택하세요.

![GitHub가 Replit을 설치할 위치를 묻고 있으며, Replit 조직을 구성할 수 있습니다.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/choose-organization.png?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=45625ac4a235b0ddc42930116ce48208)

**4. 저장소 접근 선택**

**All repositories** 또는 **Only select repositories**를 선택하고, 요청된 권한을 검토한 다음 **Install**을 선택하세요. 기존 설치라면 대신 **Update access**를 선택하세요. GitHub 관리자의 승인이 필요할 수 있습니다.

![All repositories 및 Only select repositories 옵션, 요청된 권한, Install 버튼이 표시된 GitHub 설치 페이지.](https://mintcdn.com/replit/u9HibLDH0LmIFha_/images/git-provider/repository-permissions.jpg?fit=max\&auto=format\&n=u9HibLDH0LmIFha_\&q=85\&s=16852b935103770fef58dd9aac2cde93)

**5. 연결 확인**

Replit으로 돌아와 필요하면 **Refresh**를 선택하세요. 샌드박스 생성을 위해 조직을 활성화하세요. 설치만으로는 이 접근이 활성화되지 않습니다. 위 예시에서는 조직에 여전히 **Enable**이 표시됩니다.

환경을 빌드하기 전에 조직이 활성화되었는지 확인하세요.

GitHub가 설치의 저장소 권한을 관리합니다. 저장소가 보이지 않으면 GitHub 관리자와 함께 해당 설정을 검토하세요.

## GitLab: 그룹 연결 및 프로젝트 선택

GitLab은 GitHub 방식의 앱 설치가 아니라 그룹 및 프로젝트 권한 부여를 사용합니다.

**1. GitLab에 로그인**

[Repositories](https://replit.com/repos)를 열고 GitLab을 연결하세요. 카드에서 **Manage**를 선택한 다음 워크스페이스 연결 구성을 열어 그룹을 확인하세요.

**2. 그룹 연결**

그룹 옆의 **Configure**를 선택하세요. 공유할 프로젝트를 선택한 다음 **Connect group**을 선택하세요.

**3. 연결 확인**

그룹에 **Connected**가 표시되는지 확인하세요. 나중에 선택한 프로젝트를 변경하려면 **Edit**를 선택하세요.

그룹이나 프로젝트가 보이지 않으면 GitLab 권한과 조직의 승인 요구 사항을 확인하세요.

## 공유 접근 해제

Repositories > Manage > Configure에서 저장된 GitHub 워크스페이스 권한 부여 또는 GitLab 그룹에 대해 Disconnect를 선택하세요. 이렇게 하면 해당 권한 부여를 통한 워크스페이스의 접근이 제거되며, 개인 로그인이나 제공업체 측 GitHub App 설치는 제거되지 않습니다.

해당 권한 부여에 의존하는 빌드와 프로젝트는 저장소 접근 권한을 잃습니다. GitLab 그룹의 연결을 해제하면 해당 그룹의 Replit 서비스 계정, 멤버십, 웹훅도 제거되고 기존 빌드 토큰이 취소됩니다.

GitLab 그룹은 연결된 상태로 두고 개별 프로젝트만 제거하려면 대신 Edit를 사용하세요. 프로젝트를 제거하면 해당 프로젝트의 워크스페이스 접근이 취소되며 기존 빌드 토큰이 무효화될 수 있습니다.

## 환경 빌드하기

[재사용 가능한 환경 만들기](https://docs.replit.com/ko/build/code/create-reusable-environment.md)로 돌아가세요. 체크아웃이 실패하면 워크스페이스 연결과 저장소 권한을 확인하세요. 빌드 단계, 소스 파일, 이미지에 개인 토큰을 넣지 마세요.

그 밖의 개발 리소스로, 채팅 전용 접근과 재사용 가능한 접근의 차이는 [채팅 시크릿 또는 외부 시크릿 관리자](https://docs.replit.com/ko/build/code/adding-secrets-to-environments.md)를, 제공업체 신뢰는 [머신 ID](https://docs.replit.com/ko/build/code/machine-identities.md)를 참고하세요. 둘 다 워크스페이스 연결을 대체하지 않습니다.