Smoke tests↑
You can follow the steps in the following demo video or follow the the instructions in the following sections to use the various CAEPE features.
This guide shows you how to manage smoke tests and snapshots from the CAEPE account portal. You can access the section from the Smoke Tests menu item.
Info
Smoke testing is the preliminary check of software, after a build and before a release.
Smoke tests dashboard↑
The smoke tests dashboard has four sections.
Quick app deploy↑
To create a quick deployment of an application to a smoke test cluster, click the + Quick App Deploy button.
Give the deployment a name, select the application, and smoke test cluster to deploy to.
You can also define whether to run default tests after the deployment.
Define a snapshot↑
Info
Snapshots are a representation of a cluster at a point in time.
To define a snapshot, click the + Define Snapshot button.
Give the snapshot definition a name, select the cluster to take the snapshot from, filter any namespaces and resources to include in the snapshot, and set a location for the snapshot.
Click the Install CAEPE Component button.
In the next step set the final options for the snapshot which include:
-
Whether to run tests after CAEPE creates the snapshot. If you opt to run tests there are further options:
-
Which tests to run.
-
Whether to delete the snapshot or remove it from the smoke test cluster after the test run.
-
Whether to include application data in the snapshot. If you select this option, pick which volumes to include.
- Whether to also create the snapshot on a smoke test cluster. If you select this option, pick which cluster to use.
Click the Define Snapshot Now button. CAEPE then asks if you would like to create another definition or take a snapshot immediately.
Snapshot locations↑
You can find snapshot locations from the dropdown and Snapshot Locations menu next to the + Quick App Deploy and + Define Snapshot buttons.
This page shows all snapshot locations.
You can switch the view of the locations between a "list" and "grid" view and filter the instances by clicking the Filters button. You can filter by name, status, and type.
Each entry in the list or grid shows the name, date created, type, and restic. Click the pencil icon to edit the location and the wastebasket icon delete to delete it.
Snapshot location details↑
Click the View Details link next to any snapshot location to see more details about the location including the created date, type, restic, region, clusters that use the location, and which snapshots use it. You can also edit and delete the location from the details page.
Create a snapshot location↑
Create a snapshot location by clicking the + Create Snapshot Location button.
In the form that appears, set a name, provider, and region. The rest of the form then changes depending on the provider you select.
- AWS:
- Bucket
- Bucket prefix
- Access key
- Secret key
- Azure:
- Bucket
- Bucket prefix
- Client ID
- Client secret
- Resource group
- Storage account
- Subscription
- Tenant
- GCP:
- Bucket
- Bucket prefix
- Project
- Service account
- Generic S3:
- Bucket
- Bucket prefix
- Access key
- Secret key
- Fully qualified domain name
- Hostname
Finally, you can also define volume snapshots, to back up associated application data alongside configuration.
Test runs↑
Info
Test runs define a script to run against an application definition. They can trigger a script or a webhook.
You can find test runs from the dropdown and Snapshot Locations menu next to the + Quick App Deploy and + Define Snapshot buttons.
This page shows all defined test runs.
You can switch the view of the test runs between a "list" and "grid" view and filter the test runs by clicking the Filters button. You can filter by name, status, and type.
Each entry in the list or grid shows the name, status, application, type, and URL or path to the test script.
Create a test run↑
Create a test run by clicking the + New Test Run button.
In the form that appears, set a name and application. The rest of the form then changes depending on the option you select.
Webhook↑
For a webhook test run, set the following:
- URL of the webhook
- Credentials for accessing the URL
- Authentication type for the URL
Test script↑
For a script test run, set the following:
- Repository for the test script
- The branch or tag in the repository for the test script
- The path to the test script
- The SSH credentials to run the script
Snapshot definitions↑
Info
A Snapshot captures the state of a cluster at a point in time.
This section shows the most recent snapshot definitions. Click the view all link to see all snapshot definitions.
You can switch the view of the definitions between a "list" and "grid" view and filter the definitions by clicking the Filters button. You can filter by definition name, status, and type.
Each entry in the list or grid shows the default cluster, the amount of snapshots, and the creation date.
Click the pencil icon to edit the definition and the wastebasket icon to delete it.
Click the View link to view more details of the definition.
Smoke test clusters↑
This section shows the top three clusters with smoke tests deployed to them in alphabetical order. Click the view all link to see all clusters.
Snapshot instances↑
This section shows the most recent snapshot instances. Click the view all link to see all instances.
You can switch the view of the instances between a "list" and "grid" view and filter the instances by clicking the Filters button. You can filter by cluster name.
Each entry in the list or grid shows the name, status, and the deployed cluster or an option to deploy to a cluster.
Click the wastebasket icon delete to delete it.
Click the Snapshot Definition link to view more details of the definition.
Snapshot definition details↑
The snapshot definition details shows details of the snapshot definition including the creation date, the namespaces and labels the definition is based on, the resources within the definition, the save location of the definition, and the instances based on the definition.
Click the wastebasket icon to delete any of the instances based on the definition.
You can also take a snapshot based on the definition and optionally deploy that snapshot from the details page.
Smoke test deployments↑
This section shows the most recent smoke test deployments. Click the view all link to see all smoke test deployments.
You can switch the view of the deployments between a "list" and "grid" view and filter the deployments by clicking the Filters button. You can filter by cluster name.
Each entry in the list or grid shows the source and source type of the deployment, the cluster deployed to and when it was deployed, and the status of the test.
Click the pencil icon to edit the definition and the wastebasket icon to delete it.
Snapshot deployment details↑
Click the View Details link next to any deployment to see more details about the deployment including the source, the cluster deployed to and when, and the test cycles.