• 개인 성과
  • 문서기여 #11762 Remove helm installation guide and Add helm documentation link (opens in a new tab)
    • MinIO 설정을 위해 helm 설치를 해야하는데, mac에 관련된 설정만 나와 있어 helm 공식문서에 접근할 수 있도록 수정하였습니다.
  • 문서기여 #11735 Add installation option descrption (opens in a new tab)
    • managed namespace 옵션에 대한 상세한 설명을 추가해보았습니다.
    • 여기서 Kubernetes의 Documentation 컨벤션 (opens in a new tab)이 존재한다는 것을 메인테이너분께 배웠습니다.
• 컨트리뷰션 준비 과정 및 활동
  • Github 기초 익히기
    • 멘토님께서 과제로 본인의 프로필을 업데이트 하는 과제를 주셨습니다. GPG와 DCO봇의 개념을 익혀보며 github에 더 친숙해지는 시간을 가졌습니다.
  • Docker 왕초보 특별반
    • Dockerfile을 사용해서 도커 이미지를 만드는 활동을 했습니다. 멘토님께서 정리하신 자료를 읽고 개념을 익혔습니다. 추가적으로 이미지를 만들 때 실행 시 필요한 기능만 넣도록 multi stage build (opens in a new tab)를 적용해보았습니다.
    • 실습 이후 멘토님께서 Overlay FS (opens in a new tab)에 대해 하나하나 보여주시면서 이미지가 어떻게 만들어지는지 보여주셨습니다. 이건 정말 알찼습니다..
  • 쿠버네티스 기초 공부
    • 컨트리뷰션 이전에 쿠버네티스의 기초를 공부하는 시간을 가졌습니다.
      • 개인 공부자료 (opens in a new tab)
  • Argo workflows
    • template을 만들어보며 스스로 공부하는 시간을 가졌습니다 (opens in a new tab).
    • 학준 멘티님이 GCP에서 ArgoCD와 Argo Workflows를 활용해 배포하는 파이프라인 (opens in a new tab)을 알려주셨습니다.
  • OSS 모임 활동 참여
    • 멘토님과 멘티분들께서 다양한 주제로 발표하는 시간을 가졌습니다. 컨트리뷰션 이외에 실무에서 어떤 문제들을 고민하는지, 그리고 문제들을 어떻게 해결했는지 들을 수 있는 좋은 시간이었습니다
  • 해커톤 참여
    • 성락 멘티님이 많은 도움을 주셨습니다. 괜찮다고 생각하는 이슈들을 공유해주시고 항상 도전할 것을 권해주셨습니다.
    • #11609 Compile expr in config (opens in a new tab) 이슈를 추천해주셔서 도전해보았습니다.
    • Golang을 스스로 공부해보고 (opens in a new tab) Issue를 분석하는 시간을 가졌습니다.
    • golang에 좀 더 친숙해질 수 있는 시간이 되었습니다.

• Issue 1개, PR 3개
• GitHub Actions log 가독성 향상을 위한 이름 수정
  • https://github.com/argoproj/argo-workflows/pull/11670 (opens in a new tab)
  • publish-release에서 진행하는 step중 Run actions/cache@v3를 총 세번 수행하는데 각자 하는 역할이 다른데 같은 이름으로 표기되어 있어 같은 작업이 세번 이루어지는 것처럼 느껴 질 수 있는 부분을 각자 역할에 맞는 이름으로 수정
• GitHub Actions 필요없는 캐시 로직 삭제
  • https://github.com/argoproj/argo-workflows/pull/11754 (opens in a new tab)
  • setup-go actions에서 cache option을 false로 주지않는 이상 default로 caching을 해주기때문에 중복되는 캐시때문에 발생하던 오류를 수정
• Deprecated 된 NodeJS 16 버전을 사용하는 checkout@v3를 모두 checkout@v4로 업그레이드
  • https://github.com/argoproj/argo-workflows/pull/11782 (opens in a new tab)
  • NodeJS 가 곧 보안지원이 종료되므로 최신버전을 사용하는 actions을 사용하도록 수정

[프로젝트 기여 항목]

1. 버그수정 Argo Workflow Datepicker 개선 (완료)

   workflow 목록 페이지의 filter 기능 중 하나인 datepick의 ui를 개선

   

   

   이슈링크

   UI: Datepicker Style Malfunction Issue · Issue #11476 · argoproj/argo-workflows (opens in a new tab)

   PR링크

   fix: Datepicker Style Malfunction Issue. Fixes #11476 by zel0rd · Pull Request #11480 · argoproj/argo-workflows (opens in a new tab)

2. 버그수정 Cron workflow의 State filter 초기값 설정(완료)

   cron workflow의 status filter가 초기값과 상관없이 랜더링 되는 버그 수정

   

   이슈링크

   ui: Cron workflow initial filter value · Issue #11685 · argoproj/argo-workflows (opens in a new tab)

   PR링크

   https://github.com/argoproj/argo-workflows/pull/11686 (opens in a new tab)

3. 버그수정 초기 페이지에서 발생하는 webpack 관련 warning 제거하기 (진행중)

   argo workflow ui 로드시 발생하는 웹팩 워닝을 제거하기

   현재 관련 라이브러리들의 의존성 및 기능을 테스트 하는 중

   

4. 기능개선 로그인 페이지 개선 (진행중)

   Argo Workflow의 기존 로그인 페이지를 Argo CD와 같은 형태고 개선하는 이슈

   현재 workflow에서 제공하는 로그인 기능을 분석하고, 이후 새로운 설계 및 디자인을 적용할 예정

   이슈링크

   Similar login page to Argo CD · Issue #10816 · argoproj/argo-workflows (opens in a new tab)

[프로젝트 활동 내역]

7.8 발대식(프로젝트 소개 및 자기소개)

• 발대식 진행
• 별명을 이용한 자기소개 시간
• 프로젝트에 대한 대략적인 소개
• 모임활동 규칙을 위한 다수결 투표
  • 다음 모임 활동은 발대식 참석자들의 다수결에 따라 정기 일정과 다르게 토요일(07/15) 오후 1시부터 진행하기로 했습니다. 계획된 활동 주제는:
  • 다음 한 주간 진행할 공통 활동에 대한 리뷰 또는 이야기 나누는 시간
  • 서로 관심 있는 주제에 대한 소통 시간
  • 멘티 여러분들의 진행도에 따라 개발 환경 설정도 진행해 볼 수 있습니다. (Optional)
  • (공통 활동 내용은 내일 일과 시간 내로 정리해서 공유드릴 것입니다.)

7.15 1차 모임 (개발환경 설정 및 workflow 기능 소개)

• Open Up에서 1차 모임 진행
• 개발 환경 설정 (dev-container)
• 플레이그라운드 미션 (DCO 봇 체크 통과, GPG를 이용한 커밋, 커밋 메시지 컨벤션)
  • 실제 오픈소스 프로젝트에 바로 도전하기 전에 플레이그라운드를 생성했습니다. 첫 목표는 이 플레이그라운드의 프로젝트에 외부인의 입장에서 이슈/PR/커밋 등을 수행하는 것입니다. 간단하지만 처음 경험하는 입장에서는 생각하지 못한 관문이 존재할 수 있으니 집중해 주세요. 첫 이슈를 일찍 해결하면 추가로 지시할 사항을 전달해 드릴 것입니다. ㅎㅎ
  • 저장소: https://github.com/ArgoWorkflows-OSS/ArgoWorkflows-OSS (opens in a new tab)
  • 목표 : 이슈 템플릿의 멤버 프로필 업데이트 이슈를 선택하고, 이슈 내용에 따라 첫 PR을 생성해요.

7.23 2차 모임(관심있는 이슈사항 공유)

• 성수에 모여서 2차 모임 진행(무신사 장소제공 - 안다혜 멘티 지원)
• 관심있는 이슈에 대해 소개하고, 서로의 문제 공유하기

8.6 4차 모임

발표활동

• argo event와 workflow, cd연동
• eBpf

8.13 5차 모임

발표활동

• webRTC

8.20 6차 모임

발표활동

• 개발자가 스스로 부하테스트 할 수 있는 플랫폼 구축기 & K6 부하테스트 PoC

[프로젝트 활동 내용]

1. [기여를 위한 학습]
   1. 쿠버네티스 아키텍처 강의 - YouTube 링크 (opens in a new tab)
   2. 쿠버네티스 리소스 강의 - YouTube 링크 (opens in a new tab)
   3. Go Playground - https://go.dev/play/ (opens in a new tab)
2. 배운점 및 느낀점
   1. 프로젝트에 기여하기 위해선 해당 분야의 도메인 지식이 중요하다는 것을 깨달았습니다. 단순히 웹서비스에 기여하고자 하였지만, 쿠버네티스에 대한 지식부족으로 환경셋팅하는 것부터 쉽지 않았습니다.
   2. 큰 오픈소스 프로젝트에선 DCO/GPG 같은 것을 사용한다는 것을 배웠고, 오픈소스 프로젝트가 어떻게 관리되고 운영되는지 배워볼 수 있었습니다.
3. 이슈 및 PR내역

• 개인 성과
  • 이슈 1개, PR 1개 기여
• 컨트리뷰션 준비 과정
  • YouTube에 업로드 된 OSSCA 기본 교육을 확인했습니다. Git, Vim 등 기존에도 많이 사용해보고 개념도 알고 있는 내용이었지만, 평소에 사용하면서 모르고 있었거나, 대충 사용하던 부분들도 많이 알고 이해할 수 있었습니다.
  • ArgoWorkflows-OSS/ArgoWorkflows-OSS 저장소에서 Git 환경 설정 및 Issue와 PR을 연결하고 클로즈하는 예제를 진행했습니다. Argo Workflows는 PR 생성 시에 모든 커밋이 gpg private key로 서명되어 있어야 하고, sign-off 되어 있어야 합니다. 그렇지 않은 경우 GitHub CI에서 failure 하게 됩니다. Argo Workflows에 실제로 기여하기 전, 미리 로컬 Git 환경을 설정하고 모의로 PR을 생성하는 데 큰 도움이 되었습니다.
    • https://github.com/ArgoWorkflows-OSS/ArgoWorkflows-OSS/pull/38 (opens in a new tab)
  • Argo Workflows 개발 환경을 설정했습니다. 처음에는 devcontainer를 이용해 설정했고, 이후에 Nix를 이용했습니다. Argo Workflows는 개발 환경에서 React UI, Argo Server, MySQL 등 여러 컴포넌트가 함께 필요해 개발 환경을 구성하기 어려운 편인데, 여러 주차에 걸쳐 개발 환경을 완전히 구성할 수 있었습니다.
• 컨트리뷰션 진행 내용
  • 버그수정 Nix go build 수정
    • https://github.com/argoproj/argo-workflows/pull/11635 (opens in a new tab)
    • 기존 코드 베이스는 Go 1.20을 사용하고 있었으나, Nix 빌드 파일에서는 Go 1.19를 사용하는 문제가 있었습니다. 기존에는 빌드가 문제 없이 되었었지만, Go 1.20에 새로 추가된 문법을 사용하기 시작하면서 Nix 빌드에 문제가 발생했습니다.
    • _module.args 를 이용해 Go 1.20을 기본으로 사용하도록 수정하고, Nix 빌드를 수정했습니다.
  • 기능개선 Nix go vendor hash 자동 갱신
    • https://github.com/argoproj/argo-workflows/issues/11691 (opens in a new tab)
    • 컨트리뷰션을 준비하는 과정에서 개발 환경을 설정할 때 알게 된 이슈입니다. Nix는 재현 가능한 빌드를 추구하는데, GitHub의 Dependabot이 자동으로 Go module 버전을 올려줄 때 Nix의 의존성 hash 값은 함께 변경하지 않는 문제가 있습니다.
    • 이로 인해 종종 개발 환경을 설정할 때 개발자들이 직접 수동으로 Nix의 go vendor hash를 계산해 갱신해야 하는 상태인데, 이를 개선하기 위해 해결 가능한 방법들을 찾아보고 있습니다.
    • 해결 방법을 기여자들과 함께 찾기 위해, 기존 PR과 Comment들의 내용을 모아 Issue를 생성했습니다.
    • 기존 다른 오픈소스 프로젝트들에서도 해결하지 않고 개발자들이 수동으로 반영하고 있는 상태여서, Argo Workflows에서 기여한 이후에는 다른 프로젝트들에도 기여할 수 있을 것 같습니다.
  • 기능개선 CHANGELOG.md 스크립트 개선
    • https://github.com/argoproj/argo-workflows/pull/11733 (opens in a new tab)
    • Markdownlint는 프로젝트 내 문서들을 일관된 형식으로 작성될 수 있도록 강제하고, 문서를 더 읽고 수정하기 쉽게 만들어주는 도구입니다.
    • 기존에 Markdownlint를 사용해 프로젝트 Markdown 문서에 대한 린터 설정을 구성했었는데, 스크립트를 이용해 자동으로 생성되는 CHANGELOG.md 파일은 린터 룰에 맞지 않아 이를 개선했습니다.
    • 변경된 스크립트를 통해 새로 생성된 CHANGELOG.md 변경 사항은 이 PR에 담겨 있습니다. → https://github.com/argoproj/argo-workflows/pull/11773 (opens in a new tab)
  • 기능개선 문서 스타일 개선
    • https://github.com/argoproj/argo-workflows/pull/11787 (opens in a new tab)
    • Markdownlint를 따르지 않는 일부 문서들의 스타일을 개선했고, 자동으로 생성되는 문서들에 대해서는 이후 PR에서 수정하기로 공유했습니다.

리팩토리

fix: Upgrade Go to v1.21 Fixes #11556[**Merged]**

• Argo Workflows는 Go언어로 개발되어 있습니다.
• Go Version을 1.20 → 1.21로 업그레이드 하는 Issue가 발행되어 해결해보자 하였습니다.
• 이슈 해커톤 기간에 해당 이슈를 제시하여 같은 팀원 분들과 함께 이슈 해결 및 PR을 진행했습니다.
• 결과적으로 첫 PR과 첫 컨트리뷰터 뱃지를 달아볼 수 있는 영광스러운 시간이었습니다.

fix: Upgrade Go to v1.21 Fixes #11556 by junkmm · Pull Request #11601 · argoproj/argo-workflows(opens in a new tab) (opens in a new tab)

소그룹 발표

• Challenges 기간에 Argo Projects를 활용한 CI/CD 구현했던 결과를 주제로 Offline 미팅 시간에 발표하는 시간을 가졌습니다.

• 발표하며 제 생각을 정리하고, 서로 대화하며 데브옵스와 Argo Project 생태계를 이해할 수 있는 유익한 시간이었습니다. 이슈 해커톤

• 컨트리뷰션 활동에 진입 장벽과 동기부여를 위해 안다혜님의 의견으로 멘토님 주도하에 이슈해커톤이 진행되었습니다.

• 멘토님의 주도하에 성락님과, 문영님, 병선님과 같은 팀이 되었습니다.

• 이 기간에 제가 제시한 go 1.20 → 1.21 업그레이드 이슈 해결 성과를 달성했습니다.

• Argo Workflows에 내장된 Prometheus Metric 값을 추가하는 Issue를 해결해보고자 했으나, 높은 난이도로 인해 중단되었습니다. 하지만 이 과정을 통해 Prometheus는 별도의 Exporter를 설치해야만 한다 라는 제 고정관념이 무너지고 시야가 확장되는 좋은 경험을 했습니다. plan to add workflow labels to the metric? · Issue #9849 · argoproj/argo-workflows(opens in a new tab) (opens in a new tab)

• 아래 이슈를 해결하고자 하고 있습니다. Compile expr in config · Issue #11609 · argoproj/argo-workflows(opens in a new tab) (opens in a new tab)

왕 초보 특별반 - Container Playground

• Argo Workflows는 쿠버네티스 네이티브 환경에서 기동되는 오픈소스 입니다.
• 멘토님은 쿠버네티스에 대한 지식이 있어야 우리 프로젝트를 접근하는데 있어 도움이 된다고 하시며 쿠버네티스 스터디를 Open 하였습니다.
• 첫 번째 미션은 제시하는 조건에 만족하는 Web Container를 생성하는 것이었습니다.
• 평소에 Dockerfile을 생각없이 작성하던 저에 대해 반성하게 됐고, 멀티 스테이징과 빌드 속도와 도커파일 작성 방법에 대한 관계를 배울수 있던 좋은 시간이었습니다.

기능개선

A new feature to support Secrets as a type of parameters (링크 (opens in a new tab))

기존의 Argo Workflow는 WorkflowTemplate에 argument(인자)를 전달할 때 직접 인자를 정의할 수도 있고, ConfigMap을 참조하도록 설정할 수도 있었습니다. 하지만 일반적인 kubernetes 생태계를 지원하는 다른 도구들과 달리 Secret을 참조하는 기능은 지원되지 않았습니다.

이에 대한 Feature request가 https://github.com/argoproj/argo-workflows/issues/5506에서 (opens in a new tab) 이루어지기 시작했고, 해당 기능을 구현해 Draft PR을 만들어둔 상태입니다.

이 기능은 특히나 Kubernetes에서의 CustomResourceDefinition이라는 인터페이스와 같은 것의 정의를 바꿔야하고, workflow가 생성되어 사이드카를 주입받고 Pod로 생성되는 일련의 라이프사이클을 모두 파악해야했기에 개발하기 쉽지 않은 편이었습니다.

하지만, 해당 기능을 구현해나가면서 Workflow가 결국 Pod와 container로 변환되어 동작하게 되는 과정을 깊이 있게 파악할 수 있었고, Workflow가 내부적으로 context 및 argument를 templating하는 로직도 많이 파악할 수 있었던 이슈였습니다.

이슈생성

Incorrect creator labels on a resubmitted Workflow (링크 (opens in a new tab))

Argo Workflow에는 동일한 template을 바탕으로 Workflow를 다시 생성하고 실행하는 Resubmit이라는 기능이 존재합니다. Resubmit된 Workflow의 경우 Workflow 생성 유저 관련 k8s object label이 Resubmit한 유저를 바탕으로 설정되는 것이 아니라 기존 잘못된 값으로 설정되는 버그가 존재했습니다.

이로 인해 한 Workflow를 실행한 유저와 그 Workflow를 Resubmit한 유저가 다르면 Resubmit을 통해 생성된 Workflow에는 잘못된 Workflow 생성 유저 관련 k8s object label이 붙곤 했습니다.

이에 대한 이슈를 제기했습니다.

버그수정

fix: Apply the creator labels about the user who resubmitted a Workflow (링크 (opens in a new tab))

앞서 생성했던 이슈(버그)를 해결하는 Pull Request를 작성했습니다.

Resubmit 시에 기존 Workflow 실행자의 정보를 고려하지 않고 Resubmit한 유저 정보만을 바탕으로 올바른 Workflow 생성자 k8s object label을 달도록하여 버그를 수정했습니다.

변경사항에 대한 예시로 foo라는 유저가 실행한 Workflow를 bar라는 유저가 Resubmit한 경우, 인증되지 않은 유저가 Resubmit한 경우 creator 관련 label이 어떻게 달리는지를 제시했습니다.

또한 다른 코드에도 많은 영향을 끼친 부분이 존재해 이에 대한 테스트 코드도 작성해 안정성을 높였습니다.

기능개선

feat: Propagate creator labels of a CronWorkflow to the Workflow to be scheduled (링크 (opens in a new tab))

로그인한 유저가 CronWorkflow를 만든 경우 CronWorkflow에는 생성자에 대한 k8s object label이 붙게 됩니다. 하지만 CronWorkflow의 설정을 바탕으로 주기적으로 생성되는 Workflow에는 해당 k8s object label이 붙지 않게 되는 이슈가 존재했습니다.

따라서 CronWorkflow로 생성되는 Workflow들이 CronWorfklow의 생성자 라벨을 그대로 전파받도록 개선했습니다.

이슈생성

Insufficient logging in /oauth2/callback handler when using SSO Authentication (링크 (opens in a new tab))

Keycloak이라는 Identity Provider 오픈소스 제품을 이용해 Argo Workflows에 SSO(Single Sign On)으로 인증 기능을 활성화하려했으나 이 과정에서 로그가 부족해 활성화 작업이 크게 지연된 것을 경험했습니다. 이에 해당 기능 활성화 작업에 대한 로깅 강화를 주제로한 이슈로 열었습니다.

기능개선

feat: Improve logging in the oauth2 callback handler (링크 (opens in a new tab))

위에서 언급한 이슈(블록 링크 (opens in a new tab))를 해결한 Pull Request입니다. SSO를 위해 OAuth2 Protocol을 이용하는 과정에서 발생하는 에러 케이스별로 에러 로그를 출력하도록 기능을 개선했습니다.

또한 Pull Request의 Reviewer가 좀 더 편하게 리뷰할 수 있도록, Pull Request가 설득력을 갖도록, 변경사항을 검증할 수 있는 Verification을 코드로 나타냈습니다.

공부

docs: Add a user named 박진수 (링크 (opens in a new tab))

행사를 시작하면서 멘토님께서 GitHub에과 친해질 수 있도록 만들어주는 레포지토리의 멤버 프로필에 저에 대한 소개를 추가해 Pull Request를 생성해보는 실습을 진행했습니다.

• 개인 성과
  • PR 1개 Open
• 컨트리뷰션 준비 과정
  • OSSCA 사무국이 공유해주신 기본 Git 전략에 대한 공유 영상을 확인하고, 놓치고 있는 새로운 부분과 기존의 알고있던 개념을 결합시켜 Git에 대한 이해와 응용도를 높였습니다.
  • 팀에서 진행하는 ArgoWorkflows-OSS/ArgoWorkflows-OSS 레포지토리에서 오픈소스 컨트리뷰트를 위해 필수적으로 알아야할 개념(gpg private key)와 issues, PR title 등을 실제로 미션을 수행하며 경험적으로 체득할 수 있도록 했습니다.
  • devcontainer를 사용해 Argo Workflow의 로컬 개발환경을 직접 구축하고 테스트해보며 실제로 컨트리뷰트를 하기위한 필수조건을 테스트해봤습니다. 여러 라이브러리 종속성에 대한 이식성이 좋은 도구여서 매우 사용하기 편리했습니다.
• 컨트리뷰션 진행 내용
  • 공식 docs의 fields 예제 수정
    • https://github.com/argoproj/argo-workflows/pull/11748 (opens in a new tab)
    • 기존 공식문서에서 크론워크플로우를 사용하지 않는 문서 예제가 CronWorkflowSpec , CronWorkflowStatus 필드에 포함되어 있어 필요한 데이터를 찾는 데 혼란을 불러왔었습니다.
    • 그래서 필요한 자료를 찾기 위해 CronWorkflowSpec , CronWorkflowStatus 필드의 예제에서는 크론워크플로우를 사용하는 예제만 허용하도록 했습니다.

컨트리뷰션 활동

Mutex check happens after memoization cache check and lock info missing from UI버그수정

Issue #11219 (opens in a new tab) PR #11456 - Merge 완료/3.4.10 릴리즈 포함 (opens in a new tab)

Argo Workflow 의 Synchronization 및 Cache 기능을 동시에 사용할 수 있도록 수정할 수 있었습니다.

해당 버그는 Argo Workflow 에서 Synchronization 및 Memoize 키워드를 같이 사용할 시 정상적으로 동작하지 않는 현상이었습니다.

기대 동작은 Mutex Synchronization 이 동작한 이후 캐시가 동작하는 것이지만, Synchronization 가 동작한 뒤 캐시가 작동하지 않고 있었습니다.

예를 들어 아래와 같이 job-1 과 job-2 가 있을 시 job-1 이 Synchronization 효과로 인해 먼저 동작을 하고 캐시를 쓰고 완료가 되면, job-2 는 ** 동일한 캐시로 인해서 동작하지 않고 Pass 해야 합니다.**

저는 이 과정을 Synchronization 과 Cache 의 순서를 조정하는 것으로 올바르게 수정할 수 있었습니다.

어렵지는 않은 수정이었지만, 복잡한 파일 중 하나인 operation.go 를 수정했기에 많은 리뷰와 함께 Argo Workflow 의 다양한 기능들을 살펴볼 수 있었던 PR 이라 생각합니다.

Parent level memoization is broken버그수정

Issue #11612 (opens in a new tab) PR #11623 - Merge 완료/3.4.11 릴리즈 포함 (opens in a new tab)

위 수정으로 발생한 새로운 버그 사항으로, Argo Workflow 의 Template 레벨이 아닌 아래 Child 구성 요소에서 Memo 기능을 사용 시 무한 Pending 이 걸리는 버그가 제보되었습니다.

이전 PR 에서 테스트를 추가했으나 확인하지 못한 Case 가 존재했다는 것을 인지하고, 오류 발생 원인을 분석해서 다시 핫픽스를 반영할 수 있었습니다. 이 예외 사항을 추후에도 발견하기 위한 테스트를 4개 포함하여 PR 을 진행했습니다.

UI: workflowDrawer's information link is not correctly working버그수정

Issue #11494 (opens in a new tab) PR #11495 - Merge 완료/3.4.10 릴리즈 포함 (opens in a new tab)

Argo Workflow 대시보드에서 워크플로우를 펼쳤을 시, Information 아이콘의 링크가 망가진 사항을 수정했습니다.

<a> 태그 중첩으로 인한 잘못된 이벤트 전파를 방지하는 코드를 추가해 제대로 클릭이 동작하게 만든 내용입니다. 해당 코드 수정으로 다시 아이콘 클릭 시 올바른 문서로 이동하도록 만들 수 있었습니다.

Search by name for WorkflowTemplates in UI기능개선

Issue #11004 (opens in a new tab) PR #11684 - Merge 완료/3.4.10 릴리즈 포함 (opens in a new tab)

다른 2명의 참가자 분들과 공동으로 개발하여 PR 을 진행한 내용입니다. Argo Workflow 에는 이름의 패턴을 통해 각 템플릿을 기능하는 유용한 기능이 빠져 있었습니다.

이 기능을 추가로 제공하여 사용자가 더 이상 Yaml 의 라벨 뿐만이 아닌 이름으로도 Template 을 검색하도록 개발했습니다. 특히 정확한 이름이 아닌 LIKE 검색이라는 것이 앞으로도 유용할 것 같습니다. 이후에도 다른 페이지에 대해서 비슷한 수정을 통해 검색과 페이지네이션 기능을 확장할 예정이라 더욱 의미있는 PR 이었던 것 같습니다.

Add more readable Argo CLI installation guide into github documentation문서기여

Issue #11750 (opens in a new tab) PR #11751 - Merge 완료 (opens in a new tab)

Argo Workflows 에서 사용하는 커맨드라인 인터페이스인 Argo CLI 에 대한 문서 기여입니다.

현재 Argo CLI github 문서에는 인스톨에 대한 과정이 빠져 있어서, 첫 사용자가 Argo CLI 를 설치할 방법을 찾기가 어려웠습니다. 기존에는 Release Note 로 직접 찾아 들어가거나 Quick Start 페이지로 반드시 들어가야 했는데, Argo CLI 페이지에 기존 Usage 이외에 Installation 항목을 추가하여 사용자 편의성을 높이도록 수정했습니다.

Workflow templating is skipped when whitespace is added to template parameters버그수정

Issue #11767 (opens in a new tab) PR #11781 - Merge 완료 (opens in a new tab)

Argo Workflow 에서 workflow template 작성 시 들어가는 {{parameter}} 형태의 placeholder 가 {{ parameter }} 와 같이 앞 뒤로 공백이 있을 경우 유효성 검사가 되지 않는 현상이었습니다. 내부 유효성 검사 코드에서 parameter 에 대해서 앞, 뒤의 공백을 자르는 trim 을 하지 않고 있는 것이 원인으로, 이 부분에 trim 을 추가하여 공백을 제거해 해결했습니다. 이 기여로 인해 기존 placeholder 내용이 유효성 검사를 무시해버리는 현상도 바로 잡을 수 있었습니다.

모임 개발 활동

Argo Workflow OSS 공통 Repo 에 PR 올려보기

PR #22 - Merge 완료 (opens in a new tab)

Argo Workflow PR 전 여러 사람이 기여하기 위한 사전 연습을 진행했습니다. 새로운 문서 및 기존 문서를 다른 참가자들과 동시에 수정하여 올려서 Git 커맨드 및 Rebase 의 소중함에 대해서 배울 수 있었습니다.

Dockerfile 로 웹서버 만들어보기

PR #6 - Merge 완료 (opens in a new tab)

로컬 8080 서버로 통신하여 localhost:8080 으로 접근 가능한 Dockerfile 을 하나 작성하고 서버를 띄우는 연습이었습니다. 간단한게 Flask 로 파이썬 서버를 작성하고 Dockerfile 내 환경 설정, 서버 구동, 포트 연결을 통해서 Docker 커맨드로 외부에서도 서버에 접속 가능하도록 만들었습니다.

문서 수정 공식 문서의 running-locally (opens in a new tab) 부분이 Dev-container와 Makefile을 처음 사용하는 사람들에게 직관적이지 않고, 깨진 링크들이 있어 pr #11405 (opens in a new tab)를 올리고 공식 문서를 수정하는 데 기여하였습니다.

이슈 기여 미완성 이지만 Argo-workflows 의 워크플로우나, 워크플로우 내의 Pod 내에서 Secret 정보가 echo 등의 명령어로 노출될 수 있는 이슈 #8685 (opens in a new tab) 가 있어 이를 해결해보고자 했습니다.

4일 동안 하루에 3시간 정도, 총 12시간 정도를 이 이슈에 투자했으나 아직 해결하진 못하였습니다. (중간 커밋 (opens in a new tab))

• 총 11개 파일에 걸쳐 Argo-workflows 실행 시 주입할 수 있는 환경변수인 ARGO_HIDE_SECRETS 을 추가하고 기본적으로 해당 옵션이 true 로 작동하게 하였습니다.
  • 위 환경변수를 command line에서 입력받거나, Argo-workflows 를 실행할 당시에 설정으로 추가할 수 있도록 하였습니다.
  • 만약 ARGO_HIDE_SECRETS=false 로 설정할 경우, "You are running with logging include secrets. Be careful." 라는 로그가 찍히도록 하였습니다.
  • workflow, pod의 로그에서 Secret에 해당하는 정보가 포함될 경우, SecretValue를 마스킹 할 수 있도록 코드를 수정하였습니다.
    • 테스트 코드를 작성하여 위 기능이 목적한 대로 동작하는지 검증하였습니다.
    • 하지만 위 기능이 목적한 대로 작동하지 않았기에, 로그가 찍히는 과정을 탐색하기 시작하였습니다. Go 언어에서 사용하는 logrus (opens in a new tab) 라이브러리는 io (opens in a new tab) 패키지의 io.Writer 를 사용한다는 것을 알게 되었습니다.

과제 수행 Argo-workflows 팀은 멘토님이 OSS-Argo-workflows 레포지토리를 생성하고 여러 과제를 내주셨습니다.

• 실제 Argo-workflows 레포에서 pr을 올릴 때 지켜야 하는 원칙 (presigned commit, gpg check) 을 지키며 pr을 올리고, git conflict 를 해결하는 방법을 과제를 통해 배워나갔습니다.
• 실제 Argo-workflows 레포에서 pr을 올리기 위해, 코드를 수정한 후 Argo-workflows가 제대로 작동하는지 확인하려면 local 환경에서 Dev Container로 Argo-workflows를 동작시켜야 합니다. 저희 팀은 이 과정을 직접 수행해보는 과제를 받았고, 그 과정에서 수행에 어려움을 겪는 멤버들을 서로 도와주었습니다. 저는 블로그 글에 해당 방법을 수행하는 법을 정리하여 팀원들에게 공유하였습니다. blog (opens in a new tab)

1. 오픈소스 첫 기여

처음으로 ArgoWorkflows에 문서를 통한 기여를 했습니다. 공식 사이트에 이미지인지 비디오인지 혼동을 줄 여지가 있는 부분을 고쳐, 유저들이 확실히 동영상임을 인지하도록 수정했습니다. docs: modify demo image in intermediate-inputs.md #11755 (opens in a new tab)

2. 다른 멤버의 활동을 보며 오픈소스 기여법 터득

이번 오픈소스 컨트리뷰선 아카데미를 통해 오픈소스 기여를 하는 방법과 이슈를 찾는 요령에 대해서 알게 되었습니다. 요약하면 다음과 같습니다.

• 주요 로직이 아닌 아주 자잘한 버그 이슈, 또는 UI 부분에서도 생각보다 이슈가 엄청 많다.
• 해당 오픈소스의 전문적인 지식, 또는 다른 분야 (ex. 프로트) 종사자여도, 충분히 해당 오픈소스에 기여할 수 있는 이슈들이 많다. (ex. UI 이슈)
• 기여를 하고 싶을 때는, 해당 이슈에 먼저 직접 이 이슈를 해결하고 싶다는 코멘트를 단 후, 작업을 시작한다.
• 이 부분이 좀 신기했는데, Argo Workflow의 경우는 기여를 할 때 담당자가 배정된다는 점이 좀 신기했다. 아마 모르는 점? 또는 생소한 부분이 느껴질 때 담당자를 배정하는 것 같다.
• 다양한 사람들이 많다. 정말 까칠하게 딱 한 줄 적으시는 분도 있고, 굉장히 친절하게 코멘트를 달아주시는 분도 있다.

다른 회원분들의 이슈 해커톤을 보며 이슈에 직접 기여하는 방법을 알게 되었습니다. 특히 다른 회원분의 이슈 중 “Pagination” 이슈를 매우 흥미롭게 봤습니다. 제가 argo workflow를 사용할 때는 눈치를 채지 못했는데, 페이지네이션이 일관성이 없다는 걸 캐치하시고 이슈를 만들어 기여를 하시는 것에서, 저렇게 자칫 지나쳐 갈 수도 있는 곳에도 충분히 기여가 가능하구나 라는 걸 깨달았습니다.

3. 개발 컨테이너 구축

개인적으로 활동을 한 건 devcontainer를 직접 띄워 개발 환경을 세팅했습니다. 사실, 그 과정에서 무수한 오류가 발생했는데, 다른 분들께서 직접 도와주시고 골머리를 앓아가며 마침내 해결한 것을 보고, 뭔가 실무에서도 버그가 발생하면 다른 개발자분들이 오셔서 같이 머리를 쥐어짜내실 것 같은 모습이 상상이 갔습니다.

멘토님께서 의존성 문제 해결 및 후에 다른 사람이 제 프로젝트에 이슈를 만들때, 동일한 환경에서 작업하는 것을 보장하기 위해 개발 컨테이너를 사용한다는 것을 알게 되고, 현재 제가 진행하고 있는 다른 프로젝트 (디스코드 봇 관련 프로젝트) 에서도 개발 컨테이너를 활용하여 개발을 해야될 것 같다고 생각했습니다.

중간 보고서 이후에는 조금 마음가짐을 바꿔 위축감을 느끼는 것 보다는, 다른 현직자 분들이 실무에서는 어떤 식으로 서비스를 운영하시는지 그런 것들을 엿듣는 기회를 잡고자 했습니다. 실제로 멘티분들께서 다양한 주제로 발표를 하셨으며 회사 내에서 이루어지는 부하테스트, ebpf에 대한 설명 등 흥미로운 주제들을 들을 수 있었습니다. 학교를 다니면서 듣기 힘든 아주 귀중한 발표였던 것 같습니다.

4. GPG Sign을 이용한 Verified Commit 방법 숙달 및 팀 깃허브 소개글 업로드

그동안은 별도의 GPG Key없이 커밋을 해왔는데, 멤버 소개글을 업로드 하는 과정에서 DCO봇과 GPG 확인해서 계속 막혀, Verified 커밋을 생성하는 방법을 터득하고 팀 깃허브 레포에 소개글을 업로드했습니다. 그 과정에서 커밋을 할 때마다 자꾸 멈춰 애를 먹는 도중 같은 팀원의 도움을 받아 해결했습니다.

docs: 안지완 프로필 업데이트 (opens in a new tab)

1. 왕초보반 dockerfile 만들어보기

• 나만의 웹 서비스를 만들고 도커파일을 통해 이미지를 빌드하고 컨테이너를 실행해보는 실습 진행
• 각자 원하는 프레임워크와 언어를 통해 서비스를 구축, 저는 Nest.js를 사용했습니다.

2. Nest.js 프레임워크 공부

• Nest.js 학습한 레포지토리 (opens in a new tab)
• 프론트 엔드밖에 몰랐기에 간단한 API 서비스를 만들기 위해 빠르게 학습

3. dockerfile 생성 후 PR

• 도커파일을 생성하여 image를 빌드해 서비스 정상작동까지 확인하고 PR을 올렸지만 github action의 빌드 테스트 실패
• --production 옵션을 제거하면 테스트에 통과하지만 image 최적화가 되지 않는 문제가 발생. 멘토님께 조언 요청

• 멘토님의 피드백을 기반으로 문제해결 시작

4. 트러블 슈팅

• dokerfile로 이미지 생성시에 크기를 줄이기 위해 node_modules를 production 환경만 설치하려고 했지만 github action을 통과하지 못함
• 수많은 삽질끝에 nest-cli라는 모듈이 nest build시에 필요한데 devdependency안에 들어가 있던걸 변경하고 나니 해결됐다. (멘토님이 힌트를 주셨지만 못알아듣고 삽질한건 비밀)
• 로컬에서 빌드가 문제없이 되어서 더 헷갈렸는데 이유는 내 맥북에 글로벌로 nest-cli가 설치되어 있었다..

5. 오픈소스 컨트리뷰터 활동 [UI: The position sticky on the workflow toolbar is not working]

• workflows-list의 checkbox 선택 시 나오는 toolbar 위치가 상단에 고정 되어 있지 않던 버그를 해결했다.
• 이슈 내용 보러가기 (opens in a new tab)
• PR 내용 보러가기 (opens in a new tab)

[before]

• 체크박스를 선택하고 스크롤 시 상단 툴바가 보이지 않는다.
• 기존에 있는 position : sticky가 적용되지 않는 문제를 position : fixed로 변경해 해결했다.

[after]

• 체크박스 선택 후 스크롤 시에 상단에 툴바를 고정하여 별도의 스크롤 없이 바로 해당 리스트에 대한 이벤트를 실행할 수 있다.

[UI - show history about completed runs in each cron workflow]

• 의정님이 찾은 좋은 개선 사항을 함께 진행 cron-workflows-detail 컴포넌트에서 해당 워크플로우의 히스토리를 볼 수 있게 리스트를 추가하는 이슈
• 이슈 내용 보러가기 (opens in a new tab)
• PR 내용 보러가기 (opens in a new tab)

[before]

• 기존 cron-workflows-detail 페이지에는 아무것도 없었지만

[after]

• 해당하는 cron-workflows에 히스토리 workflows와 히스토리가 없을 경우에 예시도 추가해줬다.
• 해당 PR은 아직 확인중인 상태

• 발대식 참여

• K8s 학습

  • Operator 개념 학습
  • Helm 학습
  • CNI 개념 학습
  • Service Mesh 개념 학습

• Argo Workflows 학습

  • 기본적인 사용법 학습
    • https://argoproj.github.io/argo-workflows/workflow-concepts/ (opens in a new tab)
    • https://www.youtube.com/watch?v=kxl6wYd5i2g (opens in a new tab)
  • 주변 기술 학습
    • DevContainer 학습
    • Nix 학습
    • https://nixos.org/manual/nixos/stable/ (opens in a new tab)
    • MinIO 학습
    • KeyCloak 학습

• Argo Workflows 컨트리뷰션 버그수정

  • DevContainer 오작동 관련 이슈작성 https://github.com/argoproj/argo-workflows/issues/11439 (opens in a new tab)
    • 컨테이너 재시작 시 /etc/hosts 엔트리 지워지는 문제
  • DevContainer 오작동 해결 PR 작성 및 머지 완료 https://github.com/argoproj/argo-workflows/pull/11440 (opens in a new tab)
    • devcontainer.json의 runArgs에 —add-host 옵션 추가하여 해결

• Argo Workflows 주변 기술 학습

  • 학습한 내용 토대로 NixOS 설치 및 사용
  • Argo CD, Argo Events, Argo Rollout 에 대해 조사
  • Keycloak 학습
    • Argo Workflows에서는 Keycloak 연동을 지원하고 있음, 이에 궁금증이 생겨 Keycloak에 대해 조사
    • OAuth2와 OIDC 차이점에 대해 학습
    • Keycloak 개념에 대해 학습
      • Role
      • Ream
      • Client
    • Keycloak 설정 방법에 대해 학습
    • Keycloak API 및 연동 방법에 대해 학습
    • Keycloak 공식 문서 학습
      • https://www.keycloak.org/docs/latest/securing_apps/index.html (opens in a new tab)
      • https://www.keycloak.org/docs-api/22.0.1/rest-api/index.html (opens in a new tab)
    • Keycloak 직접 설치 및 사용 실습

1. Git 사용법 & Commit & PR 규칙 숙지

• 컨트리 뷰션을 하기 위해 엄격한 Commit 과 Pull Request를 보내기 위한 기초적인 Git 사용법 숙지 및 Mission 수행

• 공식 Argo Workflow 프로젝트에서도 컨트리뷰션 하고 싶은 Issue에 대해 Issue Template 를 이용하고 PR 을 날리는 방식을 사용하고 있어 도움이 되었고 Issue Template 의 존재도 알게된 계기가 되었음.

• 향후 컨트리뷰션 부분에 꼭 필요한 요소들을 간접적으로 체험할 수 있는 기회

  • PR 의 네이밍 컨벤션 (opens in a new tab)
  • DCO 봇 Check (opens in a new tab)
  • GPG Commit (opens in a new tab)
  • Commit Message 컨벤션 (opens in a new tab)
  • 이슈와 PR을 연결 (opens in a new tab)

• Issue 생성 - 멤버 프로필 업데이트 - PR - Review - Merge 의 과정

  

2. 왕초보 특별반 참여 (Mentor 가 생성한 초보자들을 위한 과정)

• 왕초보 특별반 미션을 위한 Repo(container-playground) (opens in a new tab)

• Docker 혹은 Kubernetes 에 익숙하지 않은 인원 혹은 처음인 인원에 도움을 주는데 목적

• 멘토가 제시한 과제를 수행하면서 Docker Image 최적화의 필요성에 대해 학습

  • From 절 부터 Layer(층)별로 어떤 패키지, Static file 들을 쌓아가는 과정이기 때문에 Docker 이미지가 무거워져 성능 향상에 악영향을 미칠 수 있기 때문에 최적화는 필수임을 깨달음.

• Mission

  ❗️목표❗️
  
  나만의 웹서비스를 제작하고, 컨테이너화 할 수 있는 도커파일을 작성해 봅니다.
  
  과제 통과를 위해서 반드시 아래 사항을 준수해 주세요.
  
  • 디렉터리 및 파일 배치
      • 나만의 서비스를 반드시 본인 github 계정 디렉터리를 생성하고, 그 아래 작성해주세요.
      • 본인 디렉터리의 최상단에는 반드시 `Dockerfile` 이 위치해야 합니다.(이 조건을 달성하지 못하면 CI가 실패합니다.)
      • 본인 디렉터리 아래에 한해서, `Dockerfile`의 위치를 제외한 나머지 파일들은 자유롭게 작성해도 됩니다.
      • 단, 본인 디렉터리 최상단에서 `docker build -t [이미지명] .` 명령을 수행 했을때 성공적으로 이미지가 빌드 되어야 합니다.
  • 빌드 된 이미지의 동작
      • 나만의 웹서비스는 반드시 8080포트에서 동작해야 합니다.
      • 빌드 된 이미지는 별도의 파라미터 없이 `docker run -d -p [포워딩 포트번호]:8080 [이미지명]` 으로 실행 했을 때 문제 없이 서비스 되도록 만들어야 합니다.
  • 웹서비스 개발언어 및 서비스 구조
      • 본인이 선호하는 어떤 언어, 어떤 프레임워크를 활용해도 상관 없습니다.
      • UI, 디자인이 존재하지 않는 단순 api서비스를 제작해도 상관 없습니다.
      • 단, 필수 api를 두개 만들어야 합니다. (응답값은 신경쓰지 않습니다.)
          1. /api/v1/[본인 github계정]
          2. /healthcheck
  • (Optional) 도커 이미지 최적화를 하면 더 좋습니다. ([참고](https://thearchivelog.dev/article/optimize-docker-image/))
  • [키워드를 활용한 PR과 이슈 연결 방법](https://docs.github.com/ko/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword)을 참고하여 이슈와 PR을 연결해주세요. (수동연결 x)
  
  ❗️ 참고사항❗️
  
  •도커의 개념과 Dockerfile을 작성하기 위해 아래 문서를 참고 하면 좋아요.
  
      • [Dockerfile 작성 공식 문서](https://docs.docker.com/engine/reference/builder/)
      • [왕초보를 위한 도커 사용법](https://mysetting.io/slides/xxj85vnvey) (Docker Toolbox관련 내용은 deprecate된 내용)
  
  PR을 올리고 머지하기 위해 아래 사항들을 참고하면 좋아요.
  
      • Repo에 브랜치등을 생성하거나 Push할 수 있는 권한이 없으므로 fork 후 작업해야 해요.
      • [PR의 네이밍 컨벤션](https://flank.github.io/flank/pr_titles/)을 참고해주세요.
      • [DCO](https://github.com/apps/dco) 봇의 체크를 통과하기 위한 조건을 참고하여 커밋해주세요.
      • [GPG](https://www.44bits.io/ko/post/add-signing-key-to-git-commit-by-gpg)를 이용해 커밋하는 방법을 이해하여 서명된 커밋을 작성해주세요.
      • [커밋 메시지 컨벤션](https://www.conventionalcommits.org/en/v1.0.0/)도 적용할 수 있으면 좋아요. 꼭 따르지 않더라도, 너무 의미없는 커밋 메시지는 지양해주세요.(Optional)```
  

• 기존에 Python 기반의 Django 프레임워크를 다뤄본 경험이 있어 Django REST API를 생성하는 Docker FIle을 작성.

• PR을 날렸지만, 보안이슈 혹은 불필요한 패키지 import 구문 의 오류를 지적받음.

  

• Django 프로젝트의 settings.py (opens in a new tab) 코드에서는 SECRET_KEY 가 노출 된다는 것을 처음 알았으며 어떻게 이러한 보안 이슈를 해결할 수 있을까에 대해 고민해보는 시간을 가질 수 있었음.

  • Secret key 가 담긴 .json 파일을 생성하고 settings.py (opens in a new tab) 에서 json 파일을 참조하는 방향으로 진행하였다.
  • secret.json 파일은 Commit 에 올리지 못하므로 .gitignore 를 통해 json 파일을 무시하는 방법을 알게되었으며, dbsqlite3 같은 어떤 명령어 수행 후에 생성되는 불필요한 파일들도 무시할 수 있었음.
  • 로컬에서 개발한 결과물을 Git 프로젝트에 올리기 위해서는 여러 고려사항이 필요하다는 것을 깨달은 경험이었음.

• 몇가지 Review를 통과하고 PR이 Merge 될 수 있었음.

3. Argo Workflow Contributor

• Argo Workflow 를 이것저것 살펴보던 도중, Argo Workflow - Contact - Help 필드에서 Deprecated 된 Argo Workflow Slack 채널을 보게되었음. 사소한 UI Issue 라고 생각했지만, UI가 어떤 언어로 보여주며, 어떤 방식으로 개발되었는지 확인할 수 있는 기회라고 생각하여 Issue 를 올리고 PR을 제출.

  

• 생성한 Issue

  UI: non-existent Slack Workspace link on help page Issue (opens in a new tab)

  

  • 이슈를 생성하니 Argo 프로젝트의 Maintainer 분이 금방 코멘트를 남겨주셨음.

  • 임의로 CNCF Argo Channel 링크로 Fix 하려 하였으나, 메인테이너분이 다른 링크로 Update 해달라는 코멘트를 받음.

• 생성한 PR

  fix: deprecated Link(Help-Contact) Issue (opens in a new tab)

  

  • Argo Workflow 는 React 기반으로 UI가 구성되어 있었고, 컴포넌트별로 디렉토리가 정렬되어 있어 쉽게 코드를 분석할 수 있었음.
  • Issue 가 있던 Code 부분 (opens in a new tab)

• 실수로 Commit 중에 Signed-off 옵션을 생략해서 DCO 봇 TEST에 통과 못했지만, GIt 에서 이전 커밋을 되돌리거나(Rebase), 여러 불필요한 커밋을 하나로 합치는(Squash) 기능을 알게되었고 이전 커밋을 돌려 git commit -S -s -m "Commit Message" 커밋하였음.

  • ‘LGTM’ 코멘트가 무슨뜻인가 찾아보았는데 구글에서는 LGTM이라는 태그를 달아 의사를 표현하는데 Looks Good To Me. 즉, 좋아 보인다는 뜻이라고 하여 뿌듯한 경험이었음.
  • 버그를 찾아내거나 UI를 수정하는 등의 과정도 중요하지만, 가장 중요한 것은 Argo Workflow 생태계가 정한 규칙대로 컨트리뷰션을 수행하는 과정도 중요하다고 생각한다.

4. Argo Workflow Hackerton 참여 (Argo workflow - OSSCA 팀내에서 개최한 해커톤)

• Pull Request(Merged) : feat: Search by name for WorkflowTemplates in UI (opens in a new tab)

• Issue : Search by name for WorkflowTemplates in UI (opens in a new tab)

• 이슈 해커톤 활동 기간

  • 1차 해커톤 (해커톤 C조) : 23.08.16 - 23.08.20
  • 2차 해커톤 (해커톤 C조) : 23.08.20 - 23.08.27

• 이슈 내용

  • 클러스터에 많은 수의 템플릿이 있는 경우 이름으로 검색하는 것이 좋지만, 검색기능이 없어 모든 템플릿을 스크롤하는 것은 항상 불편하다는 이슈
  • Argo Workflow UI 에서 워크플로우 템플릿의 결과를 이름별로 필터링하는 기능이 필요하다고 생각되어서 조끼리 회의한 결과로 이슈를 채택.

• 역할

  • Front-End 담당
    • Argo workflow Template UI 의 검색 필드(Bar) 생성
    • .get 로직을 분석하여 Name Pattern(Like 검색)을 어디로 넘겨주는지 분석
    • workflow-template 컴포넌트 디렉토리의 workflow-template-filter.tsx, workflow-template-list.tsx 수정

• 회의 내용

  • 회의는 Slack 해커톤 채널을 통해 조끼리 매일 의견과 정보를 공유
  • 1차 논의 내용

  1. name 검색 기능 (backend)
  
      • WorkflowTemplate 페이지
      • name 검색 추가(LIKE 검색)
      • ClusterWorkflowTemplate 페이지
      • name 검색 추가(LIKE 검색)
      • CronWorkflow 페이지
      • name 검색 추가(LIKE 검색)
  
  
  
  2. name 검색 기능 (frontend)
  
      • WorkflowTemplate 페이지
      • name 검색 ui 추가
      • ClusterWorkflowTemplate 페이지
      • 검색 사이드 바 추가 (name, label)
      • CronWorkflow 페이지
      • name 검색 ui 추가
  
  3. 페이지네이션 (frontend)
  
      • WorkflowTemplate 페이지
      • name 기준 pagination
      • ClusterWorkflowTemplate 페이지
      • pagination 추가
      • CronWorkflow 페이지
      • pagination 추가
  
  4. 테스트 코드 작성
  
      - name 검색 (LIKE 검색)
      - 어떤 테스트 코드 작성해야하는지 더 분석 필요
  • 2차 논의 내용

    • 1차 오프라인 회의

      

  1. 공동 커밋 방법
  
      • https://github.com/ArgoWorkflows-OSS/argo-workflows 레파지토리를 로컬에 클론받는다.
      • 해당 레파지토리에 우리 팀이 작업할 브랜치를 생성한다. (`master` vs `release-3.4.10`)
      • 해당 레파지토리의 해당 브랜치에서 각자 담당한 기능을 작업한다. (PR올리기 위한 커밋 규칙을 잘 지켜서 커밋한다.)
      • 모두의 작업이 완료되면 3명중 1명이 PR 템플릿에 맞게 PR을 날리기
      • 3명 모두가 컨트리뷰터가 될 수 있음
  
  2. 해커톤이고 정해진 기간이 있기 때문에 일단 workflow-template, cluster-workflow, cron-workflow 중 먼저 메인이라고 생각되는 workflow-template name filter 를 먼저 구현해보고 PR을 날려 메인테이너가 Merge 해주면 다음으로 넘어가기로 결정
  
      • 파트별 임무
  
      • 백엔드
  
          • workflow_template_server.go
              • 이름 필터링 및 페이지네이션 재계산
  
      • 프론트 :
  
          • workfflow-template-filter.tsx
              • Name 검색 UI 추가
              • Name 인자 수신 및 필터링
          • workflow-template-list.tsx
              • Name state 추가
              • userEffect list 에 name 전달
          • workflow-template.tsx, Utils.tsx
              • Name 인자 전달

  • 3차 논의 내용

    • 2차 오프라인 회의

      

       1. 오프라인 미팅 회의 내용
    
           • namespace 없는 경우도 필터 시 포함해야 할 것 같다는 의견. (namespace 없애자고 말 할 근거 부족 - 타 사이트(쿠버네티스 대시보드, 오픈시프트, 아르고씨디 등)들도 namespace 없는 경우 제공)
           • continue에서 사용하고 있는 로직을 가져와 적용가능한지와 커스텀한 결과에서도 continue를 그대로 유지할 수 있는지에 대한 생각
           • 수요일 밤까지 continue 로직 분석 후, continue를 사용하여 페이지네이션이 불가능 하다고 결론이 날 경우 이슈 코멘트에 질문 업로드
           • 프론트단 페이지네이션(데이터 리로드 안됨, argocd에서 사용중인 방식) vs 서버단 페이지네이션(매번 전체 리스트 조회 후 페이지네이션, 부하 괜찮을지)
           • 서버사이드 캐싱 구현할 경우 저장할 곳이 있는지
    
    
    
       2. 페이지 넘길때마다 매번 네임스페이스, 라벨만 적용해서 k8s 전체검색 하는걸로 결정
    
       3. offset 기반 페이지네이션 방법**에서 로직 추가로 구현
           • 안됐던 부분
               • next page 버튼 클릭 후 필터링 검색했을 경우, 있는 검색 결과더라도 아무 데이터도 나오지 않는다.
               • next page 버튼 클릭 후 페이지네이션 갯수 늘리면, 검색결과가 제대로 보이지 않는다.
           • 변경된 부분
               • continue 값을 서버에서 갱신해주다보니, 페이지 갯수를 늘리거나/필터링을 걸었을 때 서버에 이미 세팅된 continue값을 기준으로 페이지네이션을 해서 문제 존재,
                 continue 값을 프론트에서 넘겨주도록 변경하는 방식을 채택(페이지 갯수 늘리거나/필터링을 걸었을 때 continue를 다시 0으로 세팅)
    
    
    
       4. 페이지네이션 테스트
           • workflow_template_server_test.go 통과
           • (workflow template 14개 등록)
           • UI workflow template 첫 페이지 정상
           • workflow template 페이지 limit 5, 10, 50 일 때 정상
           • workflow template 페이지 1 페이지에서 workflow template 추가 후 2페이지 이동
           • workflow template 페이지 1 페이지에서 workflow template 삭제 후 2페이지 이동
           • 위 내용을 `name pattern` 필터링 검색으로 테스트
           • name pattern 없이 검색 후 name pattern 추가하여 재검색
           • name pattern 포함 검색 후 name pattern 삭제 후 재검색
    
       5. PR 생성

  • Like 필터(Name Pattern) 구현

    • 예) sp로 시작하는 workflow-template 검색가능

      

  • 결과

    

    • 구현은 성공이였으며, 이후에는 이전에 논의했던 cluster-template, cron-template 컴포넌트들을 수정할 예정

5. 컨트리뷰션 활동 외 학습

• Google Kubernetes Study Jam 교육 수료
• Badge (opens in a new tab)
• Architecting with Google Kubernetes Engine: Foundations(Earned 7월 18, 2023 EDT)
• Architecting with Google Kubernetes Engine: Workloads(Earned 7월 26, 2023 EDT)
• Architecting with Google Kubernetes Engine: Production(Earned 8월 4, 2023 EDT)
• 정리한 내용은 개인 블로그(velog)에 기록 euijoo's Velog GCP Series (opens in a new tab)

✅ Contribution 관련 블로그 기록

시리즈 | 2023 OSSCA - ddubi.log (opens in a new tab)

✅ 다양한 과제 수행

1. Github에서 issue/commit/PR 미션 수행

   [과제 요약]

   

   • 멤버 프로필 업데이트 이슈를 선택하고 해당 repo를 나의 repo에 fork한 후 나의 repo에서 users.md 와 [이름].md를 docs/user아래에 추가한다. 그 후 이슈를 연결해서 PR을 올리고 commit 하는 과제

   [과제 결과]

   docs : 전의정 프로필 업데이트 by juijeong8324 · Pull Request #19 · ArgoWorkflows-OSS/ArgoWorkflows-OSS (opens in a new tab)

   Github에서 issue/commit/PR (opens in a new tab)

1. Running Locally

   [과제 요약]

   • Argo Workflows를 local 환경에서 실행시키는 과제
   • Windows 환경에서 wsl2를 설치한 후 devcontainer cli를 이용하여 argo workflows 실행

   [과제 결과]

   Argo Workflows 로컬에서 실행하기 (opens in a new tab)

   Argo Workflows 로컬에서 실행하기 - 재도전 (opens in a new tab)

   Argo Workflows 로컬에서 실행하기 - 파이널 (opens in a new tab)

   Argo Workflows 로컬에서 실행하기 - 최종 정리 (opens in a new tab)

3. 왕초보 특별반 - 나만의 서비스 컨테이너 이미지 제작

   

   [과제 요약]

   • 왕초보 특별반은 Argo-worfklows 팀 내에서 컨테이너, 쿠버네티스, argo에 대해 잘 모르고 있는 뉴비들(It's me...)을 위한 특별반이다.
   • 나만의 웹서비스를 제작하고 이를 컨테이너화 할 수 있는 Dockerfile을 작성하는 과제
   • Dockerfile, docker, image, container와 관련된 개념을 이해하고 있어야 함
   • 본인은 node.js, express 환경에서 웹서버 구축 후 dockerfile 작성

   [과제 결과]

   과제 관련 코드 (opens in a new tab)

   왕초보 특별반 - 1. 나만의 서비스 컨테이너 이미지 제작 (opens in a new tab)

   [Docker] Dockerfile 기본 명령어에 대해 알아보자 (opens in a new tab)

✅ 오프라인 참석

✅ Issue 탐색 및 Issue 생성

• Issue #11131 (opens in a new tab) 버그수정

  [이슈 요약]

  workflow input parameter 안의 "가 escape 되지 않아 workflow.parameter.json으로 참조할 때 에러 발생

  [결과]

  Argo workflows 상의 문제가 아닌 파이썬 환경의 문제이기 때문에 해당 이슈는 기각

  Blog : Argo Workflows - Issue #11131 (opens in a new tab)

• Issue #11706 (opens in a new tab) UI 개선

  [이슈 요약]

  cron workflow 탭에서 각 workflow의 history를 확인할 수 있는 UI를 추가했으면 좋겠다는 이슈

  Blog : Argo Workflows - Issue #11706 (인생 처음으로 올린 감격적인 나의 소중한 Issue) (opens in a new tab)

  [결과]

  PR #11811 (opens in a new tab) Closes

✅ PR open & merge

• PR #11732 (opens in a new tab) 문서기여 PR Merge

  [PR 요약]

  Argo Workflows 공식문서에서 Artifact Visualization에 존재하는 이미지가 유뷰트 영상 링크임을 잘 보여줄 수 있게 이미지를 수정하는 PR

  

  [결과]

  Argo Workflows - PR #11732 docs: Add description about img in artifact-visualization.md (opens in a new tab)

  위와 같이 이미지 가운데에 유튜브 재생 버튼을 추가한 이미지로 대체

  merge 완료

• PR #11811 (opens in a new tab) UI개선 PR Open

  [PR 요약]

  Issue #11706 (opens in a new tab) 을 해결하고자 한 PR

  cron workflows page에서 특정 cron-workflow를 클릭했을 때 실행된 cron-workflow를 확인할 수 있게 수정

  실행된 cron-workflow를 찾을 수 없는 경우 위와 같은 안내 사항을 표시

  [결과]

  Merge 완료

1. git/github 사용법 익히기 issue: https://github.com/ArgoWorkflows-OSS/argoworkflows-oss.github.io/issues/11 (opens in a new tab)
   pr: https://github.com/ArgoWorkflows-OSS/argoworkflows-oss.github.io/pull/15 (opens in a new tab)
   요약: opensource 생태계에서 code 형상 관리 핵심인 git/github와 친해지기 위한 작업
   상세내용:
   opensource의 상당수들은 git과 github를 이용해 협업을 하고 있습니다.
   그렇기에 opensource에 기여하기 위해서는 필연적으로 git/github와 친해져야합니다.
   git/github를 사용 issue 발행, commit 규칙 준수, pr 생성등 다양한것들을 직접해보는 활동이었습니다.

2. feat: logging for client-side throttling

   issue: #11387 (opens in a new tab), #11402 (opens in a new tab)
   pr: #11437 (opens in a new tab)
   요약: user가 특정 옵션을 잘못 설정한 경우 더 빠르게 파악 할 수 있도록 수정
   상세내용:
   kubernetes와의 통신을 위해 client-go라는 라이브러리를 사용합니다.
   해당 라이브러리에서는 request limit을 위해 --qps, —burst옵션을 제공합니다.
   이 옵션을 매우 낮게 설정한 경우 throttling이 발생하게 됩니다.
   그렇기에 사용자에게 좀 더 빠르게 알려주기 위해 별도의 log level 을 부여하게 되었습니다.
   해당 이슈를 해결하는 과정에서 client-go에 대해 많이 학습하게 되었습니다.
   특히 제일 유익했던 부분은 RoundTrip이었습니다.
   golang에서 제공하는 http request interface를 지키는 모든 객체에 대해 RoundTrip 을 이용해 미들웨어를 추가 할 수 있다는것을 배웠을땐 정말 충격이었습니다.

3. go 1.21 upgrade

   issue: #11566 (opens in a new tab)
   pr: #11601 (opens in a new tab)
   요약: golang 1.21 ver release에 따른 version upgrade 진행
   상세내용: 리드멘티로서 이슈를 제가 해결하는것보단 아직 기여하지 못한 팀원이 시도해보면 좋을거라고 판단했습니다.

   

   해당 이슈를 팀원에게 공유했고, 팀원이 성공적으로 이슈를 해결 할 수 있도록 서포트 하게 되었습니다. 주 1회 정기적인 모임에서 해당 이슈의 접근 방법을 공유하였습니다.

   

   평일의 경우엔 slack 채널에서 따로 질문을 받고 답변하는 식으로 모든 팀원이 PR을 제출하는 경험을 얻을 수 있도록 했습니다.

   

   팀원도 PR을 Merge하는 아주 소중한 경험을 얻게 되었습니다.

4. Debugging 설정

   요약: 팀원의 argo-workflow debugging setting
   상세내용:
   golang으로 개발을 처음하는 팀원을 위해 debugging 환경 설정에 어려움이 있었고, 이를 같이 해결하기위해 노력했습니다.

   

   이 과정에서 저 역시 kubernetes와 밀접한 app의 debugging 설정을 잘하지 못한다는것을 깨닫게 되었고, 해당 부분에 대해 여러 사람들에게 도움을 받아야겠다는 생각을 하게 되었습니다.

다양한 과제 수행

• Github Issue/Commit/PR 미션 수행
  • 대형 오픈소스에 컨트리뷰트하기 위한 깃허브 사용 방법 숙지
  • https://github.com/ArgoWorkflows-OSS/argoworkflows-oss.github.io/issues/43 (opens in a new tab)
  • https://github.com/ArgoWorkflows-OSS/argoworkflows-oss.github.io/pull/44 (opens in a new tab)
• Argo Workflow Running Locally
  • Argo Workflow를 Local 환경에서 실행시키는 과제
  • Argo Workflow의 구조, DevContainer, 컨테이너 기반 애플리케이션, Makefile 구조 이해
• 나만의 서비스 컨테이너 이미지 제작
  • Docker File 명령어, 레이어 구조, 최적화, 캐싱 등 성능 개선
  • https://github.com/ArgoWorkflows-OSS/container-playground/pull/16 (opens in a new tab)
  • https://github.com/ArgoWorkflows-OSS/container-playground/pull/23 (opens in a new tab)

이슈 분석

• 매트릭 이슈 분석
  • Github Reaction이 많은 이슈로 많은 사용자들이 개선을 필요로 하는 이슈 분석
    • 매트릭 Label의 추가하여, 모니터링 편의성 증대
  • 이슈 분석 결과, 해당 내용을 개발했을 때 또 다른 문제를 야기할 수 있다는 것을 발견
    • 매트릭 Label을 추가할 경우, 많은 양의 메트릭이 수집되어 기존 사용자들에게 많은 양의 메트릭 트래픽이 유입되어 성능 문제가 생길 수 있다.
  • 우회하여 해결할 수 있는 방법을 제시하고 소통함
    • 커스텀 매트릭을 활용할 경우 이슈에서 요구했던 모니터링이 가능함을 확인하여, 우회하여 해결할 수 있는 방법 제시
    • https://github.com/argoproj/argo-workflows/issues/9849#issuecomment-1685227337 (opens in a new tab)
• 추후 개선을 위해 남겨놓은 주석에 모호한 부분이 있어 문의
  • https://github.com/argoproj/argo-workflows/pull/8486#discussion_r1306700745 (opens in a new tab)
• 이슈 해커톤으로 이슈 분석

컨트리뷰트

• (리팩토링) 잘못된 함수 이름, 변수명 등 수정
  • 다른 개발자에게 혼란을 야기할 수 있는 부분을 수정했음
  • https://github.com/argoproj/argo-workflows/pull/11604 (opens in a new tab)
  • https://github.com/argoproj/argo-workflows/pull/11633 (opens in a new tab)
  • https://github.com/argoproj/argo-workflows/pull/11687 (opens in a new tab)

1. Cron workflow can not apply volumeClaimTemplates config from argo controller config map (workflowDefaults)

Issue #11344 (opens in a new tab) PR #11662 (opens in a new tab)

이슈 분석

이 이슈를 이해하기 위해서는 먼저 Default Workflows (opens in a new tab)가 무엇인지를 알아야 했습니다.

argo workflows controller configmap에 workflowDefaults 라는 필드는 넣어 워크플로에 대한 기본값을 설정할 수 있으며, 워크플로에 이미 해당 필드값이 있을 경우에는 워크플로 값이 우선된다는 것을 알게되었습니다.

예를 들어 configmap을 다음과 같이 설정한 뒤에 Workflows를 생성하면

# This file describes the config settings available in the workflow controller configmap
apiVersion: v1
kind: ConfigMap
metadata:
  name: workflow-controller-configmap
data:
  # Default values that will apply to all Workflows from this controller, unless overridden on the Workflow-level
  workflowDefaults: |
    metadata:
      annotations:
        argo: workflows
      labels:
        foo: bar
    spec:
      ttlStrategy:
        secondsAfterSuccess: 5
      parallelism: 3

자동으로 workflowDefaults 필드에 설정해준 대로 Workflows가 아래와 같이 생성됩니다.

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: gc-ttl-
  annotations:
    argo: workflows
  labels:
    foo: bar
spec:
  ttlStrategy:
    secondsAfterSuccess: 5 # Time to live after workflow is successful
  parallelism: 3

해당 이슈는 workflowDefaults에 volumeClaimTemplates 값을 넣으면, CronWorflows/Workflows 생성 시 에러가 발생한다는 이슈였습니다.

does not contain declared merge key: name 라는 에러메세지가 발생하는 것을 확인했습니다.

코드를 확인해보니 StrategicMergePatch 함수에서 에러가 발생했고 이는 쿠버네티스의 patch 전략과 관계가 있었습니다.

VolumeClaimTemplates []apiv1.PersistentVolumeClaim `json:"volumeClaimTemplates,omitempty" patchStrategy:"merge" patchMergeKey:"name" protobuf:"bytes,6,opt,name=volumeClaimTemplates"`

Workflows에서 정의되어있는 타입인 VolumeClaimTemplates는 patchMergeKey로 name을 사용하도록 정의되어있었습니다.

그러나 아래 PersistentVolumeClaim타입을 확인해보면 name은 존재하지 않습니다. 즉, 구조체에 정의되어있지 않은 값을 patchMergeKey로 정의해두어서 발생하는 문제였습니다.

type PersistentVolumeClaim struct {
	metav1.TypeMeta `json:",inline"`
	// Standard object's metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
 
	// spec defines the desired characteristics of a volume requested by a pod author.
	// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
	// +optional
	Spec PersistentVolumeClaimSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"`
 
	// status represents the current information/status of a persistent volume claim.
	// Read-only.
	// More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims
	// +optional
	Status PersistentVolumeClaimStatus `json:"status,omitempty" protobuf:"bytes,3,opt,name=status"`
}

이슈 해결

VolumeClaimTemplates에서 patchMergeKey를 제거하도록 해당 이슈를 수정하였습니다.

그러나 VolumeClaimTemplates에 patchMergeKey가 붙은 이유는 Volume과 같은 컨벤션을 사용하고 있어서 였습니다.

해당 이슈는 이처럼 정책과 관련되어있기 때문에 더 많은 의논이 필요한 상황입니다.

ArgoWorkflows 프로젝트에 처음으로 올린 PR이었고 꽤나 많은 사람들이 불편해하고 있는 이슈의 원인을 찾아낼 수 있어서 기뻤습니다.

2. Search by name for WorkflowTemplates in UI

Issue #11004 (opens in a new tab) PR #11684 (opens in a new tab)

이슈 분석

이번 이슈는 3명으로 팀을 짜서 작업을 진행했습니다.

WorkflowTemplates는 '이름'을 기준으로 검색하는 기능이 존재하지 않아 특정 WorkflowTemplates을 찾기 위해서는 label을 기준으로만 찾을 수 있었습니다.

그래서 많은 사용자들은 불편함을 느끼고 있었으며 '이름'을 기준으로 찾을 수 있는 기능을 제공해줬으면 좋겠다는 '기능 개선' 관련 이슈였습니다.

이슈 해결

쿠버네티스 API를 통해 조회된 WorkflowTemplates의 결과를 '이름'을 기준으로 필터링하는 로직을 추가적으로 넣어 해당 기능을 구현하였습니다.

그러나 한가지 이슈가 존재했습니다.

기존 페이지네이션은 쿠버네티스 자체 continue 값을 이용해 구현되어있어서 쿠버네티스 결과를 이처럼 커스텀하게 조작할 경우 쿠버네티스 페이지네이션을 사용할 수 없었습니다.

이를 어떻게 해결해야 할까 고민이 많았지만 쿠버네티스의 resourceVersion을 이용하여 커서 페이지네이션을 하도록 구현하는 로직을 적용함으로써 해당 문제를 해결하였습니다.

혼자가 아니라 여럿이 의논하며 할 수 있어서 너무 재미있었습니다.

또한 ArgoWorkflows 프로젝트에 정말 필요한 기능을 제공했다고 생각하여 기분이 좋았습니다.

3. A problem that is not initialized when changing the number of page limits

Issue #11702 (opens in a new tab) PR #11703 (opens in a new tab)

이슈 분석

Search by name for WorkflowTemplates in UI 이슈를 해결하면서 새로운 페이지네이션 버그를 발견하였습니다.

페이지 갯수를 변경할 때 페이지네이션을 위해 사용하는 continue 값을 UI에서 초기화 시켜주지 않아서 데이터가 제대로 보이지 않는 문제였습니다.

이슈 해결

UI 코드에서 페이지 갯수 변경이 감지될 때 offset을 초기화 하도록 간단하게 로직을 수정하여 문제를 해결할 수 있었습니다.

단 한줄의 코드 수정이었으나 이 한 줄로 인해 꽤나 불편함을 주었던 문제를 해결할 수 있었습니다.

4. Pagination may not work correctly for archived workflows

이슈 분석

Issue #11715 (opens in a new tab) PR #11761 (opens in a new tab)

Maintainer @terrytangyuan 님께서 직접 Slack으로 연락을 주신 이슈입니다.

좋아하는 연예인에게 연락받은 기분이라 너무 기분이 좋아서 날아갈 뻔 했습니다. 기쁘고 들뜨는 마음을 누르고 이슈를 분석해보았습니다.

Workflows와 ArchivedWorkflows가 이전에는 다른 페이지로 분리되어있었지만 master 버전부터 Workflows와 ArchivedWorkflows를 하나의 페이지로 합치고 ArchivedWorkflows가 존재한다면 같이 보여주도록 로직이 수정되었습니다.

그러나 Workflows와 ArchivedWorkflows가 하나로 합쳐지면서 페이지네이션에서 문제가 발생했습니다.

두 개의 리소스는 서로 전혀 다른 페이지네이션을 사용하도 있었습니다. Workflows는 쿠버네티스 자체 페이지네이션인 continue값을 사용하고 있었고, ArchivedWorkflows는 자체적으로 데이터베이스를 사용하기 때문에 데이터베이스를 이용하여 offset 방식으로 페이지네이션을 하고 있었습니다.

그러나 ArchivedWorkflows에 Workflows에서 사용하는 continue값을 그대로 전달하면서 ArchivedWorkflows가 아예 조회되지 않는 문제가 발생했습니다.

이슈 해결

Search by name for WorkflowTemplates in UI 이슈를 해결하면서 구현했던 페이지네이션 로직을 참고하여 해당 이슈를 해결할 수 있었습니다.

두 리소스는 다른 방법의 페이지네이션을 사용할 수 밖에 없기 때문에 두 개의 리소스를 합치기 전에 페이지네이션을 사용하는 것이 아닌, 일단 전체 리소스를 조회하여 두 리소스를 합친 후에 마지막으로 페이지네이션 로직을 적용하는 방법을 사용하였습니다.

ArchivedWorkflows가 조회되지 않는 문제를 해결할 수 있었으나 페이지를 변경할 때마다 전체 리스트를 가져와 합치기까지 하는 것이 성능상 걱정이 되는 부분이라 성능 테스트를 할 수 있는 방법을 고민해볼 생각입니다.

성능테스트를 해본 뒤 아니다싶으면 프론트에서 페이지네이션을 하는 방식으로 변경해볼 생각입니다.

크리티컬한 이슈를 해결할 수 있어서 너무 좋았고 ArgoWorkflows 프로젝트에 컨트리뷰터로써 제대로 기여를 하고 있다는 생각이 들어 뿌듯하고 재밌었습니다.

5. Relocation of Commit Guidelines Information in the Documentation

Issue #11700 (opens in a new tab) PR #11701 (opens in a new tab)

이슈 분석

ArgoWorkflows 프로젝트에는 컨트리뷰션을 시도하는 개발자들을 위한 리드미 문서가 있습니다.

하지만 그곳에는 커밋에 관한 가이드라인이 따로 언급되어있지 않습니다.

GeunSam2 멘토님께서 본인이 처음 기여를 시도하려고 했을 때 커밋에 대한 가이드라인을 찾는데 너무 오래 걸려서 불편했다고 말해주셨습니다.

이슈 해결

이 불편사항을 들은 후 컨트리뷰션 리드미에 커밋에 대한 가이드라인의 링크를 걸어주도록 수정함으로써 ArgoWorkflows에 기여하고자 하는 개발자들이 편하게 기여할 수 있도록 하였습니다.

이 PR에서는 메인테이너가 코드 제안을 해주었는데 코드 제안 기능을 처음 접해보아서 흥미롭고 재밌었습니다.