Pop quiz, which URL is prettier:
ey-dns command line application to make DNS simple (see the readme). It supports 6 different DNS services, including DNSimple and AWS Route 53 (see below).
It's really quite easy to use:
- Install the tool:
$ gem install engineyard-dns
- Change to your Rails/Ruby project that is deployed with AppCloud:
$ cd path/to/my/app
- Run `ey-dns`:
$ ey-dns assign myapp.com Assigning myapp.com —> 22.214.171.124 (drnic/myapp_production) Assigning www.myapp.com —> 126.96.36.199 (drnic/myapp_production)
$ ey-dns assign myapp.com --environment myapp_production
(Subdomains are a little weird because of how DNS zones work. Put your bare domain first and then subdomain names after. The following sets staging.myapp.com to the myapp_staging environment. )
$ ey-dns assign myapp.com staging --environment myapp_staging
If you have multiple apps on one environment, you will still have to update the domain name of each app in the AppCloud dashboard so that nginx knows what vhost you mean to serve at that domain. Just click edit on each app in an environment to add vhost domains.
Preparing your DNS provider
To be complete you will also need to purchase/transfer a domain:
- Register your application's domain with a DNS provider (see supported list below), such as DNSimple.
- Transfer your domain to your DNS provider or change to use their name servers, such as
ns1.dnsimple.com(ns2, ns3, etc) for DNSimple.
Supported DNS providers
ey-dnswill automatically determine which DNS provider is managing the domain/zone that you are wiring up to your AppCloud environment.
This new CLI uses fog to access DNS providers. The current list of available DNS providers for fog is: AWS, Bluebox, DNSimple, Linode, Slicehost, Zerigo. The next section shows how to setup fog credentials.
To access your DNS provider, you need to add your account/API credentials into your
In my example
~/.fogfile below I have DNS access to DNSimple, Slicehost and AWS Route 53.
:default: :dnsimpleemail: MYEMAIL :dnsimplepassword: XXXXXXXXXXX :awsaccesskeyid: 0NJRCXXXXXXXXXXXX :awssecretaccesskey: QGtnbXXXXXXXXXXXX/qQ4lXXXXXXXXXXXXXX :slicehost_password: f9a265f66XXXXXXXXXXXXXXXXXXXXXXXXXXX
I currently use DNSimple for registering and serving all my new domains. Their API credentials are the same email/password you use to login to the service.
Note the surreptitious referral used here, giving me a free month for each DNSimple sign-up, bwhahahaha. To avoid gifting me a free month, use http://dnsimple.com link. A free month isn't as cool as free swag, but I don't think DNSimple has free swag. Well, I don't have any of it.
Recently AWS began offering an API-driven DNS server Route 53. The AWS credentials for access DNS are the same credentials you use in CarrierWave or PaperClip to access AWS S3. To find them, log into your AWS Account and navigate to “Security Credentials”, then “Access Credentials”, and click “Show” to see your secret access key.
Until I switched to DNSimple and to fog, I used Slicehost for its API/CLI-driven DNS. I still have many domains managed by Slicehost. To enable API access to your Slicehost account in
ey-dns) go to https://manage.slicehost.com/api, enabled API access and copy your API token into the
You can test your DNS credentials with the
$ ey-dns domains AWS: none DNSimple: drnicwilliams.com - 0 records emrubyconf.com - 2 records mocra.com - 27 records Slicehost: myconfplan.com. - 0 records
Hopefully this tool makes it much easier to setup or change DNS for your AppCloud environments. Let us know in the comments or in the project's Issues if you love it, find bugs or have feature requests.
The source and instructions for the project is available on GitHub.