The a11ywatch cli is an easy way to get started with running and deploying.
cargo install a11ywatch_cli
You can run the
a11ywatch -h command to get all the options and details for the CLI. The deployment commands
terminate via Terraform are in
A11yWatch accessibility CLI.
a11ywatch [OPTIONS] [SUBCOMMAND]
-f, --find-results Log file results path
--find-tmp-dir Get the apps tmp directory location
-g, --github-api-url Get github API endpoint of project
--github-results-path Log file results github path
-h, --help Print help information
-r, --results-parsed Get results file parsed to json
--results-issues Get the total amount of issues between errors,warning,notice
that occured for the result set
--results-issues-errors Get the total amount of issues of type error from result set
--results-issues-warnings Get the total amount of issues of type warning from result set
--results-parsed-github Get results of the github html message
-s, --set-token <SET_TOKEN> Set the API token to use for request
-V, --version Print version information
build Build the project on the local machine [defaults to docker runtime]
crawl Site wide scan a website url for issues
deploy Deploy the build on remote infrastructure [defaults: GCP]
extract Extract results in formats for platforms
help Print this message or the help of the given subcommand(s)
scan Single page scan a website url for issues
start Start the application on the local machine [defaults to docker runtime]
stop Stop the project on the local machine [defaults to docker runtime]
terminate Destroy the build on remote infrastructure [defaults: GCP]
To get started scanning your website with the cli run the following commands. At the moment you can only crawl a single page, use the front-end client if you need continuous delivery through web sockets.
a11ywatch start # or start with frontend included passing -f option
a11ywatch scan --url https://a11ywatch.com -s
Deploying Remotely [Beta]
In order to deploy using terraform to a third party you need to clone the A11yWatch terraform-provider first and navigate into the directory before running any of the deploy commands.
You can deploy the project with terraform with a couple steps onto any infrastructure. If you are running the remote commands make sure to configure the terraform variables to match your project id and log in to gcloud via command line (
gcloud login). Make sure to clone the repo and cd into the root. You can also install the CLI onto a machine and start up locally as well via docker or a simple bash script. Terraform provides a more balanced remote setup since the architecture is set to scale amongst different layers while the standard
start commands use a single docker instance.