HELP: Does anyone know how to run a private instance of godoc.org?

agolangf · · 503 次点击    
这是一个分享于 的资源,其中的信息可能已经有所发展或是发生改变。
<p>I perused <a href="https://github.com/golang/gddo">the repository</a> (including the documentation), but there was no &#34;installation&#34; section or similar. I saw a Dockerfile, but when I build and run it, NGINX is stuck looking for a certificate file. I attempted to generate a cert and stick mount its directory, but I must be doing it wrong because NGINX can&#39;t find it. I was wondering if anyone else had been down this road already?</p> <hr/>**评论:**<br/><br/>quiI: <pre><p>An alternative approach which might fit your needs. </p> <p>Run <code>godoc -http=:6060</code></p> <p>Navigate to <code>http://localhost:6060/pkg/</code></p> <p>Tada! All the code in your $GOPATH (which includes stdlib) now has a web interface.</p></pre>villiger2: <pre><p>This is really the correct answer, very useful because it also has the docs of your own code ;) !</p></pre>weberc2: <pre><p>I&#39;m hoping I can get my own code on a private godoc.org since its feature set is much nicer than that of the godoc tool.</p></pre>thewhitetulip: <pre><p>As far as I know, this is the only way we can run godoc :-D</p></pre>NeverUse-YouPromised: <pre><p>This worked for me only when I ran godoc as root.</p></pre>divoxx: <pre><p>Probably because you were trying to bind to a low port, such as 80</p></pre>weberc2: <pre><p>Yeah, I should have mentioned that I specifically want GoDoc.org because it&#39;s got a more impressive user interface, and I want to use it in a demo for Go prototype to our Python organization. Probably not a big difference, but it seems worth the while to get a few additional oohs and ahhs.</p></pre>ChristophBerger: <pre><p>Did you try the steps for setting up a dev instance as <a href="https://github.com/golang/gddo/wiki/Development-Environment-Setup" rel="nofollow">described in the project&#39;s wiki</a>?</p> <p>This seems to provide a local running instance that&#39;s at least good enough for development purposes. (I never tried this myself but if I wanted to run a local godoc.org, this would be what I try first.)</p></pre>weberc2: <pre><p>I gave it a brief shot, but I couldn&#39;t locate the dev_appserver.py file.</p></pre>lstokeworth: <pre><p>dev_appserver.py is part of the appengine sdk.</p></pre>ChristophBerger: <pre><p><code>cd</code>&#39;ing to the root of the SDK install dir and (if on a Unix-like system) doing a <code>find . -name &#34;dev_appserver.py&#34; -print</code> should reveal if and where this script is contained in the SDK. If the <code>find</code> does not find anything then I have no other idea where this script could be hiding.</p></pre>weberc2: <pre><p>I&#39;m not seeing an SDK directory. What SDK are you referring to?</p> <p>EDIT: Another user mentioned that this belongs to the app engine sdk. I&#39;ll poke around that when I have more time.</p></pre>ChristophBerger: <pre><p>I meant the Cloud SDK that the gddo wiki advises to download. </p> <p>Re: app engine SDK - I thought this would be part of the Cloud SDK. If it has to be installed separately, then the gddo wiki page seems to miss that step.</p></pre>sh41: <pre><blockquote> <p>but there was no &#34;installation&#34; section or similar.</p> </blockquote> <p>It&#39;s in the wiki:</p> <p><a href="https://github.com/golang/gddo/wiki/Development-Environment-Setup" rel="nofollow">https://github.com/golang/gddo/wiki/Development-Environment-Setup</a></p> <p>I used to run a private gddo instance at my previous company for our internal code. I just ran it on internal network, and gave it GitHub credentials that had access to our private repos.</p> <p>However, there have been many changes to gddo recently that tie it closely to Google App Engine and other stuff, making it harder to run it stand-alone.</p> <p>Also, this might be somewhat relevant/helpful.</p> <p><a href="https://godoc.org/github.com/shurcooL/cmd/godoc_router" rel="nofollow">https://godoc.org/github.com/shurcooL/cmd/godoc_router</a></p> <p>I used that to augment the private instance with the rest of godoc.org for all the public stuff. But, this was a few years ago, so it might be out of date.</p></pre>weberc2: <pre><p>I saw that document, but I don&#39;t know where that dev_appserver.py file is supposed to come from. I was hoping I could easily spin up a docker container.</p></pre>LtArson: <pre><p>Someone made a Docker image for it: <a href="https://github.com/Clever/godoc-docker" rel="nofollow">https://github.com/Clever/godoc-docker</a></p></pre>weberc2: <pre><p>Cool, I&#39;ll check this out. Not sure why you got downvoted.</p> <p>Bummer--I just saw it only supports private Github repos. :(</p></pre>LtArson: <pre><p>I think it supports public and private, but if not you can use the public godoc for public code and that for private code</p></pre>smcquay: <pre><p>I got this working for work. Just had to start up a redis and build the source (recursively?). I eventually got a gddo binary and handle a TLD reverse proxy myself. </p></pre>

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

503 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传