시작하기

프로세스

1. 마법사를 실행합니다. 3scale 마법사를 다음 두 가지 방법으로 실행할 수 있습니다.

   • 3scale 계정에 처음 로그인하는 경우 다음과 같이 실행합니다.

   • 다음 URL 주소에서 your_admin_domain 을 교체하여 마법사를 실행합니다.

     https://<your_admin_domain>-admin.3scale.net/p/admin/onboarding/wizard/intro

     예를 들어 관리 도메인이 testing-area이면 다음에서 마법사를 사용할 수 있습니다.

     https://testing-area-admin.3scale.net/p/admin/onboarding/wizard/intro

2. OK, how does 3scale work?를 클릭합니다.
3. 소개 애니메이션을 참조하십시오. 완료되면 Got it! Let’s add my API를 클릭합니다.

4. 백엔드를 생성합니다.

   1. 백엔드 이름을 지정합니다. 예: 인벤토리
   2. 백엔드의 기본 URL을 나타냅니다. 예: https://echo-api.3scale.net:443
   3. 백엔드 추가를 클릭합니다.

5. 제품을 생성합니다.

   1. 제품 이름을 표시합니다. 예: Petstore
   2. 제품 추가를 클릭합니다.

6. 백엔드를 제품에 연결하는 경로를 지정하고 제품에 백엔드 추가를 클릭합니다.

   • 기본값을 그대로 둘 수 있습니다. 경로: /

7. GET 요청으로 테스트를 만들려면 요청 보내기를 클릭합니다.

   • GET 메서드를 지정할 수 있습니다.
8. 이러한 단계를 수행하면 API Gateway에 대한 성공적인 요청이 확인이 표시됩니다. 다음 구성에 대한 자세한 내용은 Cool, what's next?를 클릭하십시오.

프로세스

1. 대시보드로 이동합니다.
2. API 섹션의 백엔드 카드에서 백엔드 생성을 클릭합니다.

3. 다음 세부 정보를 제공합니다.

   • 이름

     백엔드 식별자입니다.

   • 시스템 이름

     내부 목적으로 사용되는 식별자입니다.

   • 설명

     백엔드에 대한 자세한 정보가 포함된 선택적 필드입니다.

   • 프라이빗 기본 URL

     프라이빗 API의 기본 URL 끝점입니다.

4. 백엔드 생성을 클릭합니다.

프로세스

1. 대시보드로 이동합니다. API 섹션의 제품 생성에서 제품 만들기를 클릭합니다.

2. 다음 세부 정보를 제공합니다.

   • 이름

     제품 식별자입니다.

   • 시스템 이름

     내부 목적으로 사용되는 식별자입니다. 제품 system_name은 프록시 끝점 및 도메인 이름을 생성하는 데 사용됩니다. 기본적으로 system_name은 다음과 같은 대체 패턴 중 하나로 사용할 수 있는 레이블의 일부입니다.

     • APIcast 스테이징의 경우

       %{system_name}-%{tenant_name}-apicast-staging

     • APIcast 프로덕션의 경우

       %{system_name}-%{tenant_name}-apicast-production

   • 자동 생성 URL 레이블이 63자를 초과하면 시스템은 다음과 같이 라벨을 줄입니다. < truncated_label>-<unique_hash>

     • <truncated_label>

       원래 URL의 처음 54 또는 55자입니다.

     • <unique_hash>

       고유한 SHA-1 해시의 처음 7 문자는 원래 레이블에서 계산됩니다.

       예를 들어, 잘라내기 전의 URL은 다음과 같습니다.

       https://my-very-long-system-name-also-very-long-tenant-name-apicast-staging.3scale.net

       잘라낸 후의 URL입니다.

       https://my-very-long-system-name-also-very-long-tenant-name-api-72588d2.3scale.net

   • 설명

     제품에 대한 자세한 정보가 포함된 선택적 필드입니다.

3. 제품 생성을 클릭합니다.

프로세스

1. [ your_product_name] > Integration > Backends로 이동합니다.
2. 백엔드 추가를 클릭합니다.

3. 드롭다운 목록에서 다음 작업 중 하나를 수행합니다.

   • 기존 백엔드를 선택합니다.

   • 전체 목록을 보려면 모두 보기를 클릭합니다.

     • 새 백엔드를 생성해야 하는 경우 새 백엔드 만들기를 클릭하고 세부 정보를 완료합니다.
4. 경로 텍스트 상자에 라우팅 경로를 지정합니다. 자세한 내용은 특정 제품의 백엔드 경로를 참조하십시오.
5. 제품에 추가를 클릭합니다.
6. [ your_product_name] > Integration > Configuration 의 제품 탭에서 제품을 승격합니다.

1. 애플리케이션이 요청을 보냅니다.
2. 요청이 공개 URL로 전송됩니다. <public-api-domain>/supplies/list
3. 비공개 URL로 리디렉션하기 전에 백엔드 경로가 제거됩니다. <private-api-domain>/list
4. 요청이 Inventory 백엔드로 리디렉션됩니다.

프로세스

1. 대시보드에서 매핑 규칙을 정의할 백엔드 를 클릭합니다.
2. 탐색 패널에서 매핑 규칙을 클릭합니다.
3. 매핑 규칙 생성 을 클릭합니다.

4. 다음 설정을 지정합니다.

   • verb

     HTTP 요청 동사(GET,POST,DELETE 또는 PUT).

   • 패턴

     일치시킬 패턴입니다. 예: /hello.

   • 증가시킬 메트릭 또는 방법

     메트릭 또는 메서드 이름입니다.

   • 증가 기준

     지표 증가 번호입니다. 예를 들면 1 입니다.

   • 마지막은?

     요청이 Last? 로 표시된 규칙과 일치하는 경우 APIcast는 처리를 중지하고 나머지 매핑 규칙에서 일치하는 항목을 검색하지 않으면 메트릭 증가도 중지합니다.

   • 위치

     매핑 규칙을 정렬하는 매핑 규칙의 위치를 나타내는 번호입니다.

5. 매핑 규칙 생성 을 클릭합니다.

프로세스

1. [ your_product_name] > Applications > Application Plans 로 이동합니다.
2. 애플리케이션 계획 생성을 클릭합니다.
3. 애플리케이션 계획 생성 페이지에서 새 계획의 이름과 시스템 이름을 입력합니다. 시스템 이름은 3scale 설치에서 고유한 이름이어야 합니다.
4. 애플리케이션 계획 생성을 클릭합니다.

프로세스

1. Audience > Accounts > Listing으로 이동합니다.
2. 기본 개발자 계정을 클릭합니다.
3. 애플리케이션 탭을 클릭합니다.
4. 애플리케이션 생성을 클릭합니다.
5. 애플리케이션 생성 대화 상자에서 애플리케이션의 제품을 선택합니다.
6. 애플리케이션 계획을 선택합니다.
7. 애플리케이션 이름을 지정합니다.
8. 설명 필드에 이 애플리케이션에 대한 정보를 입력합니다.
9. 애플리케이션 생성을 클릭합니다.

프로세스

1. 새 APIcast 구성을 스테이징으로 승격합니다.

   1. [ your_product_name] > Integration > Configuration 으로 이동합니다.

   2. APIcast 구성에서 Promote v.[n] to Staging APIcast를 클릭합니다.

      • v.[n]은 승격할 버전 번호를 나타냅니다.
      • 승격할 변경 사항이 없는 경우 Nothing to promote라는 텍스트가 있는 회색 버튼이 있습니다.

2. Staging APIcast에서 Promote v.[n] to Production APIcast를 클릭하여 APIcast 구성을 프로덕션으로 승격합니다.

   • v.[n]은 승격할 버전 번호를 나타냅니다.
   • 승격할 변경 사항이 없는 경우 Nothing to promote라는 텍스트가 있는 회색 버튼이 표시됩니다.

3. API 제품에 대한 요청을 테스트하려면 Example curl에 제공된 명령을 복사하여 터미널에서 테스트합니다.

   • curl 명령 예제는 제품의 첫 번째 매핑 규칙을 기반으로 합니다.
   • 명령을 실행한 후 테스트 중인 백엔드에서 결과가 포함된 HTML 응답이 표시됩니다.
   • 응답이 제공되지 않는 경우 제품의 catch-all 매핑 규칙을 삭제하고 새 APIcast 구성을 스테이징으로 승격한 다음 예제 curl 명령을 실행합니다.

1. Audience > Developer Portal > Settings > Domains & Access 에서 사용자 지정 도메인을 개발자 포털 사이트 필드에 입력합니다.
2. 선택적으로 Outgoing Email 필드에 사용자 정의 아웃 바운드 이메일 주소를 입력합니다.
3. 개발자 포털 액세스 코드를 제거합니다.
4. 계정 업데이트를 클릭하여 변경 사항을 저장합니다.