7.3. Knative CLI 플러그인

사전 요구 사항

• Knative(kn) CLI가 설치되어 있습니다.

절차

• 이벤트를 빌드합니다.

  $ kn event build --field <field-name>=<value> --type <type-name> --id <id> --output <format>

  다음과 같습니다.

  • --field 플래그는 이벤트에 데이터를 필드-값 쌍으로 추가합니다. 여러 번 사용할 수 있습니다.
  • --type 플래그를 사용하면 이벤트 유형을 지정하는 문자열을 지정할 수 있습니다.
  • --id 플래그는 이벤트의 ID를 지정합니다.

  • --output 플래그와 함께 json 또는 yaml 인수를 사용하여 이벤트의 출력 형식을 변경할 수 있습니다.

    이러한 모든 플래그는 선택 사항입니다.

    간단한 이벤트 만들기

    $ kn event build -o yaml

    YAML 형식의 결과 이벤트

    data: {}
    datacontenttype: application/json
    id: 81a402a2-9c29-4c27-b8ed-246a253c9e58
    source: kn-event/v0.4.0
    specversion: "1.0"
    time: "2021-10-15T10:42:57.713226203Z"
    type: dev.knative.cli.plugin.event.generic

    샘플 트랜잭션 이벤트 빌드

    $ kn event build \
        --field operation.type=local-wire-transfer \
        --field operation.amount=2345.40 \
        --field operation.from=87656231 \
        --field operation.to=2344121 \
        --field automated=true \
        --field signature='FGzCPLvYWdEgsdpb3qXkaVp7Da0=' \
        --type org.example.bank.bar \
        --id $(head -c 10 < /dev/urandom | base64 -w 0) \
        --output json

    JSON 형식의 결과 이벤트

    {
      "specversion": "1.0",
      "id": "RjtL8UH66X+UJg==",
      "source": "kn-event/v0.4.0",
      "type": "org.example.bank.bar",
      "datacontenttype": "application/json",
      "time": "2021-10-15T10:43:23.113187943Z",
      "data": {
        "automated": true,
        "operation": {
          "amount": "2345.40",
          "from": 87656231,
          "to": 2344121,
          "type": "local-wire-transfer"
        },
        "signature": "FGzCPLvYWdEgsdpb3qXkaVp7Da0="
      }
    }

사전 요구 사항

• Knative(kn) CLI가 설치되어 있습니다.

절차

• 이벤트 보내기:

  $ kn event send --field <field-name>=<value> --type <type-name> --id <id> --to-url <url> --to <cluster-resource> --namespace <namespace>

  다음과 같습니다.

  • --field 플래그는 이벤트에 데이터를 필드-값 쌍으로 추가합니다. 여러 번 사용할 수 있습니다.
  • --type 플래그를 사용하면 이벤트 유형을 지정하는 문자열을 지정할 수 있습니다.
  • --id 플래그는 이벤트의 ID를 지정합니다.
  • 공개적으로 액세스 가능한 대상으로 이벤트를 보내는 경우 --to-url 플래그를 사용하여 URL을 지정합니다.

  • 클러스터 내 Kubernetes 리소스로 이벤트를 보내는 경우 --to 플래그를 사용하여 대상을 지정합니다.

    • < Kind>:<ApiVersion>:<name > 형식을 사용하여 Kubernetes 리소스를 지정합니다.

  • --namespace 플래그는 네임스페이스를 지정합니다. 생략하면 네임스페이스가 현재 컨텍스트에서 가져옵니다.

    --to-url 또는 --to -to를 사용해야 하는 대상 사양을 제외하고 이러한 모든 플래그는 선택 사항입니다.

    다음 예제에서는 URL로 이벤트를 보내는 방법을 보여줍니다.

    명령 예

    $ kn event send \
        --field player.id=6354aa60-ddb1-452e-8c13-24893667de20 \
        --field player.game=2345 \
        --field points=456 \
        --type org.example.gaming.foo \
        --to-url http://ce-api.foo.example.com/

    다음 예제에서는 클러스터 내 리소스로 이벤트를 전송하는 방법을 보여줍니다.

    명령 예

    $ kn event send \
        --type org.example.kn.ping \
        --id $(uuidgen) \
        --field event.type=test \
        --field event.data=98765 \
        --to Service:serving.knative.dev/v1:event-display