Grafana에 기여하기
Grafana에 기여하기
이 문서에서는 Grafana 소프트웨어 생태계에 기여하거나 Grafana용 플러그인을 구축하려는 개발자를 위한 리소스를 안내합니다. 질문하기, 기술 기여하기, 스타일 가이드 등 기여 전반을 다루어요.
출처: 문서
본문
이 페이지는 Grafana 소프트웨어 생태계에 기여하거나 Grafana용 플러그인을 구축하려는 개발자를 위한 리소스를 모아둔 문서예요.
Grafana와 소통하기
질문하고, 문제를 보고하고, 변경을 제안할 올바른 장소를 사용하세요.
- GitHub 이슈와 풀 리퀘스트: 핵심 Grafana와 유지 관리되는 플러그인의 재현 가능한 버그, 작고 실행 가능한 기능 요청, 풀 리퀘스트를 통한 코드나 문서 변경에 사용하세요. 일반적인 “어떻게 하나요” 질문은 피하세요. 보안 문제는 security policy를 따르세요.
- Grafana 커뮤니티 포럼: 질문, 문제 해결, 모범 사례, 플러그인 개발 Q&A, 초기 아이디어 논의에 사용하세요. 포럼은 같은 문제와 질문을 가진 다른 사람에게도 도움이 되는 검색 가능한 공개 지식 기반을 만듭니다. 확신이 없다면 여기에서 시작하세요: Grafana community forums.
- Grafana Community Slack: 빠르고 시간에 민감한 대화와 네트워킹에 사용하세요. 긴 문제 해결이나 의사 결정을 Slack에 의존하지 마세요. 결과를 포럼 주제나 GitHub 이슈/PR로 공유하여 공개 기록을 유지하세요: Grafana Community Slack.
참고 어디서 시작해야 할지 모르겠나요? 포럼에 새 주제를 여세요! 유지 관리자와 커뮤니티 구성원이 GitHub 이슈나 풀 리퀘스트가 더 적절하다면 그쪽으로 안내해 줄 거예요.
기술 기여하기
코드부터 플러그인, 커뮤니티 지원까지 Grafana에 기여하는 방식을 선택하세요.
Grafana에 코드 기여하기
- Contributing to Grafana은 기여 과정과 커뮤니티 리소스를 소개해요.
- Developer guide는 환경을 설정하고 개발 모드로 Grafana를 실행하는 방법을 보여줘요.
- Architecture guides는 Grafana의 배경 아키텍처를 설명해요.
- Create a pull request는 명확하고 설명적인 풀 리퀘스트를 준비하는 과정을 안내해요.
- 모든 issues를 살펴보아 좋은 첫 번째 작업을 찾아보세요. help wanted로 필터링할 수도 있어요.
- REST APIs를 사용해 Grafana 백엔드와 프로그래밍 방식으로 상호작용해요.
플러그인 개발하기
- 플러그인 개발 가이드를 읽고 플러그인 유형을 선택하고, 프로젝트를 스캐폴딩하며, 로컬에서 개발하세요.
코드 없이 기여하기
- bug report template으로 버그를 보고하고 재현 단계를 포함하세요.
- feature request를 제출해 개선을 제안하세요.
- documentation contribution guide로 문서를 개선해요.
- issue triage를 통해 열린 이슈를 검토하고, 레이블을 지정하고, 명확히 하는 작업을 도와주세요.
- security policy를 따라 보안 취약점을 보고하세요.
모범 사례와 스타일
우리의 style guides는 프론트엔드, 백엔드, 문서 등에 대한 Grafana 스타일(모범 사례 포함)을 설명해요. 편집이나 코딩을 시작하기 전에 꼭 읽어보세요!
- Backend style guide는 앞으로 Go 코드를 작성하는 방식을 설명해요.
- Documentation style guide는 Grafana 제품에 대해 만들어진 모든 문서에 적용돼요.
- End to end test framework는 Grafana e2e 테스트에 대한 지침을 제공해요.
- Frontend style guide는 Grafana에서 React로 개발하는 규칙과 지침을 제공해요.
- Redux framework는 Grafana가 Redux 보일러플레이트 코드를 처리하는 방식을 설명해요.
- Styling Grafana은 Emotion으로 React 컴포넌트를 스타일링하는 방법을 자세히 설명해요.
- Theming Grafana는 Grafana 코드에서 테마와 ThemeContext를 사용하는 방법을 설명해요.