계정과 Provider 연결하기

Glif의 계정 화면은 하나의 로그인 버튼 아래 모든 권한을 합치지 않는다. 작성자 정보, Glif identity, Cloudflare web deploy와 GitHub source sync를 분리해 보여 주며, 사용자는 필요한 경로만 연결한다.

기능과 역할

실습 준비

account-provider-plan-lab은 계정 경계를 기록하는 로컬 Binder다. 예제에는 다음 정보만 넣는다.

• 공개 가능한 작성자 표시 이름
• 수행하려는 operation과 필요한 provider
• local·provider·billing 각각의 확인 항목
• credential을 제외한 오류 분류와 복구 결정

실제 이메일, token, callback URL query, raw account/project ID는 예제에 쓰지 않는다.

1. 작성자 정보 설정

작성자 정보는 문서에 사용할 identity다. Glif 로그인이나 결제 계정과 자동으로 같다고 가정하지 않는다.

1. 설정 → 계정을 연다.
2. 작성자 정보를 펼친다.
3. 공개 산출물에 표시해도 되는 이름을 입력한다.
4. 이메일이 필요하면 공개 가능한 주소만 입력한다.
5. publish 전에 실제 출력 metadata에서 표시 여부를 확인한다.

공용 문서나 팀 예제를 만들 때는 개인 이메일 대신 프로젝트 대표 주소 또는 빈 값을 사용할 수 있다. Binder별 author override가 있는 문서는 최종 출력에서 실제 적용값을 다시 확인한다.

2. Glif 계정 연결

Glif 계정은 provider 연결과 plan 조회가 붙는 identity root다.

1. Account path의 첫 노드에서 GLIF에 로그인을 선택한다.
2. 브라우저에서 로그인 대상을 확인한다.
3. 앱으로 돌아와 계정 badge와 표시 identity를 확인한다.
4. provider 노드가 연결 가능한 상태로 바뀌었는지 확인한다.
5. 원래 수행하려던 deploy 또는 sync 작업으로 돌아간다.

로그인 창을 닫거나 callback이 만료되면 문서 입력은 유지된다. 계정 연결을 다시 시작하되 provider 연결이 완료된 것처럼 해석하지 않는다.

3. Cloudflare와 GitHub 중 필요한 경로 선택

Cloudflare direct deploy

Cloudflare는 빌드된 정적 결과를 사용자가 소유한 Pages project에 게시할 때만 필요하다.

1. Cloudflare 직접 배포 행의 역할 설명을 확인한다.
2. Glif 계정 연결 뒤 연결을 선택한다.
3. OAuth가 제공되면 요청 계정과 Pages 범위를 검토한다.
4. 제한된 환경에서 scoped token을 쓸 때는 Pages에 필요한 최소 범위만 부여한다.
5. 연결 badge가 바뀐 뒤 게시·배포 운영의 target 검토로 이동한다.

Cloudflare 연결은 GitHub repository를 만들거나 source를 자동 업로드하지 않는다.

GitHub source sync

GitHub는 Binder source revision을 사용자의 repository와 주고받을 때만 필요하다.

1. GitHub 소스 동기화 행에서 현재 Binder의 sync 상태를 읽는다.
2. 연결을 선택하고 GitHub OAuth의 계정과 권한을 검토한다.
3. 연결 뒤 repository와 Binder가 올바르게 매핑됐는지 확인한다.
4. remote ahead, local ahead, diverged, unknown base 상태를 구분한다.
5. diverged 또는 기준 revision이 불명확하면 push하지 말고 먼저 source를 비교한다.

GitHub 연결은 Cloudflare deploy의 선행 조건이 아니다.

4. 지금 하지 않을 작업은 건너뛰기

Account Settings의 지금 배포하지 않음, 지금 동기화하지 않음은 기능 제거가 아니다. 현재 onboarding에서 해당 provider를 연결하지 않겠다는 선택이다.

• local authoring과 Preview는 계속 사용한다.
• 나중에 deploy 또는 sync 작업에서 다시 연결할 수 있다.
• 건너뛰었다고 Managed provider로 자동 전환되지 않는다.
• 두 provider 중 하나의 실패가 다른 provider credential 사용으로 이어지지 않는다.

5. 연결 해제 전 확인

연결 해제는 local Binder 삭제와 다르다.

1. 진행 중인 deploy·sync가 없는지 확인한다.
2. 연결 해제 대상이 Cloudflare인지 GitHub인지 다시 읽는다.
3. provider remote resource 삭제와 app integration 해제를 구분한다.
4. 해제 뒤 badge가 연결 안 됨 또는 재연결 필요 상태인지 확인한다.
5. 원격 project/repository를 지우려면 해당 기능의 별도 확인 절차를 사용한다.

6. Account path를 읽는 법

영상에서 확인할 핵심은 다음과 같다.

• Root: Glif identity가 연결됐는가
• Branch: deploy와 sync 중 어떤 operation을 수행하는가
• Input: 그 operation에 필요한 provider 입력이 남았는가
• State: not connected, connected, re-auth required, error를 구분하는가
• Action: 연결·재연결·해제가 현재 상태와 맞는가

문제 해결

연결 상태와 plan 복구는 플랜 확인과 연결 복구에서 계속한다.