인포팀 서비스를 사용하는 분들이라면 인포팀 계정 서비스를 이용해보셨을겁니다.
얼마전만 하더라도 인포팀 계정 서비스는
GIST 이메일로 로그인, 그 이전에는 IdP 라는 이름을 가지고 있었습니다.
처음에 지어진 IdP 는 Identification Provider의 약자이긴 하지만, 비개발자에게는 친숙한 단어가 아닐뿐더러 인포팀 개발자들에게조차 익숙하지 않은 이름을 가지고 있었습니다.
이전에 IdP 라는 이름을 사용하고 있을 때에는 서비스 내부적으로만 표시되는 문구를 GIST 이메일로 로그인 이라는 명칭을 사용하도록 가이드 했었습니다. 하지만 코드 상으로나, 이후에 온보딩을 하게 될 때에 겪는 불편함을 고칠 필요가 있었습니다.때문에 서비스명을 변경하고자 하는 의견을 제기하였고, 곧바로 심층 논의에 들어갔습니다.
여러가지 명칭을 고민하였고, 도메인이 우선
account.gistory.me 로 결정 되었습니다.
그리고서 본격적인 작업에 착수하였습니다.
해야할 일들
서비스명을 변경하기 위해서는 여러가지 할 일이 있습니다.
코드, 인프라 상으로도 기존의
idp 흔적을 모두 지우기 위해서는 해야할 것이 많습니다.- package.json, README.md 수정
- 노션, 피그마 정보 수정
- 개인정보처리방침, 이용약관 수정
- 수정된 내용 고지
이중에서 기술적으로 해볼법한 이야기들을 해보도록 하겠습니다.
개인정보처리방침, 이용약관 수정
인포팀에서는 개인정보처리방침을 포함한 약관들을 모두 레포지토리를 통해서 관리하고 있습니다.
hugo를 사용해서 정적 배포가 되기 때문에 markdown을 사용하여서 각 약관의 내용을 관리하고 있으며, 공고일자를 파일명으로 지정하여서 이전의 약관도 확인할 수 있도록 되어있습니다.
더 자세한 내용은 다른 블로그 글을 통해서 다루도록 하겠습니다.
오래되어서 수정이 필요한 내용과 서비스명을 바꾸는 것을 주로 진행했습니다.
수정된 내용을 고지하기 위한 방법은 추후에 블로그 글로 다뤄보겠습니다.
BE 도메인, CORS 설정 변경
BE의 도메인이나 CORS 설정을 변경하는 것은 쉽습니다.
이전 블로그글에도 자주 언급 되었듯이 인포팀은 terraform을 사용해서 인프라를 관리하고 있습니다.
module "dns" { // ... main_domains = [ // ... "api.idp", "api.account", ] }
우선 새로운 도메인이 서버를 향하도록 설정합니다.
module "image_s3" { // ... for_each = { // ... "gsainfoteam-icarus-account" = ["https://account.gistory.me", "https://idp.gistory.me"], } bucket_name = each.key allowed_origins = each.value }
또한 S3의 이름은 변경이 불가능하기 때문에 새로운 S3를 생성해줍니다.
그리고 aws cli를 사용해서 기존의 파일을 옮겨줍니다
aws s3 mv --recursive s3://gsainfoteam-icarus-idp s3://gsainfoteam-icarus-account
이외에도 kubernetes ingress 정보를 변경하여야 합니다.
기존의 도메인도 살려두기 위해 기존 ingress와는 별도로 ingress를 만듭니다.
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: account-prod-ingress namespace: infoteam spec: ingressClassName: traefik rules: - host: api.account.gistory.me // ... --- // ... spec: rules: - host: api.idp.gistory.me // ...
Passkey 정보 수정
패스키를 통한 인포팀 계정 로그인 에서 볼 수 있다시피 인포팀 계정은 패스키를 사용하고 있습니다.
패스키에는 그 패스키가 발급된 곳의 정보를 나타내는
rpId 라는 값이 있는데, 이것이 이전 도메인인 idp.gistory.me 를 가리키고 있기 때문에 account.gistory.me 로 바꿔주어야 합니다.하지만 문제는 이렇게
rpId가 바뀌면 기존의 패스키를 사용할 수 없다는 것입니다.그래서 기존 패스키 사용자에게 패스키 재등록을 요청드려야 했습니다.
kubernetes 리소스명 변경
Kubernetes의 리소스명 변경은 상대적으로 쉽습니다
다만 Kubernetes의 리소스 이름은 전부 변동이 불가능하기 때문에 기존 리소스를 삭제하고 다시 만들게 됩니다
뿐만 아니라 인포팀에서는 GitOps를 위해서 ArgoCD를 사용하기 때문에 ArgoCD application도 삭제 후 다시 생성해야 했습니다
FE 도메인 변경
프론트엔드 자체의 도메인을 바꾸는 것은 어렵지 않습니다.
인포팀에서는 프론트엔드의 정적 서빙을 위해 Cloudflare Pages를 사용하고 있는데, 새로운 Worker Project를 생성한 다음에 해당 프로젝트를 GitHub와 연동합니다.
또한 Production 배포는 GitHub Actions가 직접 Cloudflare Pages로 배포하고 있기 때문에 여기에도 관련된 값 (프로젝트 id)을 변경해줍니다.
또한 프론트엔드에서 바라보고 있는 백엔드 주소도 같이 바꾸어줍니다
여기에서 중요한 것은 인포팀 계정을 사용하고 있는 서비스들에서 업데이트가 늦어지는 경우에는 기존의 FE 주소를 계속 사용할 수도 있기 때문에 계속 기존의 FE로도 업데이트를 해주어야 합니다.
메일 템플릿 변경
메일 템플릿에 있는 문구를 변경하면서 react.email을 사용하도록 변경했습니다.
2025년 11월 말부터 나온 이야기가 2026년 2월 초가 되어서 끝나게 되었습니다.
정리해보면 간단하지만 2달이 넘는 생각보다 오랜 시간이 걸렸습니다.
처음에 서비스명을 정할 때 잘 정해야겠다는 생각을 하게 되는 작업이었습니다.