社群

專案治理

Prometheus 專案遵循 Prometheus 治理規範。

社群聯絡方式

Prometheus 採用開源方式開發。以下是我們用於交流和貢獻的一些渠道

Slack 頻道

CNCF Slack  上的 #prometheus 頻道。

IRC

irc.libera.chat  上的 #prometheus 頻道。

Matrix

#prometheus:matrix.org.

使用者郵件列表

• prometheus-announce （映象 ）
  • 用於釋出新版本等公告的低頻郵件列表。
• prometheus-users  （映象 ）
• 用於討論 Prometheus 的使用和尋求社群支援。通常不會同步來自 prometheus-announce  的公告。

Discourse 論壇

基於 Web 的討論論壇 discuss.prometheus.io ，由 Discourse  託管。

公開活動日曆

我們有一個公開的活動日曆，您可以用它來加入我們。

如果您只想瞭解概覽，只需在您的瀏覽器中檢視我們對應的本地時區網頁檢視 。

如果您使用的是 Google 產品，可以使用此自動關聯連結將其新增到您自己的 Google 日曆中 。

如果您使用的是其他日曆，可以使用此 .ics 檔案將其新增到非 Google 日曆中 。

社交媒體

• Bluesky  上的 @prometheus.io 。
• Mastodon (chaos.social)  上的 @Prometheus 。

GitHub

若要提交 Bug 和功能請求，請使用相關 Prometheus 倉庫  的 GitHub issue 跟蹤器。對於問題和討論，許多倉庫都提供了 GitHub discussions。通常，這裡列出的其他社群渠道最適合獲取支援或討論全域性性主題。

請勿向單個專案成員尋求支援。請改用上述渠道，整個社群都可以為您提供幫助，並能從提供的解決方案中受益。如果社群支援無法滿足您的需求，請參考 支援與培訓 頁面。

貢獻指南

請參閱 貢獻者指南。

開發者峰會

請參閱 貢獻者指南。

導師計劃

Prometheus 專案偶爾會參與各種週期性的導師計劃

• LFX 導師計劃（原 Community Bridge） 
• Google Summer of Code (谷歌程式設計之夏) 

請參閱上述連結以獲取未來的計劃日期、申請詳情和專案。

注意為了讓 Prometheus 能夠參與導師計劃週期，潛在的導師（包括至少一名 Prometheus 維護者）必須向計劃週期提交一個“專案”提案，例如在此 PR 中 。

導師的時間有限，因此我們不得不跳過一些週期和計劃。有一些方法可以幫助我們更頻繁地參與

• 如果您想幫助我們擔任導師，請隨時透過 #prometheus-dev Slack 頻道 或 電子郵件  聯絡團隊。
• 如果您想建議將某個開源 Prometheus 生態系統倡議轉化為導師專案，歡迎在相關的工件（例如 GitHub issue）上發表評論。

致學員

您已被選中參加 LFX 或 GSoC 下的 Prometheus 導師計劃？恭喜！這裡有一些幫助您快速入門的資訊！

新手引導清單

• 請閱讀並認可我們的 行為準則。簡而言之（TL;DR）：保持友善和友好，像你希望被對待的那樣對待他人。
• 在 CNCF Slack  上建立賬號。請添加個人資料頭像以使其具有辨識度。您可以在那裡聯絡到任何一位導師。
• 將您的 Slack 賬號 ID 傳送給您的導師，以便我們將您加入私有頻道。我們通常會有一個僅包含您和您的主要導師的私有頻道，以及第二個包含所有學員、前學員和導師的頻道（#thanos-prometheus-mentees）。
• 加入 Prometheus 的主要 Slack 頻道 #prometheus 和 #prometheus-dev，以便日後與社群進行交流。
• 在 #prometheus-dev Slack 頻道 上，寫幾句關於您自己的介紹，打個招呼吧！💜
• 歡迎加入 社交媒體，開始關注他人並積累您自己的關注者！誰知道呢，也許您會沉迷其中？(: 歡迎釋出任何關於 Prometheus 的相關內容，並提及 @prometheus.io。
• 讓導師安排每週一次的 2對1 會議（強烈推薦）。
• 請閱讀我們的通用貢獻指南，以及 Prometheus 倉庫中的具體指南 
• 仔細閱讀您的主要 GitHub issue 並開始思考它，但不要有壓力！最好先從一個較小的任務慢速開始，讓一切運轉起來。🚀

提示和建議

您可以遵循以下一些建議，以充分利用與我們共度的時光！

• PR 被卡住了、正在尋找人來審查您的貢獻，或者對失敗的 CI 有一些簡短的問題？相比於私信或私有頻道，請優先選擇 公開 交流渠道（#prometheus 和 #prometheus-dev）。Prometheus 擁有一個龐大的社群，可以快速幫助您解決任何問題。此外，其他學員也可能已經遇到過類似的問題！
• 向其他學員和前學員打個招呼。我們甚至為此建立了一個專門的頻道，以便你們可以結對並共同構建更大的成果：建立聯絡、未來可能合作的專案，或者只是互相幫助！以 2020 年夏天為例，之前的 Thanos 學員發起了 週五趣味聚會（Friday fun hangouts） ，效果非常棒！想發起類似的活動嗎？向其他前學員請教他們的經驗吧。🤗
• 跳出固有思維。您是否覺得在專案開發、功能或社群方面有什麼非常痛苦的地方？幫助我們改進，並提出改進建議！
• 參與專案生命週期。我們活躍於許多會議中，例如 KubeCon、PromCon、FOSDEM、GoDays。我們參與了 CNCF SIG、許多邊際倡議、部落格文章和影片。請幫助我們！歡迎您提升在社交媒體上的知名度、開始撰寫部落格，甚至開始在會議上演講。無論您對什麼感興趣，都可以隨時向您的導師尋求指導！我們很樂意提供幫助。
• 在實習期間，我們非常歡迎甚至鼓勵您為任何您想做的事情做出貢獻。等待 PR 審查一段時間是常有的事（畢竟這是開源專案！），因此同時推進 2 或 3 件事並不罕見。您也不需要將貢獻侷限於 Prometheus 專案。為您我們依賴或有合作關係的其他專案做出貢獻是完全沒有問題的。此外，我們也鼓勵 Prometheus 學員為 Prometheus 生態系統專案做出貢獻，例如 其他 Prometheus 倉庫 ，甚至是 Cortex 和 Thanos。因為我們是一個更大的 Prometheus 生態系統大家庭 的一部分。
• 努力保持獨立，併為您要交付的功能負責。您越早開始主導您的任務，對您就越有利！剛開始可能很難，但試著從使用者體驗的角度去思考。使用它時是容易還是不容易犯錯？遷移到該功能有多難？有什麼我們可以做的來減少資料丟失的錯誤嗎？
• 嘗試透過審查其他貢獻者、學員或導師的 pull request 來幫助他人！這聽起來很嚇人，但實際上這是學習編碼實踐、模式以及如何維護高質量程式碼庫的最佳方式！
• 嘗試使用迭代開發過程 。從微小且簡單的設想開始，一旦準備好一個可執行的示例，就不斷改進並與導師討論。微小的改動很容易審查，也很容易被接受 😄。
• 嘗試製作一個概念驗證（proof of concept） ，它可以作為基線並在此基礎上進行改進。這些都是實際專案，因此不可能每次都有確定性的解決方案，概念驗證是確定可行性的快速方法。
• 像您是專案的維護者一樣去行動。理想情況下，做一個您希望為您貢獻的專案所擁有的那種優秀維護者 。雖然這聽起來有些令人畏懼，但這是建立信任、承擔更多責任並帶來巨大價值的最佳方式（例如，審查其他人的工作並幫助他們掃清障礙，往往比您自己編寫程式碼更重要！）。
• 保持快樂，去探索，並享受學習（即使是在錯誤中學習）！

導師計劃的結束並不是終點！歡迎您繼續貢獻、編寫程式碼並幫助他人。誰知道呢，也許有一天您會充滿熱情地成為一名維護者！

致導師

本節概述了針對導師的指導建議。

覆盤研討

在導師計劃的中期和最後一次會議上，最好與學員坐下來，為導師和學員收集可執行的經驗教訓。由於我們之間的差異以及不同的任務和環境，導師和學員的經歷總是不同的。無論我們是否實現了最初的目標，我們總是想檢查我們的體驗。如果目標沒有實現，那麼在坦誠和不指責的氛圍中討論這一點就尤為重要。如果體驗大部分是積極的，我們也想知道是什麼在起作用，以強化最佳實踐。

典型的覆盤流程如下所示

• 在會議前一週，向學員提醒計劃中的覆盤以及具體形式（例如提供本指南的連結）。這讓大家可以在這一週裡仔細思考哪些工作見效了，哪些沒有。
• 在會議期間，首先進行復盤。這是會議最重要的部分，不要讓其他事情（例如專案狀態）干擾。
  • 在工作文件中寫下兩個部分：我們哪些方面做得好，哪些方面可以做得更好。
  • 給每個人 5-7 分鐘的時間，在這兩個部分中寫下（例如即時線上協作）條目。要具體、不指責且誠實。這不是為了冒犯任何人，而是為了尋找導師和學員工作的改進方法。對自己要挑剔，但也要儘量平衡好的一面和需要改進的部分。總有一些事情我們可以做得更好（或者更糟！）。
  • 當大家都寫完後，建立一個新的部分：經驗教訓。
  • 逐一檢視列表中的所有條目。討論細節。嘗試尋找如何緩解問題或繼續保持的做法。將這些內容記錄在 經驗教訓 部分。
  • 最後，將這些經驗教訓透過郵件列表分享給團隊。
  • 考慮將所有的經驗教訓撰寫成某種形式的 公開內容。

公開演講或寫作

為了讓學員能夠分享他們學到的知識，並幫助他們提高公開演講技能，在導師計劃週期結束時，導師可以鼓勵學員在相關論壇中創作某種形式的公開內容。我們過去的一些做法如下

• 鼓勵學員在下一次相關的會議或聚會（例如 PromCon、KubeCon、本地聚會等）上發表演講（甚至與他們一起聯合演講）！
  • 請觀看 Arthur  以及 M Viswanath Sai 和 S Ashwin  在 PromCon 會議上發表的關於結束導師計劃後的演講。
• 鼓勵學員在 Prometheus 部落格  或其個人部落格上撰寫部落格文章！
• 如果我們有足夠的內容，舉辦一次虛擬的“學員見面會”也是一個選擇。

行為準則

為了讓 Prometheus 成為一個對每個人都友好且不受騷擾的環境，我們遵循 CNCF 行為準則 。

法律傘

Prometheus 是一個獨立的開源專案，不受任何單一公司控制。為了強調這一點，我們在 2016 年作為繼 Kubernetes  之後的第二個專案加入了 雲原生計算基金會（CNCF） 。

致謝

Prometheus 由 Matt T. Proud  和 Julius Volz  發起。其最初的大部分開發工作由 SoundCloud  贊助。

我們還要感謝來自 Docker  和 Boxever  工程師們的早期貢獻。

Prometheus 的 Logo 由 Robin Greenwood 貢獻。