Add more docs for "Github app" section of install

[OmgImAlexis]

I'm a little stuck on the "Install Derek as a GitHub app" section as I can't find it on the marketplace as most "Github apps" are.

So then I'm guessing I have to create my own Github app? If so could you help with what these fields will needs to be filled with.

I already have a publicly facing openfaas gateway that I can use.

(Also might be an idea to link to the Github app registration page.)
https://github.com/settings/apps/new

 

[OmgImAlexis]

So I finally got it working.

2018/04/20 13:28:09 stderr: time="2018-04-20T13:28:09Z" level=fatal msg="No customer found for: pymedusa/test-repo"

Seems the customer list is hardcoded. Should I just disable it via the env?

derek/auth/customers.go

Line 21 in d1dc963

request, _ := http.NewRequest(http.MethodGet, "https://raw.githubusercontent.com/alexellis/derek/master/.CUSTOMERS", nil)

[alexellis]

@OmgImAlexis are you trying to host your own Derek or use our shared SaaS?

[alexellis]

The documentation in this site says to contact me for access to the shared instance... I'll take this issue as you doing that. Look at the Slack channel #derek - it has the public URL where you can install the hosted GitHub app.

Get your own Derek robot
You can host and manage your own Derek robot using these instuctions, or use our managed service. To use our managed service get in touch with Alex Ellis for more info.

[alexellis]

I've updated the documentation to be clearer about contacting me for access and the steps to take afterwards. You're correct in saying that the app is not listed publicly, but we have another guard in place too which is now clearly written up.

More info on Derek here - https://blog.alexellis.io/derek/

[OmgImAlexis]

I'm trying to use a self hosted copy of Derek that's deployed to my Openfaas server. Sorry I didn't make that clear.

With the customers file that also wasn't mentioned anywhere in the docs which threw me off until I read the Dockerfile.

I was hoping the docs page also showed which permissions would be needed for the different functions since when I first installed it there was no indication if it was doing anything at all as the logs don't print any human readable errors.

It'd be great for the docker container to log more useful info be default. Maybe I should open a separate issue on that?

[alexellis]

It'd be great for the docker container to log more useful info be default. Maybe I should open a separate issue on that?

While this sounds useful I'm not sure it's actionable. If there is a specific thing you'd like to do perhaps we can target that instead?

What is the reason for self-hosting over using the free SaaS version?

[OmgImAlexis]

Mainly which feature was being used and by who I was expecting to see more of a HTTP type log instead of what was presented. The reason I wanted this is so I could parse the logs for my grafana install.

I like to self-host all of my infrastructure.

[alexellis]

Derek close: resolved