{"action":"created","issue":{"url":"https://api.github.com/repos/cantino/huginn/issues/872","labels_url":"https://api.github.com/repos/cantino/huginn/issues/872/labels{/name}","comments_url":"https://api.github.com/repos/cantino/huginn/issues/872/comments","events_url":"https://api.github.com/repos/cantino/huginn/issues/872/events","html_url":"https://github.com/cantino/huginn/pull/872","id":89930061,"number":872,"title":"[WIP] Improve installation instructions","user":{"login":"dsander","id":20943,"avatar_url":"https://avatars.githubusercontent.com/u/20943?v=3","gravatar_id":"","url":"https://api.github.com/users/dsander","html_url":"https://github.com/dsander","followers_url":"https://api.github.com/users/dsander/followers","following_url":"https://api.github.com/users/dsander/following{/other_user}","gists_url":"https://api.github.com/users/dsander/gists{/gist_id}","starred_url":"https://api.github.com/users/dsander/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dsander/subscriptions","organizations_url":"https://api.github.com/users/dsander/orgs","repos_url":"https://api.github.com/users/dsander/repos","events_url":"https://api.github.com/users/dsander/events{/privacy}","received_events_url":"https://api.github.com/users/dsander/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":19,"created_at":"2015-06-21T16:23:16Z","updated_at":"2015-07-06T07:14:28Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/cantino/huginn/pulls/872","html_url":"https://github.com/cantino/huginn/pull/872","diff_url":"https://github.com/cantino/huginn/pull/872.diff","patch_url":"https://github.com/cantino/huginn/pull/872.patch"},"body":"My plan with this PR is to move the documentation of supported deployment methods into the repository and out of the wiki. I think that the installation and update documentation should be tied to the revision one is using.\r\n\r\nSuggested official (read supported) installation methods:\r\n\r\n * The new 'manual' installation\r\n * Heroku when paying for the 'Hobby' tier\r\n * Docker to check huginn out locally (I dont think we should suggest running it on production, if anyone wants to do it he probably knows what she is doing? /cc @ianblenke )\r\n\r\nWiki pages which I plan to integrate and/or delete after this is done:\r\n\r\n* [Heroku](https://github.com/cantino/huginn/wiki/Run-Huginn-for-free-on-Heroku) Revise and move to the repository\r\n* [OpenShift](https://github.com/cantino/huginn/wiki/Run-Huginn-for-free-on-OpenShift) I suggest removing the Link to it but to keep the page in the wiki for the case they fully support rails 4.2\r\n* [Deployment with Capistrano, Unicorn, nginx, Foreman, and Upstart](https://github.com/cantino/huginn/wiki/Deployment-with-Capistrano%2C-Unicorn%2C-nginx%2C-Foreman%2C-and-Upstart) More or less replaced with the new guide, capistrano is unneeded for most users and developers probably have their own preferred way to set up capistrano and the server\r\n* [Deploying huginn on any server or virtualbox using chef solo and/or vagrant](https://github.com/cantino/huginn/wiki/Deploying-huginn-on-any-server-or-virtualbox-using-chef-solo-and-or-vagrant) not maintained for a long time and broken?\r\n* [Using Huginn on predeployed Docker container](https://github.com/cantino/huginn/wiki/Using-huginn-on-predeployed-docker-container) Revise and move to the repository\r\n* [Try Huginn Free on Terminal.com](http://blog.terminal.com/huginn-on-terminal-com/) does this still work, has anyone tried it?\r\n* [Running Many Job Workers](https://github.com/cantino/huginn/wiki/Running-Many-Job-Workers) Will be covered in the repository\r\n\r\nMost of the documentation is heavily insprired by the awesome guides of GitLab.\r\n\r\nIt is probably easier to read the docs by opening the [docs folder of my fork](https://github.com/dsander/huginn/tree/deployment-guide/doc) than reading the markdown in the PR.\r\n\r\nTODOs:\r\n- [x] Check installation on vagrant using the `ubuntu/trusty64` base box\r\n- [x] Check installation on vagrant using the `ubuntu/precise64` base box\r\n- [x] Check installation on vagrant using the `debian/jessie64` base box\r\n- [x] Check installation on vagrant using the `debian/wheezy64` base box\r\n- [x] Verify the installation works on DigitalOcean with Ubuntu 14.04\r\n- [x] Verify the installation works on DigitalOcean with Ubuntu 12.04\r\n- [x] Verify the installation works on DigitalOcean with Debian 8.1\r\n- [x] Verify the installation works on DigitalOcean with Debian 7\r\n- [x] Write the update documentation\r\n- [x] Document how to change the Procfile to run multiple DelayedJob workers\r\n- [x] Move Docker documentation to the repository\r\n- [x] Move/revise Heroku documentation to the repository\r\n- [ ] Remove old/unused files from the repository\r\n\r\nThanks to @lmarien and @enfop for doing an initial proof reading.\r\n\r\n/cc @virtadpt @robbielj"},"comment":{"url":"https://api.github.com/repos/cantino/huginn/issues/comments/118751059","html_url":"https://github.com/cantino/huginn/pull/872#issuecomment-118751059","issue_url":"https://api.github.com/repos/cantino/huginn/issues/872","id":118751059,"user":{"login":"mhow2","id":9987241,"avatar_url":"https://avatars.githubusercontent.com/u/9987241?v=3","gravatar_id":"","url":"https://api.github.com/users/mhow2","html_url":"https://github.com/mhow2","followers_url":"https://api.github.com/users/mhow2/followers","following_url":"https://api.github.com/users/mhow2/following{/other_user}","gists_url":"https://api.github.com/users/mhow2/gists{/gist_id}","starred_url":"https://api.github.com/users/mhow2/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mhow2/subscriptions","organizations_url":"https://api.github.com/users/mhow2/orgs","repos_url":"https://api.github.com/users/mhow2/repos","events_url":"https://api.github.com/users/mhow2/events{/privacy}","received_events_url":"https://api.github.com/users/mhow2/received_events","type":"User","site_admin":false},"created_at":"2015-07-06T07:14:27Z","updated_at":"2015-07-06T07:14:27Z","body":"Thank you everyone for all the provided information.\r\n\r\n@dsander \r\n> but don't run any of my applications in production with docker, mostly because I don't know either what's the best practice to upgrade.\r\n\r\nIsn't the solution for this scenario is what you write in the rest of your post ? (eg, ENV variables to attach an external DB). So to upgrade you just deploy the new docker image, and huginn would upgrade the database schema on startup. @cantino, is the DB schema upgrade process works from any to any version ?\r\n\r\nCurrently we are just testing Huginn but I want to make sure I would be able to maintain the software if it is adopted and would run in production. We are using either openstack or cloudstack own private cloud provider. As now I haven't tested docker with attached database as ENV. But I have the following issues with what I tested until now:\r\n- deploy with chef : works well but unable to start/stop all huginn process from init scripts (because the init script doesn't do anything about foreman). Upgrading is known to be done just with deploying again. (not 100% sure of this ?). \r\n- deploy with docker : lightening fast. Easy to manage. By the way I was unable to do a commit of the running Huginn container (which could be used as a from of backup), and start a new image based on this commit because of a stalling pid file `foreman stdout | 07:06:35 web.1  | A server is already running. Check /app/tmp/pids/server.pid.`. Maybe I should halt the container before commiting but just don't know how to do that for now ;).\r\n\r\nAnd for backup, I've been surprised not to see something oriented to the end user ; as a simple \"backup agent(s)\" button so any user can backup his agent configuration for the UI."}}