{"action":"created","issue":{"url":"https://api.github.com/repos/drone/docs/issues/285","repository_url":"https://api.github.com/repos/drone/docs","labels_url":"https://api.github.com/repos/drone/docs/issues/285/labels{/name}","comments_url":"https://api.github.com/repos/drone/docs/issues/285/comments","events_url":"https://api.github.com/repos/drone/docs/issues/285/events","html_url":"https://github.com/drone/docs/issues/285","id":285304372,"number":285,"title":"Default docker-compose config not working out of the box","user":{"login":"mgeisler","id":89623,"avatar_url":"https://avatars0.githubusercontent.com/u/89623?v=4","gravatar_id":"","url":"https://api.github.com/users/mgeisler","html_url":"https://github.com/mgeisler","followers_url":"https://api.github.com/users/mgeisler/followers","following_url":"https://api.github.com/users/mgeisler/following{/other_user}","gists_url":"https://api.github.com/users/mgeisler/gists{/gist_id}","starred_url":"https://api.github.com/users/mgeisler/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mgeisler/subscriptions","organizations_url":"https://api.github.com/users/mgeisler/orgs","repos_url":"https://api.github.com/users/mgeisler/repos","events_url":"https://api.github.com/users/mgeisler/events{/privacy}","received_events_url":"https://api.github.com/users/mgeisler/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":2,"created_at":"2018-01-01T12:19:25Z","updated_at":"2018-01-01T15:42:18Z","closed_at":null,"author_association":"NONE","body":"I wanted to see if I could setup Drone on my laptop to get a feel for the system. I found http://docs.drone.io/installation/ and tried to follow the instructions there.\r\n\r\nThe instructions are not very precise and assumes a lot of familiarity with docker-compose. I had heard of docker-compose in the abstract, but here I needed to look at the help to figure out that I need to name the config file `docker-compose.yaml`. I've created #283 to improve this.\r\n\r\nActually running `docker-compose up` doesn't work then. You get lots of errors about undefined variables. So I kept reading and saw that the rest of the page slowly \"patches\" the configuration to get it nearer a working state (but doesn't actually end up giving me a working configuration).\r\n\r\nNext confusing point was the integration with version control providers. Sure, I thought, it's nice if I can configure Drone to checkout my GitHub repositories. It's not clear that the provider is really used as an OAuth provider — #284 tries to address this.\r\n\r\nThese were some initial stumbling blocks I ran into. My next question is if it's even possible to run Drone on a laptop for testing purposes. The use of OAuth and the rediction URL makes me wonder this — I would set it to `localhost/authorize`, but will that work?\r\n\r\nThe lack of confidence is a problem — ideally, the installation guide would be a step-by-step guide that quickly shows me how to get Drone running on my laptop. _If_ registration with third parties is absolutely necessary, then this should be shown in a step-by-step way too.\r\n\r\nRight now, the installation instructions seem like a sketch at best. It might be that they really are just a sketch and that there are plans for expanding them. If that's the case, please write a note at the top saying so :-)"},"comment":{"url":"https://api.github.com/repos/drone/docs/issues/comments/354659641","html_url":"https://github.com/drone/docs/issues/285#issuecomment-354659641","issue_url":"https://api.github.com/repos/drone/docs/issues/285","id":354659641,"user":{"login":"mgeisler","id":89623,"avatar_url":"https://avatars0.githubusercontent.com/u/89623?v=4","gravatar_id":"","url":"https://api.github.com/users/mgeisler","html_url":"https://github.com/mgeisler","followers_url":"https://api.github.com/users/mgeisler/followers","following_url":"https://api.github.com/users/mgeisler/following{/other_user}","gists_url":"https://api.github.com/users/mgeisler/gists{/gist_id}","starred_url":"https://api.github.com/users/mgeisler/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mgeisler/subscriptions","organizations_url":"https://api.github.com/users/mgeisler/orgs","repos_url":"https://api.github.com/users/mgeisler/repos","events_url":"https://api.github.com/users/mgeisler/events{/privacy}","received_events_url":"https://api.github.com/users/mgeisler/received_events","type":"User","site_admin":false},"created_at":"2018-01-01T15:42:18Z","updated_at":"2018-01-01T15:42:18Z","author_association":"NONE","body":"Hi Thomas, thanks for the reply and thanks for looking at the PRs!\r\n\r\nIt makes sense to me that the production CI master will eventually run on a place that is accessible from GitHub so the web hooks can reach it. However, for testing out Drone, I was hoping that I could still easily get something up an running without exposing it to the Internet. I would of course trigger builds manually (or have Drone poll the remote repository) since the system would be behind a NAT to start with.\r\n\r\nI've done that with BuildBot and Jenkins in the past. Is it also possible with Drone? Or do I need to spin up some VMs somewhere with publicly accessible IPs before I can I can properly test Drone?\r\n\r\nIf I have to spin up a VM somewhere, my immediate concern is what information Drone will expose to others -- how do I make sure the web interface is locked down properly? I don't want to suddenly have a list of my private repositories visible to the world.\r\n\r\nI have of course found http://docs.drone.io/user-registration/ and I see it talks about a `drone` CLI tool. However, I'm still in the middle of the installation instructions at this point and do not have any `drone` CLI tool installed :-) In other words, the should be a prominent link to http://docs.drone.io/cli-installation/ somewhere in the installation guide and also on the page that that talks about user management.\r\n\r\nRunning a test server on a laptop or inside a private network removes these concerns."}}
{"actor":{"display_login":"mgeisler"}}