There is a lot of information about instances available in EC2 that can be displayed and what everyone wants to see is different. Much like the web console is customizable so is the claws application via a configuration file written in YAML.
To initialize claws with a configuration file run the --init option:
This will generate a configuration file in your home directory:
This file is certainly going to change over time but at present the default generated file looks like:
--- capistrano: home: ssh: user: identity: aws: access_key_id: secret_access_key: ec2: regions: - us-east-1 - eu-east-1 fields: id: width: 10 title: ID name: width: 20 title: Name status: width: 8 title: Status dns_name: width: 42 title: DNS Name instance_type: width: 13 title: Instance Type public_ip_address: width: 16 title: Public IP private_ip_address: width: 16 title: Private IP tags: width: 30 title: tags
To make claws really work all you have to do is enter you AWS credentials and the ssh user and you should be able to connect to the host you select.
Though not supported yet you will be able to enter the home directory of your projects capistrano configuration files. Once this is enabled you will be able to display and filter hosts by their defined environment and role.
You can find your credentials by logging in to your AWS account, clicking the My Account link in the upper right, and then selecting Security Credentials under the Account tab on the left.
If you have hosts in multiple regions claws will automatically display all of the instances in them. If you want to limit the regions that you want to report on you can indicate that using this stanza. Remember to uses dashes to delineate the region indicating an array in yaml:
regions: - us-east-1 - eu-east-1
This section has the most significant content because it controls what you want to see in the status table. From the example it is clear that you can enter the following in the fields stanza:
There are some special fields that claws defines for you that make it easier to manipulate the display. They are listed below: