Skip to main content

스토리지 용량 늘리기

Git 리포지토리, 데이터베이스, 검색 인덱스 및 기타 영구 애플리케이션 데이터에 사용할 수 있는 스토리지 크기를 늘리거나 변경할 수 있습니다.

새 시스템 리소스를 할당하는 프로세스는 가상화 플랫폼 및 리소스 유형에 따라 다릅니다. 항상 주요 시스템 리소스에 대한 모니터링 및 경고를 구성해야 합니다. 자세한 내용은 인스턴스 모니터링을(를) 참조하세요.

더 많은 사용자가 GitHub Enterprise Server 인스턴스에 가입함에 따라 스토리지 볼륨의 크기를 조정해야 할 수 있습니다. 스토리지 크기 조정에 대한 자세한 내용은 가상화 플랫폼에 대한 설명서를 참조하세요.

요구 사항 및 권장 사항

Note

스토리지 볼륨의 크기를 조정하기 전에 인스턴스를 유지 관리 모드로 전환합니다. 지정된 IP 주소로부터의 액세스를 허용하도록 IP 예외 목록을 구성하여 변경 사항을 확인할 수 있습니다. 자세한 내용은 유지 관리 모드 사용 설정 및 예약을(를) 참조하세요.

사용자 라이선스x86-64 vCPUs메모리루트 스토리지연결된(데이터) 스토리지IOPS
평가판, 데모 또는 10명의 라이트 사용자432GB400GB500GB600
최대 1,000개848GB400GB500GB3000
1,000~3,0001664GB400GB1000GB6000
3,000~5,00032128GB400GB1500GB9000
5,000~8,00048256GB400GB3000GB12000
8,000~10,000+64512 GB400GB5000GB15000

루트 스토리지는 인스턴스 루트 디스크의 총 크기를 나타냅니다. 루트 파일 시스템에서 사용 가능한 공간은 루트 디스크에서 사용 가능한 총 스토리지의 50%입니다. 자세한 내용은 시스템 개요을(를) 참조하세요.

데이터 파티션 크기 늘리기

  1. 가상화 플랫폼의 도구를 사용하여 기존 사용자 볼륨 디스크의 크기를 조정합니다.

  2. 에 SSH합니다. 인스턴스가 여러 노드로 구성된 경우(예: 고가용성 또는 지역 복제가 구성된 경우) 주 노드에 대한 SSH를 수행합니다. 클러스터를 사용하는 경우 임의 노드에 대해 SSH를 수행할 수 있습니다. HOSTNAME을 인스턴스의 호스트 이름 또는 노드의 호스트 이름이나 IP 주소로 바꿉니다. 자세한 내용은 관리 셸(SSH)에 액세스을(를) 참조하세요.

    Shell
    ssh -p 122 admin@HOSTNAME
    
  3. 어플라이언스를 유지 관리 모드로 전환합니다. 자세한 내용은 유지 관리 모드 사용 설정 및 예약을(를) 참조하세요.

  4. 어플라이언스를 다시 부팅하여 새 스토리지 할당 검색:

    sudo reboot
    
  5. ghe-storage-extend 명령을 실행하여 /data/user 파일 시스템을 확장합니다.

    ghe-storage-extend
    
  6. 시스템 서비스가 제대로 작동하는지 확인하고 유지 관리 모드를 해제합니다. 자세한 내용은 유지 관리 모드 사용 설정 및 예약을(를) 참조하세요.

새 어플라이언스로 루트 파티션 크기 늘리기

  1. 현재 어플라이언스와 동일한 버전을 사용하여 더 큰 루트 디스크가 있는 새 GitHub Enterprise Server 인스턴스를 설정합니다. 자세한 내용은 GitHub Enterprise Server 인스턴스 설정을(를) 참조하세요.

  2. 현재 어플라이언스 종료:

    sudo poweroff
    
  3. 가상화 플랫폼의 도구를 사용하여 현재 어플라이언스에서 데이터 디스크를 분리합니다.

  4. 더 큰 루트 디스크를 사용하여 데이터 디스크를 새 어플라이언스로 연결합니다.

기존 어플라이언스로 루트 파티션 크기 늘리기

Warning

루트 파티션 크기를 늘리기 전에 인스턴스를 유지 관리 모드로 전환해야 합니다. 자세한 내용은 유지 관리 모드 사용 설정 및 예약을(를) 참조하세요.

루트 파티션의 크기를 조정하기 전에 어플라이언스에 GUID 파티션 테이블이 있는지 확인합니다.

GHES 릴리스 3.14 이상에서 만든 인스턴스에서 GUID 파티션 테이블의 루트 파티션 크기 늘리기를 위한 지침을 따릅니다.

3.14 이전의 GHES 릴리스에서 만든 인스턴스에서 레거시 파티션 테이블의 루트 파티션 크기 늘리기를 위한 지침을 따릅니다.

파티션 테이블 유형을 확인하려면 다음 명령을 실행합니다. 결과는 gpt 또는 msdos여야 합니다.

sudo lsblk -no pttype $(findmnt -no source /)
  1. GitHub Enterprise Server 어플라이언스로 새 디스크를 연결합니다.
  2. lsblk 명령을 실행하여 새 디스크의 디바이스 이름을 식별합니다.

GUID 파티션 테이블의 루트 파티션 크기 늘리기

  1. 기존 EFI 부팅 파티션을 백업합니다.

    sudo dd if=/dev/disk/by-label/EFIBOOT of=EFIBOOT.bak bs=1M
    
  2. parted 명령을 실행하여 디스크를 포맷하고 디바이스 이름을 /dev/xvdg로 바꿉니다.

    sudo parted /dev/xvdg mklabel gpt
    sudo parted -a optimal /dev/xvdg mkpart bios fat32 1MiB 2MiB
    sudo parted /dev/xvdg set 1 bios_grub on
    sudo parted -a optimal /dev/xvdg mkpart efi fat32 2MiB 512MiB
    sudo parted /dev/xvdg set 2 esp on
    sudo parted -a optimal /dev/xvdg mkpart primary 512MiB 50%
    sudo parted /dev/xvdg set 3 boot off
    sudo parted /dev/xvdg set 3 esp off
    sudo parted -a optimal /dev/xvdg mkpart primary 50% 100%
    
  3. 고가용성 또는 지역에서 복제를 지원하도록 어플라이언스가 구성된 경우 복제를 중지하려면 각 복제본 노드에서 ghe-repl-stop 명령을 실행합니다.

    ghe-repl-stop
    
  4. 새로 분할된 디스크에 GitHub Enterprise Server 소프트웨어를 설치하려면 ghe-upgrade 명령을 실행합니다. PACKAGE-NAME.pkg를 어플라이언스에서 이미 실행 중인 GitHub Enterprise Server의 버전과 일치하는 플랫폼별 업그레이드 패키지의 경로로 바꿔야 합니다. github-enterprise-2.11.9.hpkg과(와) 같은 범용 핫패치 업그레이드 패키지는 사용할 수 없습니다. ghe-upgrade 명령이 완료되면 애플리케이션 서비스가 자동으로 종료됩니다.

    ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg3
    
  5. 새로 추가된 디스크의 보조 파티션에서 다음 명령을 실행합니다.

    sudo dd if=/dev/disk/by-label/EFIBOOT of=/dev/xvdg2 bs=1M
    sudo mkfs.ext4 -L fallback /dev/xvdg4
    
  6. 애플리케이션 종료:

    sudo poweroff
    
  7. 하이퍼바이저에서 이전 루트 디스크를 제거하고 이전 루트 디스크와 동일한 위치에 새 루트 디스크를 연결합니다.

  8. 어플라이언스를 시작합니다.

  9. 시스템 서비스가 제대로 작동하는지 확인하고 유지 관리 모드를 해제합니다. 자세한 내용은 유지 관리 모드 사용 설정 및 예약을(를) 참조하세요.

어플라이언스가 고가용성 또는 지역 복제를 위해 구성된 경우 모든 노드의 스토리지가 업그레이드된 후 ghe-repl-start를 사용하여 각 복제본 노드에서 복제를 시작해야 합니다.

레거시 파티션 테이블의 루트 파티션 크기 늘리기

  1. parted 명령을 실행하여 디스크를 포맷하고 디바이스 이름을 /dev/xvdg로 바꿉니다.

    sudo parted /dev/xvdg mklabel msdos
    sudo parted /dev/xvdg mkpart primary ext4 0% 50%
    sudo parted /dev/xvdg mkpart primary ext4 50% 100%
    
  2. 고가용성 또는 지역에서 복제를 지원하도록 어플라이언스가 구성된 경우 복제를 중지하려면 각 복제본 노드에서 ghe-repl-stop 명령을 실행합니다.

    ghe-repl-stop
    
  3. 새로 분할된 디스크에 GitHub Enterprise Server 소프트웨어를 설치하려면 ghe-upgrade 명령을 실행합니다. PACKAGE-NAME.pkg를 어플라이언스에서 이미 실행 중인 GitHub Enterprise Server의 버전과 일치하는 플랫폼별 업그레이드 패키지의 경로로 바꿔야 합니다. github-enterprise-2.11.9.hpkg과(와) 같은 범용 핫패치 업그레이드 패키지는 사용할 수 없습니다. ghe-upgrade 명령이 완료되면 애플리케이션 서비스가 자동으로 종료됩니다.

    ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1
    
  4. 새로 추가된 디스크의 보조 파티션에서 다음 명령을 실행합니다.

    sudo mkfs.ext4 -L fallback /dev/xvdg2
    
  5. 애플리케이션 종료:

    sudo poweroff
    
  6. 하이퍼바이저에서 이전 루트 디스크를 제거하고 이전 루트 디스크와 동일한 위치에 새 루트 디스크를 연결합니다.

  7. 어플라이언스를 시작합니다.

  8. 시스템 서비스가 제대로 작동하는지 확인하고 유지 관리 모드를 해제합니다. 자세한 내용은 유지 관리 모드 사용 설정 및 예약을(를) 참조하세요.

어플라이언스가 고가용성 또는 지역 복제를 위해 구성된 경우 모든 노드의 스토리지가 업그레이드된 후 ghe-repl-start를 사용하여 각 복제본 노드에서 복제를 시작해야 합니다.