프로젝트 IDX 문제 해결 및 FAQ

작업공간을 여는 동안 요청을 백엔드로 전달할 수 없습니다. 포트 80에서 서버에 연결할 수 없습니다.

이는 알려진 문제입니다. 이 문제를 해결하려면 약 5초 동안 기다린 후 페이지를 새로고침하세요.

미리보기가 손상되었지만 코드에는 아무런 문제가 없습니다 IDX를 다시 시작하려면 어떻게 해야 하나요?

일반적으로 주요 리팩터링이나 monospace.json 파일 변경으로 인해 IDX가 제대로 새로고침되지 않으면 IDX 카테고리의 명령어 팔레트(Mac의 경우 Cmd+Shift+P 또는 ChromeOS, Windows, Linux의 경우 Ctrl+Shift+P)에서 사용할 수 있는 강제 다시 시작을 실행합니다.

작업공간을 만드는 중에 앗.. 새 VM을 가동해야 하는데 이후에 UI가 멈춥니다.

IDX는 주문형 작업공간을 프로비저닝하는 데 사용되는 VM의 웜 풀을 유지관리합니다. 풀이 부족하면 새 VM이 가동된 후 작업공간이 프로비저닝됩니다. 이 프로세스는 시간이 걸릴 수 있으며 (경우에 따라 최대 5분) 결국에는 성공적으로 처리됩니다.

작업공간을 만드는 중에 내부 오류가 발생했습니다라는 메시지가 표시됨

대부분의 경우 작업공간 프로비저닝 중에 내부 오류가 발생하는 경우 1분 정도 후에 페이지를 새로고침하면 오류가 지나 작업공간으로 이동됩니다.

계정에 여러 개의 작업공간을 사용할 수 있나요?

IDX에서는 사용자당 작업공간이 1개로 제한됩니다. Google 개발자 프로필이 있는 경우 작업공간을 최대 5개까지 만들 수 있습니다. 작업공간 한도에 도달한 후 IDX에서 직접 Google 개발자 프로필을 만들려면 템플릿 대시보드의 알림에서 설정 완료를 클릭합니다.

작업공간이 로드되지만 에뮬레이터가 비어 있음

클라우드 기반 에뮬레이터의 안정성을 개선하기 위해 적극적으로 노력하고 있습니다. 페이지 새로고침으로 문제가 해결되지 않으면 문제를 신고하세요.

IDX 작업공간에 내 프로젝트와 호환되지 않는 Flutter 버전이 있습니다.

apt-get 또는 Br을 사용하여 로컬 머신에서 하는 것처럼 작업공간 내에서 거의 모든 사전 설치된 소프트웨어의 버전을 업그레이드하거나 다운그레이드할 수 있습니다. '유휴' 작업공간이 최대 절전 모드로 전환되면 변경사항이 유지되지 않습니다.

Project IDX와 Google Cloud Workstations의 차이점은 무엇인가요?

IDX는 Google Cloud의 정식 Cloud Workstations 제품에 빌드되었습니다 Cloud Workstations는 개발자 워크스테이션의 안정성, 보안, 가용성에 중점을 둔 인프라 제품입니다. 개발 환경을 관리하려는 대기업에 적합합니다. 프로젝트 IDX는 이러한 워크스테이션 내의 '배터리가 포함된' 환경으로, 다양한 애플리케이션 유형을 빌드하는 데 필요한 도구 모음, 소프트웨어 개발 스택, 시스템 종속 항목을 관리합니다.

Linux에 익숙하지 않습니다. Project IDX에서 생산성을 높이려면 어떻게 해야 하나요?

프로젝트 IDX는 프로젝트의 시스템 수준 소프트웨어 종속 항목을 설치하고 관리하는 데 사용할 수 있는 Debian 셸을 노출합니다. apt와 같은 OS별 패키지 관리자의 세부사항을 이해하지 않고도 시스템 소프트웨어 종속 항목을 구성으로 관리하는 데 사용할 수 있는 OS 제약이 없는 Nix 기반 셸로 곧 이전됩니다. 감사합니다

IDX에서 서드 파티 (3P) 쿠키를 사용 설정해야 하는 이유는 무엇인가요?

한 도메인 (cloudworkstations.dev의 하위 도메인)에서 다른 도메인 (idx.google.com)에 있는 IFRAME을 렌더링하고 서드 파티 쿠키가 안전한 교차 출처 통신을 지원하므로 IDX에는 서드 파티 쿠키가 사용 설정되어 있어야 합니다.

작업공간 URL은 작업공간에 대한 액세스 권한이 있는 사용자에게만 공유할 수 있습니다. 권한이 없는 사용자가 URL을 방문하려고 하면 오류가 표시됩니다. Google 문서 공유와 같이 작업공간을 명시적으로 공유해야 합니다.

작업공간에 추가된 사용자는 VM의 전체 파일 시스템에 대한 완전한 액세스 권한을 가지며 여기에는 비공개 키 및 액세스 토큰과 같은 민감한 파일이 포함될 수 있습니다. 신뢰할 수 있는 사용자와만 작업공간을 공유하세요. 이 방법을 사용하면 다른 사용자가 작업공간의 정확한 상태를 볼 수 있지만, 작업공간의 모든 항목을 볼 수 있습니다.

IDX를 사용하여 애플리케이션을 Firebase에 배포하면 작업을 수행하는 데 필요한 가장 기본적인 권한으로만 작업공간이 프로비저닝됩니다. 사용자가 프로젝트의 관리자일 수 있지만 작업공간 자체에는 최소 권한의 원칙에 따라 작동하는 소유자의 모든 권한이 있는 것은 아닙니다.

IDX에서 지원하지 않는 프레임워크를 사용하여 애플리케이션을 빌드할 수 있나요?

물론입니다. Google에서는 작업공간을 완전히 맞춤설정할 수 있도록 하기 위해 노력하고 있지만, 지원되지 않는 프런트엔드 프레임워크를 사용하거나 UI가 전혀 없는 프로젝트를 가져올 수도 있습니다. 이를 극복하는 가장 간단한 방법은 저장소 가져오기 흐름에서 앱 유형으로 기타를 선택하는 것입니다. 작업공간을 설정한 후에는 프로젝트에 필요한 시스템 수준 종속 항목을 설치할 수 있습니다.

GitLab 또는 Cloud Source 저장소에서 저장소를 가져올 수 있나요?

현재는 GitHub가 지원됩니다. Google에서 더 많은 Git 호스트를 지원하려면 기능 요청을 제출하세요.

그동안에는 기존 템플릿에서 새 작업공간을 만들고 로컬 머신에서 일반적으로 하는 것처럼 터미널에서 https 또는 ssh 기반 Git 호스트와 함께 git clone를 실행할 수 있습니다.

Firebase 호스팅에 Flutter 앱을 배포할 때 어떤 대상 디렉터리를 선택해야 하나요?

build/web 디렉터리를 선택합니다. 이 디렉터리에는 index.html 및 flutter build web를 통해 앱이 성공적으로 빌드된 후 웹 앱을 렌더링하는 데 필요한 모든 정적 애셋이 포함되어야 합니다.

프런트엔드가 대화할 수 있도록 작업공간에 앱의 백엔드를 설정하려면 어떻게 해야 하나요?

가까운 시일 내에 이를 간소화할 계획이지만 지금은 다음 해결 방법을 사용하세요.

API 백엔드가 있는 프로젝트는 터미널에서 수동으로 API 서비스를 시작하거나 monospace.json 파일에서 시작 명령어를 구성할 수 있습니다.
터미널에서 다음 bash 스크립트를 실행하여 웹 프런트엔드 미리보기에 액세스할 수 있도록 API 서비스가 실행되는 포트를 엽니다.
```
export port=4000 #dont use restricted ports (8000, 9000-9002)
export API_SERVICE="https://$port-$WEB_HOST"
echo $API_SERVICE
```
브라우저의 새 탭 위에 있는 API_SERVICE URL를 엽니다. 이렇게 하면 리디렉션 흐름을 통해 필요한 쿠키가 설정됩니다.
이제 웹 앱 프런트엔드가 정규화된 경로에서 API 서비스에 액세스할 수 있습니다.

미리보기 탭을 닫았습니다 다시 가져오려면 어떻게 해야 하나요?

명령어 팔레트 (Mac의 경우 Cmd+Shift+P, ChromeOS, Windows, Linux의 경우 Ctrl+Shift+P)를 열고 프로젝트 IDX: 웹 미리보기 표시를 선택합니다.

코드 OSS란 무엇인가요?

Code-Open Source Software (Code-OSS)는 VS Code의 핵심 레이어인 오픈소스 프로젝트입니다. Code-OSS는 GitHub에서 표준 MIT 라이선스에 따라 사용할 수 있으며 Microsoft가 VS Code 제품을 개발하는 곳입니다.

코드 완성 및 Gemini 채팅 프롬프트가 학습 데이터로 사용되지 않게 하려면 어떻게 해야 하나요?

IDX에서 Gemini를 개선하기 위해 Gemini 채팅 메시지를 학습 데이터로 사용하지 않으려면 채팅 어시스턴트를 사용하지 말고 작업공간 설정에서 코드 완성을 사용 중지하세요.

기능 요청이나 발생한 문제에 관한 의견을 제출하려면 어떻게 해야 하나요?

프로젝트 IDX를 사용하는 동안 문제가 발생하면 버그를 신고하여 알려주세요.

IDX에 추가하려는 기능이 있거나 확장하려는 기존 기능이 있는 경우 기능 요청을 제출하세요.

IDX는 버그와 기능 요청에 IssueTracker를 사용하여 스크린샷과 동영상으로 강력한 요청을 지원합니다. 향후 IDX는 UserVoice를 통해 의견과 기능을 추적할 수 있습니다. UserVoice를 통해 이미 제출된 모든 의견이나 요청은 보존되어 팀과 공유되었습니다.

거주 국가 또는 지역에서 IDX의 Gemini를 사용할 수 있는지 확인하려면 어떻게 해야 하나요?

IDX의 Gemini는 제한된 리전에서 사용할 수 있으며 정기적으로 지원 범위가 확대됩니다. IDX의 Gemini를 사용할 수 있는 리전은 작업공간에 Gemini 추가에 설명된 단계에 따라 작업공간에 추가할 수 있습니다.

Project IDX에서 특정 기능을 사용 중이었는데 더 이상 찾을 수 없습니다. 콘텐츠가 삭제된 이유는 무엇인가요?

Project IDX의 일부 기능은 실험용입니다. Google은 사용자의 의견을 소중하게 생각하며 이를 적극적으로 활용하여 현재 또는 계획된 기능 세트에 정보를 제공하고, 사용자의 기대나 Google의 품질에 부합하지 않는 기능은 주기적으로 삭제합니다. 이상적인 버전의 Project IDX에서 바라는 기능이 있다면 의견을 보내주세요. Google은 여러분의 의견을 소중하게 생각합니다.