Filesystem

Overview

A Filesystem Catalog is a method for storing and retrieving schemas, API definitions, and configuration files directly from a local filesystem. In Zilla, the Filesystem Catalog enables direct schema resolution from local files, eliminating the need for external dependencies. This simplifies configuration management and improves performance by reducing network overhead while enforcing strict schema validation. Key benefits include:

• Local Schema Storage: Retrieve schemas and API definitions directly from the filesystem for faster access.
• Enforced Schema Validation: Ensures all messages conform to predefined schemas, preventing format mismatches.

catalogs:
  my_catalog:
    type: filesystem
    options:
      subjects:
        my_local_file:
          path: path/to/local_file.txt

Usage Example

Validating API Traffic with an HTTP Proxy

The http.kafka.proto.json example showcases how Zilla enables sending a protobuf object as JSON to a REST endpoint, where it is validated and converted to protobuf before being produced onto Kafka.

Configuration (* required)

options

options

object

The filesystem specific options.

Property	Type	Description
options.subjects	Map<string, object>	Unique identifier for artifact categorization in the catalog.
options.subjects.path*	string	Path to access artifact from the filesystem. The paths are relative to zilla.yaml.