[Ingest Manager] Split OpenAPI spec into multiple files

[jfsiii]

Summary

WIP. First pass at #77290

• spec_entry.json is the version which links to the various files on disk.

• spec_bundled.json is the resolved output of that entry & other files in one file. It's currently generated with

  npx swagger-cli bundle spec_entry.json -o spec_bundled.json

• Paths: this defines each endpoint. A path can have one operation per http method.

  Went with "directory-per-path" approach which is largely "Each operation in a separate file" from paths/README.md. Only index.json at the moment but they can be split out to something like get.json, put.json or some-operation-id.json, have a local examples, etc.

  tree ./paths

  paths/
  ├── README.md
  ├── agent_policies
  │   ├── delete
  │   │   └── index.json
  │   ├── index.json
  │   └── {agent_policy_id}
  │       ├── copy
  │       │   └── index.json
  │       └── index.json
  ├── epm
  │   ├── categories
  │   │   └── index.json
  │   └── packages
  │       ├── index.json
  │       └── {pkgkey}
  │           └── index.json
  ├── fleet
  │   ├── agent-status
  │   │   └── index.json
  │   ├── agents
  │   │   ├── enroll
  │   │   │   └── index.json
  │   │   ├── index.json
  │   │   └── {agent_id}
  │   │       ├── acks
  │   │       │   └── index.json
  │   │       ├── checkin
  │   │       │   └── index.json
  │   │       ├── events
  │   │       │   └── index.json
  │   │       ├── index.json
  │   │       └── unenroll
  │   │           └── index.json
  │   ├── enrollment_api_keys
  │   │   ├── index.json
  │   │   └── {key_id}
  │   │       └── index.json
  │   ├── install
  │   │   └── {os_type}
  │   │       └── index.json
  │   └── setup
  │       └── index.json
  ├── package_policies
  │   ├── index.json
  │   └── {package_policy_id}
  │       └── index.json
  └── setup
      └── index.json
  

• Components: Reusable components like schemas,
  responses
parameters, etc

  tree ./components

  components/
  ├── README.md
  ├── callbacks
  ├── examples
  ├── headers
  ├── links
  ├── parameters
  │   ├── kuery_param.json
  │   ├── page_index_param.json
  │   ├── page_size_param.json
  │   └── xsrf_header.json
  ├── request_bodies
  ├── responses
  ├── schemas
  │   ├── access_api_key.json
  │   ├── agent.json
  │   ├── agent_event.json
  │   ├── agent_metadata.json
  │   ├── agent_policy.json
  │   ├── agent_status.json
  │   ├── agent_type.json
  │   ├── enrollment_api_key.json
  │   ├── new_agent_event.json
  │   ├── new_agent_policy.json
  │   ├── new_package_policy.json
  │   ├── package_info.json
  │   ├── package_policy.json
  │   └── search_result.json
  └── security_schemes
      ├── access_api_key.json
      ├── basic_auth.json
      └── enrollment_api_key.json
  

Checklist

Delete any items that are not applicable to this PR.

• Any text added follows EUI's writing guidelines, uses sentence case text and includes i18n support
• Documentation was added for features that require explanation or tutorials
• Unit or functional tests were updated or added to match the most common scenarios
• This was checked for keyboard-only and screenreader accessibility
• This renders correctly on smaller devices using a responsive layout. (You can test this in your browser
• This was checked for cross-browser compatibility

[jfsiii]

@elasticmachine merge upstream

[kibanamachine]

💚 Build Succeeded

• continuous-integration/kibana-ci/pull-request
• Commit: c978843

Build metrics

distributable file count

id	value	diff	baseline
default	45589	+44	45545

History

• 💚 Build #74330 succeeded c55d667
• 💔 Build #74239 failed 63f9354
• 💔 Build #74226 failed a6da8cd

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

[jfsiii]

was replaced by #80107

[jfsiii]

was replaced by #80107