Apigee 작업공간 관리

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Cloud Code를 사용하여 로컬로 Apigee API를 개발하려면 먼저 Cloud Code에서 Apigee 작업공간을 새로 만들거나 열어야 합니다. Apigee 작업공간에는 로컬 개발에 필요한 디렉터리 구조가 포함됩니다.

다음 섹션에서는 Apigee 작업공간을 만들고 열고 관리하는 방법을 설명합니다.

Apigee 작업공간 만들기

Apigee 작업공간을 만들려면 다음 안내를 따르세요.

다음 작업 중 하나를 수행합니다.
- 현재 열려 있는 Apigee 작업공간이 없는 경우 Apigee 섹션에서 Apigee 작업공간 만들기를 클릭합니다.
- 보기 > 명령어 팔레트를 선택하여 명령어 팔레트를 열고 Cloud Code: Apigee 작업공간 만들기를 선택합니다.
원하는 개발 스타일과 일치하는 작업공간 유형을 선택합니다. 단일 저장소 작업공간 또는 다중 저장소 작업공간 중에서 선택할 수 있습니다.
Apigee 작업공간의 이름을 입력합니다.
Apigee 작업공간을 저장할 디렉터리로 이동합니다. 소스 제어 관리를 사용하는 경우 소스 제어 저장소에 있는 위치를 선택합니다.
작업공간 폴더 선택을 클릭합니다. Apigee 작업공간이 생성되어 지정된 로컬 디렉터리에 저장되고 VS Code 탐색기에서 열립니다.
작업 표시줄에서 Cloud Code 아이콘을 클릭합니다.

Apigee 작업공간이 Apigee 섹션에 표시됩니다.

API 프록시, 공유 흐름, 환경, 테스트를 포함한 Apigee 작업공간 폴더가 표시된 Apigee 탐색기

선택한 워크스페이스 유형에 따라 다음 콘텐츠가 생성됩니다.

단일 저장소 작업공간의 경우 your-workspace-location 아래에 폴더 집합이 생성됩니다. 자세한 내용은 Apigee 단일 저장소 작업공간 구조 이해를 참조하세요.
다중 저장소 작업공간의 경우 필수 JSON 콘텐츠로 your-workspace-location.code-workspace라는 파일이 생성됩니다. 자세한 내용은 Apigee 다중 저장소 작업공간 구조 이해를 참조하세요.

Apigee 작업공간 열기

기존 Apigee 작업공간을 열려면 다음 안내를 따르세요.

다음 작업 중 하나를 수행합니다.
- 현재 열려 있는 Apigee 작업공간이 없는 경우 Apigee 탐색기 로컬 개발 노드에서 Apigee 작업공간 열기를 클릭합니다.
- 보기 > 명령어 팔레트를 선택하여 명령어 팔레트를 열고 Cloud Code: Apigee 작업공간 열기를 선택합니다.
로컬 환경의 Apigee 작업공간으로 이동합니다.
- 단일 저장소 작업공간을 여는 경우 src/main/apigee 폴더가 포함된 Apigee 작업공간의 최상위 폴더를 선택합니다.
- 다중 저장소 작업공간을 여는 경우 확장자가 .code-workspace인 작업공간 파일을 선택합니다.
작업공간 폴더 또는 다중 저장소 작업공간 파일 선택을 클릭합니다. Apigee 작업공간이 작업공간 콘텐츠를 탐색할 수 있는 Cloud Code에서 열립니다.
작업 표시줄에서 Cloud Code 아이콘을 클릭합니다.

Apigee 작업공간이 Apigee 탐색기에 표시됩니다.

API 프록시, 공유 흐름, 환경, 테스트를 포함한 Apigee 작업공간 폴더가 표시된 Apigee 탐색기

Apigee 단일 저장소 작업공간 구조 이해

Google Cloud의 Apigee에서 단일 저장소 Apigee 작업공간을 만들면 API 프록시와 공유 흐름을 개발하고 환경을 구성 및 배포하고 테스트 리소스를 빌드 및 내보낼 수 있는 폴더 모음이 생성됩니다. Apigee 작업공간은 로컬 환경의 your-workspace-folder/src/main/apigee에 저장됩니다.

다음 표에는 개략적인 Apigee 작업공간 구조가 요약되어 있습니다.

폴더	설명
`apiproxies`	API 프록시 구성 디렉터리 구조에 설명된 대로 구성된, 각 API 프록시 구성에 대한 별도의 `apiproxy-name/apiproxy` 폴더를 포함합니다. 예를 들면 `helloworld/apiproxy`입니다. 자세한 내용은 API 프록시 개발을 참조하세요.
`environments`	다음을 포함하여 배포하려는 API 프록시 및 공유 흐름의 런타임 실행 컨텍스트를 정의합니다. API 프록시 및 공유 흐름 배포 정의 환경 수준 리소스 공유 흐름 후크 대상 서버 키 저장소 자세한 내용은 환경 구성 및 배포를 참조하세요.
`sharedflows`	공유 흐름 번들 구성 참조에 설명된 대로 구성된, 각 공유 흐름 구성에 대한 별도의 `sharedflow-name/sharedflowbundle` 폴더를 포함합니다. 예를 들면 `mysharedflow/sharedflowbundle`입니다. 자세한 내용은 공유 흐름 개발을 참조하세요.
`tests`	API를 로컬에서 테스트하는 데 필요한 API 제품 또는 개발자와 같은 테스트 리소스 집합을 제공합니다. 자세한 내용은 테스트 리소스 빌드 및 내보내기를 참조하세요.

로컬 환경에서 Apigee 작업공간의 구조에 대한 예시를 참조하세요. 여기서 src/main/apigee는 루트입니다.

Cloud Code의 Apigee 작업공간 구조

Apigee 다중 저장소 작업공간 구조 이해

다중 저장소 작업공간은 Cloud Code의 다중 루트 작업공간과 비슷하게 작동합니다. 사용자에게 아티팩트를 개별적으로 저장할 수 있는 위치를 선택하는 동시에 단일 작업공간을 사용하여 함께 개발할 수 있는 유연성을 제공합니다. 예를 들어 사용자가 프록시당 소스 코드 관리 저장소 하나를 선호하는 경우입니다.

다중 저장소 작업공간은 확장자가 .code-workspace인 JSON 텍스트 파일입니다.

이는 2개의 API 프록시(authentication-proxy, products-proxy), 공유 흐름(SF-threat-protection) 2개, 환경(dev, test) 1개, 테스트 번들(test-products) 1개가 포함된 다중 저장소 작업공간 콘텐츠의 예시입니다.

{
  "folders": [
    {
      "name": "authentication-proxy",
      "type": "proxy",
      "path": "/work/quickdemo/multi/authentication-proxy"
    },
    {
      "name": "products-proxy",
      "type": "proxy",
      "path": "/work/quickdemo/multi/products-proxy"
    },
    {
      "name": "SF-threat-protection",
      "type": "sharedflow",
      "path": "/work/quickdemo/multi/SF-threat-protection"
    },
    {
      "name": "dev",
      "type": "environment",
      "path": "/work/quickdemo/multi/dev"
    },
    {
      "name": "test",
      "type": "environment",
      "path": "/work/quickdemo/multi/test"
    },
    {
      "name": "test-products",
      "type": "test",
      "path": "/work/quickdemo/multi/test-products"
    }
  ]
}

다음 요구사항은 다중 저장소 작업공간에 추가할 수 있는 각 폴더 유형에 적용됩니다.

폴더 유형	필수 폴더 구조
`environment`	환경 구성에 설명된 대로 환경 구성을 정의합니다. 폴더 이름은 환경 이름으로 사용됩니다.
`proxy`	API 프록시 구성 디렉터리 구조에 설명된 대로 API 프록시 구조를 정의합니다. 폴더 이름은 API 프록시의 이름으로 사용됩니다.
`sharedflow`	공유 흐름 번들 구성 참조에 설명된 대로 구조를 사용하여 공유 흐름을 정의합니다. 폴더 이름은 공유 흐름의 이름으로 사용됩니다.
`test`	테스트 리소스 빌드에 설명된 대로 테스트 리소스 집합을 정의합니다. 폴더 이름은 테스트 리소스의 이름으로 사용됩니다.

Apigee 다중 저장소 작업공간 수정

Cloud Code 또는 원하는 편집기에서 your-workspace.code-workspace 파일을 열어 다중 저장소 작업공간을 수정합니다.

Cloud Code에서 Apigee 확장 프로그램의 파일을 열려면 다음 안내를 따르세요.

Apigee 탐색기 로컬 개발 노드에서 작업공간 수정을 클릭합니다.
보기 > 명령어 팔레트를 선택하여 명령어 팔레트를 열고 Cloud Code: 작업공간 수정을 선택합니다.

Apigee 작업공간에서 폴더 및 파일 관리

다음 섹션에서는 Apigee 작업공간에서 폴더와 파일을 관리하는 방법을 설명합니다.

Apigee 작업공간에서 파일 수정

Apigee 작업공간에서 파일을 수정하려면 다음 안내를 따르세요.

Apigee 탐색기에서 수정할 파일의 이름을 클릭합니다. 편집기에 콘텐츠가 표시됩니다.
필요에 따라 파일을 수정합니다.
파일 > 저장 또는 ⌘S를 선택해 수정사항을 저장합니다.

Apigee 작업공간에서 폴더 및 파일 복사

Apigee 작업공간에서 폴더 또는 파일을 복사하려면 다음 안내를 따르세요.

Apigee 탐색기에서 복사할 폴더 또는 파일을 마우스 오른쪽 버튼으로 클릭하고 복사를 선택합니다.
폴더 또는 파일의 고유한 이름을 입력하고 Enter 키를 누릅니다.

복사한 폴더 또는 파일이 Apigee 작업공간에 표시됩니다.

Apigee 작업공간에서 폴더 및 파일 이름 바꾸기

Apigee 작업공간에서 폴더 또는 파일의 이름을 바꾸려면 다음 안내를 따르세요.

Apigee 탐색기에서 복사할 폴더 또는 파일을 마우스 오른쪽 버튼으로 클릭하고 이름 바꾸기를 선택합니다.
폴더 또는 파일의 고유한 이름을 입력하고 Enter 키를 누릅니다.

Apigee 탐색기에서 폴더 또는 파일의 이름이 변경됩니다.

Apigee 작업공간에서 폴더 및 파일 삭제

Apigee 작업공간에서 폴더 또는 파일을 삭제하려면 Apigee 탐색기에서 복사할 폴더 또는 파일을 마우스 오른쪽 버튼으로 클릭하고 삭제를 선택합니다. Apigee 작업공간에서 폴더 또는 파일이 삭제됩니다.

Apigee 작업공간 뷰 새로고침

Apigee 작업공간 뷰를 새로고침하고 Cloud Code의 외부에서 최근 변경한 사항을 동기화하려면 다음 작업 중 하나를 수행합니다.

Apigee 탐색기 제목 표시줄에 커서를 놓고 를 클릭합니다.
보기 > 명령어 팔레트를 선택하여 명령어 팔레트를 열고 Cloud Code: Apigee 탐색기 보기 새로고침를 선택합니다.