ドキュメントとコミュニティ
1. 利用可能なドキュメント
HAProxyのドキュメント一式は、次の文書に収録されています。時間を節約し、必要な情報を正確に得るために、該当するドキュメントを必ず参照してください。これらの文書に回答がある質問は、メーリングリストに送らないでください。
-
intro.txt（このドキュメント）：負荷分散の基本、製品としてのHAProxy、できることとできないこと、回避すべき既知の落とし穴、OS固有の制限、入手方法、開発の進め方、既知の修正をすべて含む版を稼働させる方法、更新方法、補完製品と代替製品について説明します。 -
management.txt：haproxyの起動方法、実行中の管理方法、複数ノードでの管理方法、サービスを中断せずにアップグレードする方法を説明します。 -
configuration.txt：すべての設定キーワードとそのオプションを詳しく説明するリファレンスマニュアルです。設定変更が必要なときに参照します。 -
coding-style.txt：プロジェクトにコードを提案する開発者向けに、コーディングスタイルを説明します。それほど厳格ではなく、コード全体が完全に従っているわけでもありませんが、大きく逸脱したコードの提供は受け付けられません。
-
proxy-protocol.txt：HAProxyと多くのサードパーティ製品が実装するPROXYプロトコルの事実上の仕様です。
-
security.txt：セキュリティ上の問題の報告方法と、脆弱性に該当するもの、該当しないものを説明します。
-
README：ソースからHAProxyをビルドする方法。
5. 連絡先
開発者やコミュニティのメンバーに連絡するには、通常、メーリングリストのhaproxy@formilux.org にメッセージを送るのが最適です。このリストとアーカイブは公開されているため、機密情報は開示しないようにしてください。さまざまな経験を持つ約千人のユーザーが参加しており、非常に複雑な質問にも、通常は比較的早く適切な回答が得られます。提案も歓迎します。メールの利用が難しい場合は、http://discourse.haproxy.org/ のDiscourseを利用できます。ただし、こちらで質問を読む人は少なく、大半の質問にごく少人数のチームで対応しています。いずれの場合も、余暇を使って支援している人々に敬意を払い、辛抱強く対応してください。
バグと思われる問題が見つかっても確信が持てない場合は、メーリングリストで報告するのがよいでしょう。バグだと確信しており、使用中のバージョンがそのブランチの最新版で、GitHubアカウントを持っている場合は、https://github.com/haproxy/haproxy/ に直接アクセスし、把握している詳細をすべて記載してissueを登録できます。こちらも公開されるため、後で後悔するような情報を投稿しないよう注意してください。issueは長いスレッドとして表示されるため、数百行以上の長いダンプは貼り付けず、ファイルとして添付してください。
セキュリティ上の問題が見つかったと思われる場合は、doc/security.txtを参照してください。HAProxyの脆弱性に該当するもの、該当しないものと、実際の脆弱性を非公開で報告する方法を説明しています。疑わしい問題の大半は通常のバグと判明するため、その場合は上記の方法で報告するのが適切です。
このサイトのマニュアル一式
この版の出典
- バージョン： HAProxy 3.4.6-66、メンテナンスブランチのドキュメントスナップショット
- 最新の安定版リリース： HAProxy 3.4.6、タグ
v3.4.6 - ソースコミット：
16acce1dac1d - アップストリームの公開版： docs.haproxy.org/3.4/
- このサイトに保存したライセンス： HAProxyのライセンス通知 とGPLv2