To Build a New Polaris Image in XPRESSO

NOTE:
Polaris image is only used for Cisco internally.

1. From XPRESSO Dashboard:

   • From the Main Navigation Bar, choose Main Menu→ENVIRONMENT→Docker Images to open the Registered Docker Images page.
   • Click the Build New Image button located on the top-right of the page → Polaris Image. The Building a new Polaris Image wizard appears.
   • Provide the image name(optional, default to polaris), tag, Git Reference, Base Reference(optional, to perform 3-way polaris repo merge).
   • Click on save.

2. From XPRESSO public REST API: See "Build Polaris Docker Image". The built images will be shown in the groups that provided in the requests.

3. Discovering pyATS jobs and manifests files:

   • Polaris SDK image builder helps you to discover pyats job files and manifest files in the polaris git repo.
   • You can check the discovered pyATS job files and manifest files from image detail page → Job Files/Manifests.
   • The discovered manifests are registered as manifest jobs automatically, you can check those jobs from Main Menu → Execution → Manifests
   • To execute a manifest job, refers to Executing Manifest Requests

4. How to retrieve a docker image:

   • Through XPRESSO REST API, refers to: Test Image Rest APIs.
   • Through engIT Kafka, refers to Taas-Kafka (Cisco internal only).

Other Related Polaris Image Information

• See "pyATS documentation" for how pyATS uses a file with YAML syntax (the “manifest” file) to capture the runtime requirements, script arguments and execution profile for test scripts.