You can visualize and explore your service’s OpenAPI specification (formerly known as Swagger) documentation from within Ambassador Cloud.
You must have Edge Stack or Emissary-ingress version 2.0+ Developer Preview installed and connected to Ambassador Cloud in your Kubernetes cluster. This guide assumes you have deployed the
quoteapplication and resources from the Service Catalog quick start.
Enable reporting the
quoteservice documentation by creating, or editing, the
quote-backendAmbassadorMapping resource with the following docs path
/.ambassador-internal/openapi-docsshellecho '---apiVersion: x.getambassador.io/v3alpha1kind: AmbassadorMappingmetadata:name: quote-backendspec:hostname: "*"prefix: /backend/service: quotedocs:path: "/.ambassador-internal/openapi-docs"' | kubectl apply -f -
Navigate to Ambassador Cloud to see your connected services.
Select the quote service from the Service Catalog page.
Click on the API tab to access the rendered OpenAPI documentation.
You've published your service documentation on Ambassador Cloud to enable collaboration with other teams and members of your organization, but you can extend your services AmbassadorMapping with other Developer Portal docs options, and Service Catalog annotations! See the full list of service annotations here.