ReleaseEngineering/How To/Heroku CLI
How to create the Heroku account
[Summarized below - if you have any problems, refer to the official docs, which includes troubleshooting information.]
- Register with Heroku (use your mozilla email!)
- Go to: https://mozillians.org and login your Mozilla LDAP account.
- Go to: https://mozillians.org/en-US/group/heroku-members/ and click Request Access.
- Wait for the request to join the group to be approved. Usually takes a day or less.
- DO THE NEXT STEPS ONLY AFTER YOU ARE APPROVED!
- Activate SSO via this HEROKU Link
- Bookmark THIS LINK. Once you activate SSO, you won't be able to login using the normal login page! So make sure the bookmark is in place!
- Install Heroku for your OS.
- Open your favorite terminal and type heroku login. The page should tell you that you can safely logout and the terminal should tell you that you have logged in on your account.
- When you are done with the previous steps, login on heroku's website/dashboard and see if you are member of 'mozillacorporation' team.
Heroku CLI commands
You can check your DUO session using the following command:
heroku auth:token
To login use this command:
heroku login
You can update heroku with the following command:
heroku update
If you need to reboot a TC Heroku dyno(s) you can do it with the following command:
heroku dyno:restart --app <heroku-service-name>
Between dyno:restart and --app, you can add a specific dyno name which will restart only the selected dyno:
heroku dyno:restart <dyno-name> --app <heroku-service-name>
When do we restart the dynos (processes)?
Whenever you feel something is not right.
It is okay, and recommended, to restart all dynos (eg don't provide a name between dyno:restart and --app). If you need to restart more services, lets say 3 of them, there is no order that the restart needs to follow. Simply reboot them, all should go smooth.
How do you know that a services is responsible for a problem?
- Usually if treeherder is not running, well we know we need to reboot taskcluster-treeherder
- If tests have issues with cache, we need to reboot taskcluster-purge-cache
- If tests have issues with secrets, we need to reboot taskcluster-secrets
- If there are problems with queue (machines not picking up tests, or the tests are "unscheduled" or decision tasks not running) well, we will reboot queue-taskcluster-net.
As you might have noticed, the issue will show you exactly what service you need to restart.