
Arista EOS Check
CertifiedEnterprise EditionPre or post upgrade checks on an Arista EOS switch
Arista EOS Check
Pre or post upgrade checks on an Arista EOS switch
Runs the flash, redundancy and interface checks and reports ok or ko. A failing check never throws: it is listed in checksFailed. Only connection and authentication errors fail the task.
PRE writes a snapshot (interfaces up, LLDP neighbours per port, MLAG state, boot image, boot time) and runs flash and redundancy. POST needs that snapshot and runs flash (previous image still on flash), redundancy (MLAG healthy and back to the snapshot state) and interface (interfaces up and LLDP neighbours back on the same ports, last reload requested by the user).
The version comparison is left to the flow: compare version with your target.
type: io.kestra.plugin.ee.arista.eos.CheckExamples
Pre-check a switch before upgrading it
id: arista_pre_check
namespace: company.network
tasks:
- id: pre_check
type: io.kestra.plugin.ee.arista.eos.Check
host: leaf1.lab.example.com
username: "{{ secret('ARISTA_USERNAME') }}"
password: "{{ secret('ARISTA_PASSWORD') }}"
phase: PRE
imageUrl: http://images.lab.example.com:8082/eos/4.36.0F/EOS-4.36.0F.swi
Post-check a switch against the pre-check snapshot
id: arista_post_check
namespace: company.network
inputs:
- id: snapshot
type: URI
tasks:
- id: post_check
type: io.kestra.plugin.ee.arista.eos.Check
host: leaf1.lab.example.com
username: "{{ secret('ARISTA_USERNAME') }}"
password: "{{ secret('ARISTA_PASSWORD') }}"
phase: POST
snapshot: "{{ inputs.snapshot }}"
Installation
This Enterprise plugin requires an Enterprise image and access to the plugin registry. Install it with the following command:
kestractl plugins get io.kestra.plugin.ee:plugin-ee-arista --compatible-for $KESTRA_VERSION For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.
For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.
Properties
host *string
Switch host
Host name or IP address of the switch management interface serving eAPI.
password *string
Password
Use {{ secret('ARISTA_PASSWORD') }}. The value is never logged nor returned in outputs.
phase *string
PREPOSTPhase
PRE before the upgrade (writes the snapshot), POST after it (compares with the snapshot).
username *string
Username
Account allowed to run privileged commands over eAPI.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150caCertificate string
CA certificate
PEM encoded CA certificate(s) used to validate the switch certificate. When set, only this CA is trusted. When empty, the JVM trust store is used.
checks array
FLASHREDUNDANCYINTERFACEChecks
Checks to run among FLASH, REDUNDANCY and INTERFACE. All by default. INTERFACE only applies to POST.
connectTimeout string
Connect timeout
Maximum time to open the connection. Defaults to 10 seconds.
imageSizeBytes integerstring
Target image size in bytes
Skips the HEAD request on the image host. The flash check needs free space for the image plus a 64 MiB margin.
imageUrl string
Target image URL
Plain HTTP URL of the target .swi image, used by the PRE flash check to read the image size with a HEAD request. Not needed when imageSizeBytes is set and the image is not already on flash.
insecureTrustAllCertificates booleanstring
Trust any certificate
Disables certificate and host name validation. Only for labs with self-signed certificates. Defaults to false.
port integerstring
eAPI port
Defaults to 443.
requestTimeout string
Request timeout
Maximum time to wait for one eAPI answer. Defaults to 60 seconds. Tasks that run slow commands (image copy, checksum) expose their own timeout.
snapshot string
Snapshot
Internal storage URI of the snapshot written by the PRE check. Required for POST.
Pebble expression referencing an Internal Storage URI e.g. {{ outputs.mytask.uri }}.
Outputs
bootupTimestamp number
Boot timestamp
Epoch seconds of the last boot, from show version.
checksFailed array
Checks failed
Failed checks with a message each.
io.kestra.plugin.ee.arista.eos.Check-Failure
Check name
flash, redundancy or interface.
Message
What failed, with the offending values.
checksPassed array
Checks passed
Names of the checks that passed.
modelName string
Model name
Hardware model, from show version.
snapshot string
uriSnapshot
Internal storage URI of the snapshot. Only set for the PRE phase.
status string
Status
ok when every check passed, ko otherwise.
version string
Running version
EOS version currently running, from show version.