Skip to content

Commit

Permalink
Merge pull request #104 from ortelius/dev
Browse files Browse the repository at this point in the history
Added Swagger
  • Loading branch information
TracyRagan authored Dec 8, 2022
2 parents ce09ae5 + 69cbe9a commit 00eaa6c
Show file tree
Hide file tree
Showing 3 changed files with 25 additions and 4 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,6 @@ This section shows a list of all _Applications_ that are consuming this _Compone

Give your users more information about your Container, Application File or Database Component. You can upload an external readme file to provide any information that you need to convey to your potential consumers. Use the 'Upload' option to select a file. It must be in text format. You can also automate the upload - see below.


## Component Swagger

Publish your Swagger API definitions to provide further information about your restful APIs and the parameters needed. Ortelius takes your .json or .yaml file and renders it using [Swagger](https://swagger.io/). Use the 'Upload' option to associate your .json or .yaml file to that specific _Component Version_. You can also automate the upload - see below.
Expand All @@ -155,10 +154,9 @@ Component vulnerabilities are based on your SBOM. Every thirty minutes, Ortelius

Report the license associated with your code base for your _Component_. Use the 'Upload' option to import your License file into Ortelius. The file must be in a text format.


## Automate the Readme, SBOM, License, and Swagger Upload via Your Pipeline.

You can automatically upload you readme, SBOM, License, and Swagger data using the Command Line Interface (CLI) added to your pipeline. For more information review the [CI/CD CLI integration document](https://docs.ortelius.io/guides/userguide/integrations/ci-cd_integrations/).
You can automatically upload you readme, SBOM, License, and Swagger data using the Command Line Interface (CLI) added to your pipeline. For more information review the [CI/CD CLI details](https://github.com/Ortelius/cli/blob/main/doc/dh.md). You will find a complete list of parameters for collecting Swagger, SBOM and other tool reports and results. .

{{% include "guides/userguide/reusable/AuditTrail-withDeployments.md" %}}

Expand Down
21 changes: 21 additions & 0 deletions content/en/guides/userguide/integrations/swagger.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: "Swagger Integration"
linkTitle: "Swagger Integration"
weight: 315
description: >
Tracking Swagger for Your Component
---

## Swagger

Ortelius uses [Swagger](https://swagger.io/) to display your microservice / API documentation, based on your _Component Version_. Developers create, or automate the creation of Swagger documentation. Once created the Swagger documentation can be associated to the _Component Version_.

### Uploading Swagger Documentation

You can use the Ortelius _Component_ Detail view to manually upload your Swagger documentation for your _Component_. Alternatively, the recommended approach is to use the CI/CD Command Line Interface to automatically add your Swagger documentation file. Refer to the [CI/CD CLI details](https://github.com/Ortelius/cli/blob/main/doc/dh.md) for incorporating Swagger into your pipeline process.

> Note: Swagger or OpenAPI formats can be used.
### Viewing Component CVE Data

Swagger data is associated to a particular _Component Version_ and can be seen by going to the Component Detail View.
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,9 @@

In order to continuously gather pipeline intelligence, Ortelius must become part of your pipeline. Ortelius integrates into your CI/CD process using the Ortelius Command Line (CLI). The Ortelius CLI gathers supply chain data based on a single pipeline workflow at the build and deploy steps. The build step gathers Swagger, SBOM, Readme, licenses, Git data, Docker image, and other build output. The deploy step records when a release occurs, what was sent and where the objects were sent to.

[Download the complete Ortelius POC Document](/Ortelius-General-Poc.pdf)
For the most up to date information on the Ortelius CLI visit the [Ortelius GitHub Repository](https://github.com/Ortelius/cli/blob/main/doc/dh.md). You will find a complete list of parameters for collecting Swagger, SBOM and other tool reports and results.

You can complete a POC setup using Ortelius integrated into your Pipeline. [Download the complete Ortelius POC Document](/Ortelius-General-Poc.pdf) to get started.

### Install the Ortelius CLI
Install the Ortelius CLI to complete your POC. Install the Ortelius CLI where your CI/CD server is running. Refer to the [Ortelius GitHub CLI Documentation](https://github.com/Ortelius/cli/blob/main/doc/dh.md) for installation instructions.
Expand Down

0 comments on commit 00eaa6c

Please sign in to comment.