일상적인 작업 디렉터리(working tree)를 무료 원격 코딩 서버에 절대 올려두어서는 안 됩니다. 왜냐하면 그 디렉터리는 깨끗한 소스 드롭이 아니라 여행 가방과 같기 때문입니다. 채팅창은 단지 그 여행 가방의 라벨일 뿐이며, 내부의 체크아웃(checkout)에는 여전히 원격 저장소 정보(remotes), 무시된 파일(ignored files), 로컬 메모 등이 담겨 있습니다. 모델이나 보조 프로세스가 해당 디렉터리를 읽을 수 있다면, 이미 그 디렉터리가 가지고 있는 모든 것을 공유한 것입니다. 이 경계선에서부터 시작하여, '정제된 미러'가 포함하도록 허용되는 파일이 무엇인지 결정해야 합니다.

공유 사무실의 빌려온 책상은 곧 여러분이 내리려는 선택에 유용한 비유입니다. 단순히 그 책상이 오후에 비어있다고 해서 배낭 전체를 펼쳐놓지는 않을 것입니다. 대신, 과제에 실제로 필요한 노트 한 페이지를 꺼내고, 집 열쇠는 가방 안에 넣어둘 것입니다. 원격 코딩 서버도 이와 같은 방식으로 작동합니다. 심지어 청구서가 0달러이고 모델 호출이 포함되어 있더라도 말입니다.

여러분의 작업 디렉터리는 여러분이 관리하지 않는 외부 주체의 프로세스를 위해 포장됩니다. Git은 여전히 원격 URL을 기억하며, 그중 일부는 절대 여러분의 기기를 벗어나서는 안 되는 토큰이나 사용자 이름을 내장하고 있습니다. gitignore로 의도적으로 무시한 환경 설정 파일(env files)이나 로컬 데이터베이스 같은 파일들도 폴더를 가리키는 어떤 도구에 의해 읽힐 수 있습니다. 에디터 스왑 파일, IDE 폴더, 그리고 코드 옆의 흩어진 메모들 역시 디렉터리를 복사할 때 함께 전송됩니다.

커밋되지 않은 차이점(Uncommitted diffs)은 더 조용한 문제입니다. 삭제된 한 줄이라도 이미 제거했다고 생각했던 비밀번호를 담고 있을 수 있기 때문입니다. 이러한 유출은 프롬프트에 비밀을 입력하는 것과는 다르고, 로그를 채팅창에 붙여넣는 것과도 다릅니다. 그러한 실수는 메시지를 작성하는 과정에서 발생하지만, 이 실수는 여러분이 타이핑하기 전에, 서버가 체크아웃을 받을 때 발생합니다. 아무리 신중하게 프롬프트를 작성하더라도, 에이전트가 디렉터리를 나열하거나, git config를 열거나, 무시된 파일을 검색할 수 있다면 여전히 실패할 수 있습니다.

디렉터리 목록을 실제 요청으로 취급하고, 프롬프트는 그 옆에 작성된 주석으로 취급하라. 원격 프로세스가 존재하기 전에 반드시 자체 기계에서 미러를 구축해야 한다. 작업이 커밋되지 않은 패치에 의존하는 경우, 해당 diff를 로컬에서 검토하고 동일한 게이트(gate)를 통과하는 hunk만 복사하라. 일반적인 클론을 복사 소스로 사용하지 마라. 왜냐하면 일반적인 클론은 원격 URL과 오브젝트 스토어를 유지하기 때문이다.

추적된 파일 아카이브는 이전의 원격 구성 없이 소스 텍스트를 제공한다. 왜냐하면 아카이브에는 git 디렉터리가 포함되어 있지 않기 때문이다. HEAD에 대한 아카이브는 폴더 복사보다 더 작다. 왜냐하면 무시된 파일과 추적되지 않은 노트가 노트북에 남아 있기 때문이다. 미러를 완료로 간주하기 전에, git status를 사용하여 무시된 파일을 확인하여 그 차이를 확인하라. 여전히 게이트가 필요하다. 왜냐하면 추적된 파일 자체도 신중한 커밋에서는 절대 저장해서는 안 되는 토큰을 포함할 수 있기 때문이다.

아래의 게이트는 bundle_gate.py로 저장하고 업로드하기 전에 로컬에서 실행할 수 있는 미실행 예제이다. 이는 인증된 스캐너가 아니라 교육용 게이트이며, 보여준 적이 없는 비밀 형식은 놓칠 것이다. 팀이 실제로 사용하는 이름 패턴을 확장하고, 이 파일을 스캔하려는 어떤 번들 외부에도 유지하라. 반드시 실패해야 하는 피처(fixture)에서 실행한 후, 아무것도 복사하기 전에 미러가 반드시 통과해야 하는 곳에서도 다시 실행하라.

#!/usr/bin/env python3
'''예제 게이트: 여전히 노트북 트리처럼 보이는 컨텍스트 번들을 거부한다.
이 기사에서는 실행되지 않는다. 자체 명명 규칙에 대한 패턴을 확장하라.
...

이 스크립트를 원본 저장소 내부가 아닌 임시 디렉터리에서 실행하는 짧은 명령어 시퀀스와 짝지어라. 첫 번째 명령어는 원격 URL 목록을 나열하여 무언가가 노트북에서 벗어나기 전에 토큰을 볼 수 있게 한다. 다음 명령어들은 추적 전용 아카이브를 구축하고, 원격 연결 없이 언패킹하며, 반드시 실패해야 하는 별도의 피처를 스테이징한다. 게이트 스크립트는 이 두 폴더 외부에도 유지하라. 왜냐하면 스크립트 자체에 잡으려고 하는 단어들이 포함되어 있기 때문이다.

실행되지 않은 예제. fixture는 실패해야 하며, mirror는 통과해야 합니다.

bundle_gate.py 파일은 두 디렉토리 외부에 유지하십시오.

SRC="${SRC:-$HOME/src/your-repo}"
...

게이트(Gate)의 출력은 단순히 무시할 수 있는 제안이 아니라 결정 사항으로 받아들여야 합니다. 오후 시간이 이미 짧기 때문입니다. 이름이 차단되었다는 것은 해당 파일이 로컬 컴퓨터에 남아있다는 의미이며, 그 안에 담긴 값이 오래되었다고 생각하더라도 마찬가지입니다. 텍스트가 차단되었다는 것은 파일을 로컬에서 열어 값을 fixture로 대체한 후 게이트를 다시 실행해야 한다는 뜻입니다. 깨끗하게 종료된 경우(clean exit)만이 원격 컴퓨팅에 미러(mirror)를 복사할 수 있는 권한을 의미하며, 이 결과와 타협하는 순간 모든 것을 중단해야 합니다.

공개 고지: 본 문서는 MonkeyCode의 제품 홍보 활동의 일환으로 작성되었습니다. MonkeyCode의 무료 모델 접근 및 무료 서버 옵션은 오직 스크럽된 미러(scrubbed mirror)에서 해당 게이트를 연습할 수 있는 장소일 뿐입니다. 이 옵션들을 명시된 할당량, 하드웨어 형태, 보존 기간 또는 무료 티어가 고정된다는 약속으로 간주해서는 안 됩니다. 그러한 세부 사항들은 현재 제품 문서에 포함되어 있으므로, 어떤 옵션에 의존하기 전에 해당 문서를 읽어야 합니다.

무료 서버를 원본 체크아웃(original checkout)을 보관하는 금고로 사용하지 말고, 미러에 대한 두 번째 눈으로 사용하십시오. 모델에게 스크럽된 트리(tree)를 가리키며 실패한 테스트를 설명해 달라고 요청하거나 fixture 데이터를 기반으로 패치 초안을 작성해 달라고 요청하십시오. 또한 같은 세션에서 비밀처럼 보이는 파일 목록을 나열하도록 요청하고, 그 목록을 게이트 결과와 비교하십시오. 체크아웃이 민감하다는 것을 모델에게 의존하여 감지하게 해서는 안 됩니다. 거부(refusal)는 감사할 수 있는 통제(control)가 아니기 때문입니다.

만약 모델이 누락된 항목(miss)을 발견하거나 가짜로 항목(hit)을 만들어낸다면, 다음 미러에서 신뢰하기 전에 스크립트를 수정하거나 조정하십시오. 오직 가짜 비밀이 나타났을 때 게이트가 여전히 실패 상태를 유지함을 증명하는 것이 유일한 임무인 작은 fixture 레포지토리(fixture repo)를 유지하십시오. 주석에 가짜 토큰을 넣고, 샘플 설정 파일에 가짜 원격 URL을 넣으며, 반드시 실패해야 하는 dot-env 파일을 만드십시오. 이 fixture에서 게이트를 실행하여 0이 아닌 종료 코드(nonzero exit)가 요구되도록 한 다음, 실제 미러에서 실행하여 0 종료 코드(zero exit)가 요구되는지 확인하십시오.

해당 결과 쌍은 팀원에게 보여줄 수 있는 아티팩트이며, 특정 공급업체가 무료로 남아있다는 것에 의존하지 않습니다. 이 접근 방식은 트리에 고객 기록, 결제 데이터, 건강 데이터 또는 기타 규제 자료가 포함된 경우 잘못된 도구입니다. 정규 표현식(regex) 게이트는 분리된 비밀이나 바이너리를 놓칠 수 있으며, 주석에 있는 일반 단어 토큰도 플래그를 지정합니다. 깊이 제한 아카이브(depth-limited archive) 역시 의도적으로 기록을 누락하므로, 전체 오브젝트 스토어를 업로드하여 이 간극을 메우려고 하지 마십시오.

만약 작업을 실행하는 데 프로덕션 자격 증명(production credentials)이 필요한 경우, 무료 원격 서버는 해당 작업을 수행하기에 잘못된 장소입니다. 또한 신뢰 경계(trust boundary)를 한 문장으로 명시할 수 없는 경우에는 이 워크플로우를 건너뛰어야 합니다. 서버 운영 주체, 로그가 저장되는 위치, 또는 사람이 작업 공간을 열 수 있는지 여부를 모른다면 미러를 로컬로 유지하십시오. 무료 접근은 예산상의 사실일 뿐 보안 검토(security review)는 아니며, 검토가 누락된 것은 기다려야 할 이유입니다.

네트워크 호출이 전혀 없는 상태에서 노트북으로 게이트를 연습하는 것만으로도 원격 경로가 불분명할 때 유용한 오후 시간이 될 수 있습니다. 경계가 명확하고 트리가 의도적으로 단순한 경우, 무료 옵션들은 습관을 기르는 합리적인 교실입니다. 미러를 구축하고, 장치를 실패시키고(fail the fixture), 정제 과정을 통과시킨 후(pass the scrub), 그때 그 단순한 트리와 맞서 원격 상자를 여십시오. 이미 MonkeyCode를 사용하고 있다면, 무료 서버가 실제 트리를 보기 전에 임시 저장소(throwaway repo)에서 해당 순서를 연습하십시오.