Gitea 세팅 후 계정 접근 실패

흑두루미·2026년 5월 21일

Gitea 세팅 후 계정 접근 실패

🔍원인

Gitea 초기 세팅 완료 후 admin 계정으로 접근 시 비밀번호 접근 실패

  1. Gitea Pod 내부 접속하여 비밀번호 변경 시도
kubectl exec -it <gitea-pod-name> -- /bin/bash
gitea admin user change-password -u admin -p "새로운비밀번호"

Command error: user does not exist [uid: 0, name: admin]
  • admin 계정이 존재하지 않아 비밀번호 변경 실패

  1. 애초 admin 계정이 생성되지 않음

📝결과

  1. CLI를 통해 관리자 계정 직접 생성
gitea admin user create --admin --username admin --password "1234" --email "admin@example.com"
  • CLI를 통해 admin 계정 생성하여 접근 성공 확인

  1. 근본적인 에러발생 이유
    values.yaml 생성 시 Password 설정 오류
#수정 전
admin:
  username: admin
  password: 1234

#수정 후
admin:
  username: admin
  password: "1234"
  • Gitea 초기화 스크립트의 특징 (실패 시 재시도 안 함)
    Gitea Pod가 처음 뜰 때 실행되는 내부 로직은 대략 다음과 같은 순서로 동작

1) 데이터베이스(SQLite) 파일 생성 및 기본 테이블 구조(스키마) 생성 ➔ (성공)

2) values.yaml에 적힌 정보를 바탕으로 admin 유저 생성 명령어 실행 ➔ (문자열/형식 오류로 인해 실패)

3) 여기서 중요한 점은 유저 생성 명령어가 실패하더라도 전체 시스템이 멈추지 않고 다음 단계(Gitea 웹 서버 실행)로 그냥 넘어감
게다가 1번 단계에서 DB 파일이 이미 만들어졌기 때문에 Gitea는 시스템이 '이미 완전히 초기화되었다'고 판단

  • 결론적으로 발생한 상황
    DB는 만들어졌지만 관리자 계정은 없는 상태

Gitea는 첫 구동 때만 이 자동 생성을 시도하므로 이후에 Pod를 껐다 켜거나 values.yaml을 수정해서 배포해도 이미 DB가 존재하기 때문에 두 번 다시 values.yaml의 admin 정보를 읽어 계정 생성을 시도하지 않음

비밀번호 변경 명령어를 쳤을 때 user does not exist(유저가 존재하지 않음) 에러가 났던 것이고 계정을 '직접 새로 생성'해 주어야만 해결.

0개의 댓글