Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

5.14. ActiveDocs 생성

3scale toolbox를 사용하여 개발자 포털에서 ActiveDocs를 생성, 업데이트, 나열 또는 삭제합니다.

5.14.1. 새 ActiveDocs 생성
링크 복사

OpenAPI 사양을 준수하는 API 정의에서 새 ActiveDocs를 생성하려면 다음을 수행하십시오.

  1. API 정의를 3scale에 추가하고 선택적으로 이름을 지정합니다. 

    3scale activedocs create <remote> <activedocs-name> <specification>
    Copy to Clipboard Toggle word wrap

    ActiveDocs에 대한 OpenAPI 사양이 필요하며 다음 값 중 하나여야 합니다.

    • 사용 가능한 경로의 파일 이름입니다.
    • toolbox가 콘텐츠를 다운로드할 수 있는 URL입니다. 지원되는 스키마는 http 및 https 입니다.

    • stdin 표준 입력 스트림에서 읽습니다. 이 값은 - 값을 설정하여 제어됩니다.

      ActiveDocs를 생성하는 동안 다음 옵션을 사용합니다. 

      Options
    -d --description=<value>        Specify the description of
                                    the ActiveDocs
    -i --service-id=<value>         Specify the Service ID
                                    associated to the ActiveDocs
    -o --output=<value>             Output format on stdout: one
                                    of json|yaml
    -p --published                  Specify to publish the
                                    ActiveDocs on the Developer
                                    Portal. Otherwise it is hidden.
    -s --system-name=<value>        Specify the system-name of
                                    the ActiveDocs
       --skip-swagger-validations   Specify to skip validation
                                    of the Swagger specification
Options for ActiveDocs
    -c --config-file=<value>        toolbox configuration file.
                                    Defaults to $HOME/.3scalerc.yaml
    -h --help                       Print help for this command
    -k --insecure                   Proceed and operate even for
                                    server connections otherwise
                                    considered insecure
    -v --version                    Print the version of this command
       --verbose                    Verbose mode
      Copy to Clipboard Toggle word wrap
  2. 개발자 포털에 정의를 게시합니다.

5.14.2. ActiveDocs 생성 또는 업데이트
링크 복사

다음 명령을 사용하여 ActiveDocs가 없는 경우 새 ActiveDocs를 생성하거나 기존 ActiveDocs를 새 API 정의로 업데이트합니다. 

3scale activedocs apply <remote> <activedocs_id_or_system_name>
Copy to Clipboard Toggle word wrap

ActiveDocs를 업데이트하는 동안 다음 옵션을 사용합니다. 

Options
  -d --description=<value>              Specify the description of the
                                        ActiveDocs
       --hide                           Specify to hide the ActiveDocs
                                        on the Developer Portal
 -i --service-id=<value>                Specify the Service ID associated
                                        to the ActiveDocs
 -o --output=<value>                    Output format on stdout:
                                        one of json|yaml
    --openapi-spec=<value>              Specify the Swagger specification.
                                        Can be a file, a URL or '-' to read
                                        from stdin. This is a mandatory
                                        option when applying the ActiveDoc
                                        for the first time.
 -p --publish                           Specify to publish the ActiveDocs
                                        on the Developer Portal. Otherwise
                                        it is hidden
 -s --name=<value>                      Specify the name of the ActiveDocs
    --skip-swagger-validations=<value>  Specify whether to skip validation
                                        of the Swagger specification: true
                                        or false. Defaults to true.

Options for ActiveDocs
    -c --config-file=<value>           3scale toolbox configuration file:
                                       defaults to $HOME/.3scalerc.yaml
    -h --help                          Print help for this command
    -k --insecure                      Proceed and operate even for server
                                       connections otherwise considered
                                       insecure
    -v --version                       Print the version of this command
       --verbose                       Verbose mode
Copy to Clipboard Toggle word wrap
참고

activedocs의 동작은 3scale 2.8에서 --skip-swagger-validations 가 변경되었습니다. activedocs를 사용하여 기존 스크립트를 업데이트해야 할 수도 있습니다. 이전에는 각 activedocs 에서 이 옵션을 지정하지 않은 경우 검증을 건너뛰지 않았습니다. 이제 --skip-swagger-validations 가 기본적으로 true 입니다.

5.14.3. ActiveDocs 나열
링크 복사

다음 명령을 사용하여 다음을 포함하여 개발자 포털의 모든 ActiveDocs에 대한 정보를 가져옵니다.

  • id
  • name
  • 시스템 이름
  • description
  • 게시됨(개발자 포털에 표시 가능)
  • 생성 날짜
  • 최신 업데이트 날짜

다음 명령은 정의된 모든 ActiveDocs를 나열합니다. 

3scale activedocs list <remote>
Copy to Clipboard Toggle word wrap

ActiveDocs를 나열하는 동안 다음 옵션을 사용합니다. 

Options
    -o --output=<value>           Output format on stdout:
                                  one of json|yaml
    -s --service-ref=<value>      Filter the ActiveDocs by service
                                  reference
Options for ActiveDocs
    -c --config-file=<value>      3scale toolbox configuration file:
                                  defaults to $HOME/.3scalerc.yaml
    -h --help                     Print help for this command
    -k --insecure                 Proceed and operate even for server
                                  connections otherwise considered insecure
    -v --version                  Print the version of this command
       --verbose                  Verbose mode
Copy to Clipboard Toggle word wrap

5.14.4. ActiveDocs 삭제
링크 복사

다음 명령은 ActiveDocs를 제거합니다. 

3scale activedocs delete <remote> <activedocs-id_or-system-name>
Copy to Clipboard Toggle word wrap

ActiveDocs를 삭제하는 동안 다음 옵션을 사용합니다. 

Options for ActiveDocs
    -c --config-file=<value>      3scale toolbox configuration file:
                                  defaults to $HOME/.3scalerc.yaml
    -h --help                     Print help for this command
    -k --insecure                 Proceed and operate even for server
                                  connections otherwise considered insecure
    -v --version                  Print the version of this command
       --verbose                  Verbose mode
Copy to Clipboard Toggle word wrap
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat