Operations & Troubleshooting

Keeping Firestone Running Smoothly

This section provides practical guidance for operating and troubleshooting firestone workflows.

1. Troubleshooting Generation Failures

Diagnose and fix errors that occur during spec generation (syntax errors, invalid schema).

2. Troubleshooting Validation Errors

Identify and resolve issues where your API implementation doesn't match the generated contract.

3. Understanding OpenAPI Specifications

Interpret Firestone-generated OpenAPI specs and debug output structure.

4. Client & Server Generation

Workflows for using openapi-generator with Firestone outputs.

5. Running in Docker

Using the official Docker image for consistent builds.

6. Swagger UI Server

Operational tips for the built-in --ui-server.

Pages in this section:

• Security Schemes
• Running in Docker
• Authentication Patterns
• Naming Conventions
• Custom Templates
• Understanding the Generated OpenAPI Spec
• Generation Failures
• Design Philosophy
• Versioning Strategies
• Using the Integrated Swagger UI Server
• Security Best Practices
• Schema References & Reuse
• OpenAPI Ecosystem Integration
• Schema Design
• JSON Schema Validation
• Client & Server Generation
• Multi-Resource APIs
• Advanced Pagination & Filtering
• API Design Principles