sonarqube - GitLite

KO | EN

gitlite — search

#typescript #go #rust #deep-learning #macos #nodejs #java #windows #kubernetes #vue #pytorch #security #mcp #open-source

sonarqube

(★ 10,915)

지속적 검사

파일 탐색기

최종 버전 다운로드 (.zip)

파일 수가 많아 일부만 표시됩니다. 전체 파일은 위 다운로드 버튼으로 확인해 주세요.

- - build.yml
- CODEOWNERS
- settings.json
- contributing.md
- PULL_REQUEST_TEMPLATE.md
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- - build.gradle
- - build.gradle
- build.gradle
- - debug_ce.sh
  - debug_web.sh
  - postgres.sh
  - README.md
  - sonar_events_simulation.sh
  - telemetry.sh
- editions.sh
- logs.sh
- os.sh
- patches_utils.sh
- property_utils.sh
- start.sh
- stop.sh
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- - build.gradle
- build.gradle
.dockerignore
.gitignore
.pre-commit-config.yaml
build.gradle
build.sh
debug-server.sh
gradle.properties
gradlew
gradlew.bat
HEADER.spotless
LICENSE.txt
logs.sh
NOTICE.txt
README.md
response.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/SonarSource/sonarqube

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd sonarqube

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

WEBAPP_BUILD_PATH=/path/to/sonarqube-webapp/server/sonar-web/build/webapp ./gradlew build

Gradle로 빌드를 진행합니다.

./gradlew build

Gradle로 빌드를 진행합니다.

./gradlew ide

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SonarQube [![Build](https://github.com/SonarSource/sonarqube/actions/workflows/build.yml/badge.svg)](https://github.com/SonarSource/sonarqube/actions/workflows/build.yml) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=sonarqube&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=sonarqube) [![AI Code Assurance](https://next.sonarqube.com/sonarqube/api/project_badges/ai_code_assurance?project=org.sonarsource.sonarqube%3Asonarqube-private&token=sqb_c0e2fa9ac4ef89f9a8403c6ba235e108ceb1dce1)](https://next.sonarqube.com/sonarqube/dashboard?id=sonarqube)

## 지속적인 검사 (Continuous Inspection)

SonarQube는 애플리케이션의 상태를 보여줄 뿐만 아니라 새로 도입된 이슈를 강조하는 기능도 제공합니다. Quality Gate를 설정하여 [Clean Code를 달성하고](https://www.sonarsource.com/solutions/clean-code/), 이를 통해 체계적으로 코드 품질을 향상시킬 수 있습니다.

## 링크 (Links)

- [웹사이트](https://www.sonarsource.com/products/sonarqube)
- [다운로드](https://www.sonarsource.com/products/sonarqube/downloads)
- [문서](https://docs.sonarsource.com/sonarqube)
- [웹앱 소스 코드](https://github.com/SonarSource/sonarqube-webapp)
- [X](https://twitter.com/SonarQube)
- [SonarSource](https://www.sonarsource.com), SonarQube 개발사
- [이슈 추적](https://jira.sonarsource.com/browse/SONAR/), 읽기 전용. SonarSource 팀원만 티켓을 생성할 수 있습니다.
- [책임 있는 공개 (Responsible Disclosure)](https://community.sonarsource.com/t/responsible-vulnerability-disclosure/9317)
- [Next](https://next.sonarqube.com/sonarqube) 차기 SonarQube 버전 인스턴스

## 질문이나 피드백이 있으신가요?

지원 관련 질문("어떻게 하나요?", "이런 에러가 발생했는데 왜 그럴까요?", ...)이 있으신 경우, 먼저 [문서](https://docs.sonarsource.com/sonarqube)를 읽어보신 후 [SonarSource 커뮤니티](https://community.sonarsource.com/c/help/sq/10)를 방문해 주세요. 질문에 대한 답변이 이미 등록되어 있을 가능성이 높습니다! 🤓

이 포럼은 커뮤니티 공간이므로 기본적인 인사말("안녕하세요", "감사합니다", ...)을 갖추어 주시기 바랍니다. 또한 스레드에 답변이 달리지 않더라도, 글을 끌올(bumping)하기 전에 최소 3일 이상 기다려 주시기 바랍니다. 대기 중인 상담원은 따로 없습니다. 😄

## 기여하기 (Contributing)

새로운 기능을 제안하거나 버그를 신고하고 싶으시다면, 저희 [포럼](https://community.sonarsource.com/c/sq/10)에 새 스레드를 생성해 주세요.

저희는 기능 기여를 적극적으로 찾고 있지 않다는 점을 양해 부탁드립니다. 사실상 SonarSource 외부 사람이 당사의 로드맵과 기대치에 부합하는 코드를 작성하기란 극히 어렵습니다. 따라서 대개는 사소한 외형적 변경 및 오탈자 수정만 생명력 있게 생략 없이 수용하고 있습니다.

이를 염두에 두고 코드 기여를 제출하고 싶으시다면, 이 저장소에 대한 풀 리퀘스트(Pull Request)를 생성해 주세요. 이 변경 사항을 기여하려는 이유(어떤 문제를 해결하려고 하는지, 어떤 개선을 이루고자 하는지)를 설명해 주시기 바랍니다.

당사의 [코드 스타일](https://github.com/SonarSource/sonar-developer-toolset#code-style)을 따르고 모든 테스트가 통과하는지 확인해 주세요(각 풀 리퀘스트마다 Travis 빌드가 실행됩니다).

SonarSource 제품에 기여하고 싶으신가요? 저희는 세계 수준의 코드 품질 솔루션을 함께 만들어갈 영리하고 열정적이며 숙련된 인재를 찾고 있습니다. 현재 [구인 공고를 확인해 보세요!](https://www.sonarsource.com/company/jobs/)

## 빌드하기 (Building)

소스를 로컬에서 빌드하려면 다음 지침을 따르세요.

### 요구 사항 (Requirements)

- Java 17 - 프로젝트 빌드에 필수
- 네이티브 Git - 설치되어 있어야 하며 PATH에서 사용 가능해야 함
- 테스트 - gradle 명령어에 `-x test`를 추가하여 필요한 경우 비활성화 가능 (테스트 실행 없이 빌드만 수행하려는 경우 유용)

### 빌드 및 단위 테스트 실행

프로젝트 기본 디렉토리에서 실행하세요:

./gradlew build

zip 배포 파일은 `sonar-application/build/distributions/`에 생성됩니다. 압축을 풀고 다음을 실행하여 서버를 시작하세요:

# Linux의 경우
    bin/linux-x86-64/sonar.sh start
    # 또는 MacOS의 경우
    bin/macosx-universal-64/sonar.sh start
    # 또는 Windows의 경우
    bin\windows-x86-64\StartSonar.bat

### IDE에서 열기

프로젝트가 한 번도 빌드된 적이 없다면 평소처럼 빌드하거나 (이전 섹션 참고) 다음의 더 빠른 명령어를 사용하세요:

./gradlew ide

그런 다음 IntelliJ나 Eclipse에서 루트 파일인 `build.gradle`을 프로젝트로 엽니다.

### Gradle 힌트

| ./gradlew 명령어                 | 설명                                      |
| -------------------------------- | ----------------------------------------- |
| `dependencies`                   | 의존성 목록 표시                          |
| `spotlessApply`                  | HEADER를 적용하여 소스 헤더 수정          |
| `wrapper --gradle-version 5.2.1` | 래퍼 업그레이드                           |

## UI 변경 사항과 함께 빌드하기

SonarQube UI(또는 웹앱이라고 부름)는 다른 저장소인 [sonarqube-webapp](https://github.com/SonarSource/sonarqube-webapp)에 있습니다.

`sonarqube` 저장소를 빌드할 때, 웹앱은 의존성으로서 Maven Central에서 자동으로 다운로드됩니다. 덕분에 웹앱에 대해 신경 쓰지 않고도 손쉽게 백엔드 변경 사항에 기여할 수 있습니다.

하지만 기여 내용에 UI 변경 사항도 포함되어 있는 경우, `sonarqube-webapp` 저장소를 복제(clone)하고, 그곳에서 변경 작업을 수행한 뒤 로컬에서 빌드해야 합니다. 그 후 `WEBAPP_BUILD_PATH` 환경 변수를 사용하여 사용자 정의 UI 빌드를 가리키도록 한 상태로 `sonarqube` 저장소를 빌드해야 합니다.

수행 방법의 예시는 다음과 같습니다:

```bash
cd /path/to/sonarqube-webapp/server/sonar-web
# 변경 작업 수행

# 의존성 설치, 최초 1회만 필요함
yarn

# 웹앱 빌드
yarn build

cd /path/to/sonarqube

# 웹앱의 커스텀 빌드를 사용하여 sonarqube 저장소 빌드
WEBAPP_BUILD_PATH=/path/to/sonarqube-webapp/server/sonar-web/build/webapp ./gradlew build
```

`./gradle.properties` 파일의 `webappVersion` 속성을 업데이트한 후 평소처럼 `sonarqube` 저장소를 빌드하여 특정 버전의 웹앱을 대상으로 지정할 수도 있습니다.

## 번역 파일

과거에는 번역 파일이 `sonar-core/src/main/resources/org/sonar/l10n/core.properties`에 저장되었으나, 이 파일은 이제 더 이상 사용되지 않으며(deprecated) 업데이트되지 않습니다.
기본 번역(영어)은 이제 다음 웹앱 저장소에서 정의됩니다:
https://github.com/SonarSource/sonarqube-webapp/blob/master/libs/sq-server-shared/src/l10n/default.ts

형식이 변경되었지만, 다음 명령어를 실행하면 여전히 `.properties` 파일 형식으로 가져올 수 있습니다:

```bash
cd /path/to/sonarqube-webapp/server/sonar-web

# 의존성 설치, 최초 1회만 필요함
yarn

# 모든 번역 키가 포함된 하위 호환 가능한 .properties 파일 생성
yarn generate-translation-keys
```

다른 언어로의 번역 확장에 기여하는 것은 여전히 이전과 동일한 방식으로 작동합니다. 단지 기본 번역의 진실의 원천(source of truth)만 변경되었습니다.

## 라이선스

Copyright (C) SonarSource Sàrl.

[GNU Lesser General Public License, Version 3.0](https://www.gnu.org/licenses/lgpl.txt)에 따라 라이선스가 부여됩니다.