TiUP 설치

실제 운영 환경에서 설치하는 방법이다.
Tags:

TiUP 이란?

  • TiUP는 TiDB 4.0에 도입된 클러스터 운영 유지보수 도구이다.
  • TiUP는 Golang으로 작성된 클러스터 관리 구성 요소인 TiUP 클러스터 를 제공한다.
  • TiUP 클러스터를 사용하면 TiDB 클러스터의 배포, 시작, 중지, 삭제, 스케일링 및 업그레이드를 포함한 일상적인 데이터베이스 작업을 쉽게 수행하고 TiDB 클러스터의 매개 변수를 관리할 수 있다.

Linux 환경에서 TiUP 설치

1. TiUP 도구 다운로드 및 설치

먼저, 온라인 환경에서 다음 명령을 실행하여 TiUP를 다운로드하여 설치한다.

curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh

다음과 같은 “Successfully” 메시지가 표시 되었다면 TiUP가 성공적으로 설치된 것이다.

[kimkc@localhost ~]$ curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                              Dload  Upload   Total   Spent    Left  Speed
100 7085k  100 7085k    0     0  3326k      0  0:00:02  0:00:02 --:--:-- 3328k
WARN: adding root certificate via internet: https://tiup-mirrors.pingcap.com/root.json
You can revoke this by remove /home/kimkc/.tiup/bin/7b8e153f2e2d0928.root.json
Successfully set mirror to https://tiup-mirrors.pingcap.com
Detected shell: bash
Shell profile:  /home/kimkc/.bash_profile
/home/kimkc/.bash_profile has been modified to add tiup to PATH
open a new terminal or source /home/kimkc/.bash_profile to use it
Installed path: /home/kimkc/.tiup/bin/tiup
===============================================
Have a try:     tiup playground
===============================================
[kimkc@localhost ~]$

위 출력에서 설치된 쉘 프로파일 경로에 기억해 두기로 하자. 다음 단계에서 이 경로를 사용해야 한다.

Installed path: /home/kimkc/.tiup/bin/tiup

2. 변경된 환경 변수 반영

설치 후에 아래와 같이 home 디렉터리에 조회해보면 .pki, .tiup 디렉터리가 생성된 것을 볼 수 있다.

[kimkc@localhost ~]$ ls -al
total 16
drwx------. 4 kimkc kimkc 108 Oct 31 11:08 .
drwxr-xr-x. 3 root  root   19 Oct 31  2022 ..
-rw-------. 1 kimkc kimkc 282 Oct 31 10:51 .bash_history
-rw-r--r--. 1 kimkc kimkc  18 Mar 31  2020 .bash_logout
-rw-r--r--. 1 kimkc kimkc 234 Oct 31 11:08 .bash_profile
-rw-r--r--. 1 kimkc kimkc 231 Mar 31  2020 .bashrc
drwxrw----. 3 kimkc kimkc  19 Oct 31 11:07 .pki
drwxrwxr-x. 3 kimkc kimkc  34 Oct 31 11:08 .tiup
[kimkc@localhost ~]$

그리고, 셸 프로필 파일(.bash_profile)을 확인해 보면, 아래 부분에 .tiup/bin 경로가 PATH가 등록된 것을 볼 수 있다.

[kimkc@localhost ~]$ cat .bash_profile
# .bash_profile

# ... 중간 생략 ....

export PATH=/home/kimkc/.tiup/bin:$PATH

이 변경된 환경 변수를 source 명령으로 반영해 준다.

$ source .bash_profile

macOS 환경에서 TiUP 설치

1. TiUP 도구 다운로드 및 설치

먼저, 온라인 환경에서 다음 명령을 실행하여 TiUP를 다운로드하여 설치한다.

curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh

% curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                Dload  Upload   Total   Spent    Left  Speed
100 6988k  100 6988k    0     0  3433k      0  0:00:02  0:00:02 --:--:-- 3442k
WARN: adding root certificate via internet: https://tiup-mirrors.pingcap.com/root.json
You can revoke this by remove /Users/user/.tiup/bin/7b8e153f2e2d0928.root.json
Successfully set mirror to https://tiup-mirrors.pingcap.com
Detected shell: zsh
Shell profile:  /Users/user/.zshrc
/Users/user/.zshrc has been modified to add tiup to PATH
open a new terminal or source /Users/user/.zshrc to use it
Installed path: /Users/user/.tiup/bin/tiup
===============================================
Have a try:     tiup playground
===============================================

2. 전역 환경 변수를 다시 선언

설치 후 TiUP는 해당하는 셸 프로필 파일의 절대 경로를 표시한다. 경로에 따라 다음 source 명령에서 ${your_shell_profile}을 변경해야 한다. 이 경우 1단계의 출력에서 ${your_shell_profile}는 /Users/user/.zshrc이다.

source ${your_shell_profile}

% source .zshrc

3. TiUP이 설치되어 있는지 확인

which tiup

% which tiup
/Users/user/.tiup/bin/tiup
  1. 전역 환경 변수를 선언한다.



최종 수정 : 2022-11-18