명령줄 인터페이스(CLI)를 통해 연결하기
명령줄 인터페이스(CLI)에서 직접 Redis 데이터베이스에 액세스하세요. CLI를 사용하면 데이터베이스 내에서 생성되는 데이터 구조에 직접 상호 작용하고 모니터링할 수 있습니다. 또한 키스페이스와 성능의 관리 및 모니터링, 스크립트 설치 및 수정, 기타 관리 활동에 유용합니다.
Redis 6에 도입된 사용자 관리 기능을 사용하려면 redli
클라이언트를 업데이트해야 합니다. 클라이언트를 업데이트하지 않고 연결을 시도하면 다음과 같은 오류가 표시됩니다: (error) WRONGPASS invalid username-password pair
.
연결 문자열
연결 문자열은 배포 개요 페이지의 엔드포인트 패널에 표시되며 Cloud Databases CLI 플러그인 및 Cloud Databases API에서도 검색할 수 있습니다.
클라이언트가 배포에 연결하는 데 필요한 정보는 서비스 자격 증명 페이지에서 만든 자격 증명의 "CLI" 섹션에 있습니다. 이 표에는 참조에 대한 분석이 포함되어 있습니다.
필드 이름 | 색인 | 설명 |
---|---|---|
Bin |
연결을 작성하기 위해 권장되는 바이너리입니다. 이 경우 redli 입니다. |
|
Composed |
배치에 대한 연결을 설정하는 형식화된 명령. 명령은 Bin 실행 파일 및 Environment 변수 설정을 결합하며 Arguments 를 명령행 매개변수로 사용합니다. |
|
Environment |
환경 변수로 설정한 키/값 목록입니다. | |
Arguments |
0... | Bin 필드에 표시된 명령에 인수로 전달되는 정보입니다. |
Certificate |
Base64 | 애플리케이션이 적절한 서버에 연결 중인지 확인하는 데 사용되는 서비스 전용 인증서입니다. 이는 base64로 인코딩됩니다. |
Certificate |
이름 | 서비스 전용 인증서에 할당된 이름입니다. |
Type |
이 연결 정보를 사용하는 패키지 유형입니다. 여기서는 cli 입니다. |
|
{: caption=redis``cli 연결 정보" caption-side="top"} |
0...
배열에 이러한 항목이 하나 이상 있을 수 있음을 표시합니다.
설치 redli
redli
는 오픈 소스 Redis 명령행 클라이언트입니다. 독립형이며 redis-cli 명령행 인수를 모방하고 TLS/SSL Redis 연결에 대한 지원을 추가합니다. URI에서 rediss:
프토로콜을 인식하고 비URI 연결을 위한 --tls
플래그를 지원합니다. 터널이 필요 없이 TLS/SSL로 보안된 Redis에 연결할 수 있습니다. 릴리스 페이지에서 다운로드하여 설치하세요.
redli
을 사용하여 연결
ibmcloud cdb deployment-connections
명령은 클라이언트 연결 작성에 포함된 모든 사항을 처리합니다. 예를 들어, "NewRedis"라는 배치에 연결하려면 다음 명령을 사용하십시오.
ibmcloud cdb deployment-connections NewRedis --start
or
ibmcloud cdb cxn NewRedis -s
이 명령은 admin
비밀번호를 입력하라는 메시지를 표시한 다음 redli
명령줄 클라이언트를 실행하여 데이터베이스에 연결합니다.
클라우드 데이터베이스 플러그인을 설치하지 않은 경우 redli
명령을 사용하여 Redis 데이터베이스에 연결하십시오. 배포에서 서비스 전용 인증서를 다운로드하여 저장합니다. 그런 다음 redli
에 "구성된" 연결 문자열과 서비스 전용 인증서의 경로를 지정하여 사용하세요.
redli --uri rediss://admin:$PASSWORD@e6b2c3f8-54a6-439e-8d8a-aa6c4a78df49.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:32371/0 --certfile /path/to/redis-cert.pem
redli
에서 지원되는 기타 연결 옵션 및 매개변수가 있습니다. 자세한 내용은 redli
GitHub 리포지토리에서 해당 문서를 참조하세요.
설치 redis-cli
redis-cli
는 Redis에 대해 공식적으로 지원되는 명령행 인터페이스입니다. 안타깝게도 TLS 연결을 지원하지 않습니다.
redis-cli
을 사용하기로 선택한 경우 몇 가지 추가 구성 단계가 있습니다. Redis 패키지의 일부로 제공되므로 이를 사용하려면 Redis가 로컬에 설치되어야 합니다. macOS, 에서 brew를 설치한 다음 brew install redis
을 사용하여 시작하고 실행합니다.
Linux 에서 배포 패키지 관리자를 참조하여 최신 Redis 패키지를 확인하거나, 원한다면 소스를 다운로드하여 직접 빌드하세요.
redis-cli
을 사용하여 연결
redis-cli
는 TLS 사용 연결을 지원하지 않습니다. redis-cli
연결을 암호화된 연결로 사용하려면 다음과 같은 유틸리티를 설정하세요 stunnel
와 같은 유틸리티를 설정하면 redis-cli
연결이 TLS 암호화로 래핑됩니다.
stunnel
설정
-
stunnel
설치를 수행하십시오. 패키지 관리자( Linux, Mac용 Homebrew)를 사용하거나 플랫폼에 적합한 패키지를 다운로드하세요. -
연결 정보를 가져오십시오. 연결을 설정하려면
stunnel
에 Redis 배치의 호스트, 포트 및 인증서가 필요합니다. 호스트 및 포트는 둘 다 CLI "composed" 연결 문자열에서 사용 가능합니다. 외부 애플리케이션 및 드라이버 연결을 위해 제공되는 연결 문자열 분석에서 파싱된 내용을 확인할 수도 있습니다.인증서는 서비스 자격 증명 연결 정보의 Base64 필드에 있습니다. 인증서를 복사하고 디코딩하여 파일에 저장하십시오.
-
구성 정보를
stunnel.conf
파일에 추가하십시오. 구성에는 다음과 같은 정보가 포함됩니다.- 서비스의 이름입니다. (
[redis-cli]
) - 이 stunnel이 TLS 클라이언트임을 알리는 설정입니다. (
client=yes
) - 연결을 허용하고 연결할 IP 주소 및 포트(
accept=127.0.0.1:6830
) - 연결할 호스트 이름 및 포트입니다. (
connect=
portal972-7.bmix-lon-yp-38898e17-ff6f-4340-9da8-2ba24c41e6d8.composeci-us-ibm-com.composedb.com:24370`) - 인증서의 경로
[redis-cli] client=yes accept=127.0.0.1:6830 connect=sl-us-south-1-portal.7.dblayer.com:23870 verify=2 checkHost=sl-us-south-1-portal.7.dblayer.com CAfile=/path/to/redis/cert.crt
- 서비스의 이름입니다. (
-
stunnel
을(를) 실행하십시오.명령행에
stunnel
명령을 입력하십시오. 즉시 백그라운드에서 실행됩니다. -
새 터미널 창에서 로컬 호스트 및 포트를 가리키는
redis-cli
를 실행하고 배치의 인증 정보로 인증하십시오.redis-cli -p 6830 -a <PASSWORD>
서비스 전용 인증서 사용
- 엔드포인트 패널 또는 서비스 자격증명 연결 정보의 Base64 필드에서 인증서 정보를 복사합니다.
- 필요하면, Base64 문자열을 텍스트로 디코딩하십시오.
- 파일에 인증서를 저장하십시오. (제공되는 이름 또는 자체 파일 이름을 사용할 수 있습니다.)
- 드라이버 또는 클라이언트에 인증서의 경로를 제공하십시오.
서비스 전용 인증서를 위한 CLI 플러그인 지원
다음과 같은 명령을 사용하여 CLI 플러그인을 사용하여 배포를 위해 디코딩된 인증서를 표시할 수 있습니다:
ibmcloud cdb deployment-cacert <INSTANCE_NAME_OR_CRN>
이 명령은 Base64 을 텍스트로 디코딩합니다. 명령의 출력을 복사하여 파일에 저장하고 파일의 경로를 클라이언트에 제공하십시오.