AppHarbor CLI
The AppHarbor CLI is used to manage AppHarbor applications from the command line.
For more about AppHarbor see https://appharbor.com/.
Setup
The CLI is known to work on Windows. Download and run the installer to get started.
Once installed, you can log in to create and administer AppHarbor applications. Use the -h
switch to
get more information about each command and any options available.
Example usage: appharbor deploy -e bin -e obj
This will deploy the application using the optional "excluded directory name" argument to avoid uploading compiled binaries. Also note the use of a command "alias". Aliases are enclosed in paranthesis in the list of available commands.
$ appharbor login
Username: friism
Password: ***************
Successfully logged in as friism
$ appharbor
Usage: appharbor COMMAND [command-options]
Available commands:
app # List your applications
app create [name] # Create an application ("create")
app delete # Delete application
app deploy # Deploy current directory ("deploy")
app info # Get application details
app link [slug] # Link directory to an application ("link")
app log # Get application log ("log")
app open # Open application on appharbor.com ("open")
app unlink # Unlink application from directory ("unlink")
build # List latest builds
config add [key=value] # Add configuration variable to application
config # List all configuration variables
config remove [key1 key2..] # Remove configuration variable
drain add [drain_url] # Add a log drain
drain # Show log drains and tokens
drain remove [drain url] # Remove a log drain
help # Display help summary
hostname add [hostname] # Add a hostname
hostname # List all associated hostnames
hostname remove [hostname] # Remove hostname from application
user login # Login to AppHarbor ("login")
user logout # Logout of AppHarbor ("logout")
user # Show currently logged in user
Common options:
-h, --help # Show command help
Alias
If you use the CLI a lot you might want to create an alias for the appharbor executable. You can do this with a simple batch file called "ah.bat" in the CLI install directory. The file should have this content:
appharbor %*
After this you can simply call the commands with for instance ah config
.
API
The CLI uses the AppHarbor API, documentation can be found here: http://support.appharbor.com/kb/api/api-overview