Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: 코드 정적 분석을 위한 Jacoco 및 SonarCloud 도입 #147

Merged
merged 13 commits into from
Dec 26, 2023

Conversation

Ji-soo708
Copy link
Member

@Ji-soo708 Ji-soo708 commented Dec 24, 2023

개요

  • 모카콩 백엔드 코드를 정적 분석하기 위해 Jacoco 및 SonarCloud를 도입했습니다.
  • 정적 분석 도구로 SonarQube를 선택할 수도 있었지만 SonarQube의 경우, 직접 세팅까지 해야하고 PR 코멘트 또한 유료 기능이라 해서 SonarCloud를 선택했습니다.

작업사항

  • Jacoco 세팅
  • SonarCloud 세팅
    • CI 스크립트 수정
    • 모카콩 QualityGate 기준
      • image

주의사항

  • 추가적으로 커버리지 영역에서 제외해야 할 클래스가 있다면 알려주세요
  • QualityGate 기준을 수정하고 싶은 부분이 있다면 알려주세요

@Ji-soo708 Ji-soo708 changed the title infra: Jacoco 도입 infra: 코드 정적 분석을 위한 Jacoco 및 SonarCloud 도입 Dec 24, 2023
@Ji-soo708 Ji-soo708 changed the title infra: 코드 정적 분석을 위한 Jacoco 및 SonarCloud 도입 feat: 코드 정적 분석을 위한 Jacoco 및 SonarCloud 도입 Dec 24, 2023
@Ji-soo708 Ji-soo708 self-assigned this Dec 24, 2023
@Ji-soo708 Ji-soo708 added the 인프라 인프라 및 데브옵스 세팅 label Dec 24, 2023
@Ji-soo708
Copy link
Member Author

Ji-soo708 commented Dec 24, 2023

처음 커버리지 측정한 거라 모든 코드에 대해 측정이 됐나보네요. 👀

Copy link
Member

@kth990303 kth990303 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

궁금한 점들 남겨놨어요~
천천히 머지해도 된다면 베어 리뷰도 받은 후에 머지하면 좋을 거 같습니다

여담으로, 소나 code smell 개선 jira 티켓을 백로그로 만들어두어도 괜찮겠네요!

Comment on lines +67 to +73
"**/*Application*",
"**/*Controller*",
"**/config/*",
"**/dto/*",
"**/exception/*",
"**/security/*",
"**/support/*"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

테스트 커비리지 제외하는 패키지로 이해했는데 맞을까요?
Controller, dto, exception, support 까지 제외한 이유가 궁금합니다~

Copy link
Member Author

@Ji-soo708 Ji-soo708 Dec 26, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

네 맞습니다~ 해당 부분은 테스트 리포트 생성을 수행하는 태스크입니다. 저희 프로젝트에서는 주로 비즈니스 로직을 다루는 서비스 위주로 테스트를 진행하기에 서비스 외의 패키지 아래 파일들에 대해서는 커버리지가 비교적 낮게 나옵니다. 그래서 Controller나 dto, exception 이런 패키지들은 다른 프로젝트들에서도 커버리지 영역에서 일반적으로 제외하는 영역이라 저희도 제외했습니다! 만약 해당 패키지나 클래스들을 제외하지 않으면 아래와 같이 커버리지가 낮게 나옵니다.
image
image
image

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dto는 비즈니스로직만 테스트하여도 커버리지가 좀 나왔던 것 같은데, dto도 제외시키는게 좋을까요?

Copy link
Member Author

@Ji-soo708 Ji-soo708 Dec 26, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image

비즈니스로직 테스트가 잘 되어있어서 dto도 커버리지가 대체적으로 잘 나오는 편이지만 사진처럼 커버리지가 안나오는 dto들도 꽤 있었고 일반적으로 커버리지에서 많이들 제외하는 영역이라 저희도 제외했습니다! 그래도 dto 패키지 커버리지가 90% 나오는데 포함해도 될 거 같네요. 🙂 (근데 라인커버리지쪽에서는 실패뜨는 게 좀 있네요. 일단은 dto 역시 제외하고 머지하겠습니다! 나중에 리팩토링 후에 포함시켜도 될 거 같아요)

Comment on lines +100 to +108
excludes = [
'**.*Application*',
'**.*Controller*',
'**.config.*',
'**.dto.*',
'**.exception.*',
'**.security.*',
'**.support.*'
] + Qdomains
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

여기도 마찬가지로 이유가 궁금합니다 :)

Copy link
Member Author

@Ji-soo708 Ji-soo708 Dec 26, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

위에 남긴 코멘트 내용과 동일합니다~ 참고로 해당 태스크는 커버리지를 확인하는 태스크입니다.

Comment on lines +39 to +41
with:
arguments: check
cache-read-only: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/develop' }}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

cache-read-only는 빌드 시에 gradle cache를 이용해서 하도록 적용하는 것으로 이해했는데 맞을까요?
아래 이유가 궁금해서 코멘트 작성해봅니다 😄

  • 캐시 도입 이유
  • main, develop 브랜치에는 캐시 적용 제외된 이유

Copy link
Member Author

@Ji-soo708 Ji-soo708 Dec 26, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이 부분은 main과 develop 브랜치일때만 cache-read-only가 false되게 설정한 부분입니다. cache-read-only는 true일 경우 cache를 읽기만 하고 cache에 저장하지 않고 false일 경우는 읽기와 저장 모두 수행합니다.

결국 main이나 develop 브랜치에서 푸시될 때만 캐시에 저장되고 다른 브랜치들에서는 캐시읽기만 허용한 것인데 주로 안정된 코드를 추가하는 주요 브랜치에서만 빌드 시간을 최적화하기 위해 이렇게 설정했습니다.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

오..이부분 read-only가 true일 때랑 false일 때랑 시간의 차이도 궁금하네요 👀 새로운 것을 알아갑니다 👍

Copy link
Contributor

@jung-woo-kim jung-woo-kim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

소나 클라우드 아는게 거의 없어서 질문 밖에 없는 것 같네요 😢
질문만 확인해주시고, Jacoco와 SonarCloud는 사용하면서 개선해가도 좋을 것 같아요. 😄

고생하셨습니다 🙏

Comment on lines +39 to +41
with:
arguments: check
cache-read-only: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/develop' }}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

오..이부분 read-only가 true일 때랑 false일 때랑 시간의 차이도 궁금하네요 👀 새로운 것을 알아갑니다 👍

- name: Build and analyze
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SONAR_TOKEN 도 추가되었군요 👀

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

네 맞아요. SonarCloud에 대한 액세스를 인증하는데 사용되는 토큰입니다~

Comment on lines +67 to +73
"**/*Application*",
"**/*Controller*",
"**/config/*",
"**/dto/*",
"**/exception/*",
"**/security/*",
"**/support/*"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dto는 비즈니스로직만 테스트하여도 커버리지가 좀 나왔던 것 같은데, dto도 제외시키는게 좋을까요?

build.gradle Outdated
Comment on lines 37 to 51
sonar {
properties {
property 'sonar.host.url', 'https://sonarcloud.io'
property 'sonar.organization', 'mocacong'
property 'sonar.projectKey', 'mocacong_Mocacong-Backend'
property 'sonar.coverage.jacoco.xmlReportPaths', 'build/reports/jacoco/index.xml'
property 'sonar.sources', 'src'
property 'sonar.language', 'java'
property 'sonar.sourceEncoding', 'UTF-8'
property 'sonar.exclusions', '**/test/**, **/resources/**, **/*Application*.java, **/*Controller*.java ,**/config/**, **/dto/**, ' +
'**/exception/**, **/security/**, **/support/**, **/Q*.java'
property 'sonar.test.inclusions', '**/*Test.java'
property 'sonar.java.coveragePlugin', 'jacoco'
}
}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

개인적으로는 jacoco 관련 설정이 아래로 가고 의존성 선언이 더 위쪽으로 왔으면 하는데 어떤가요?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

좋습니다. 안그래도 새로 생긴 태스크들 추가하면서 dependency 위치를 어디다 두어야 할지가 고민됐었네요 ㅎㅎ..

Copy link

sonarcloud bot commented Dec 26, 2023

Quality Gate Failed Quality Gate failed

Failed conditions

1 Security Hotspot
C Maintainability Rating on New Code (required ≥ A)
D Reliability Rating on New Code (required ≥ A)
130 New Code Smells (required ≤ 0)

See analysis details on SonarCloud

idea Catch issues before they fail your Quality Gate with our IDE extension SonarLint SonarLint

@Ji-soo708 Ji-soo708 merged commit b4ed611 into develop Dec 26, 2023
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
인프라 인프라 및 데브옵스 세팅
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants