연결 문자열 가져오기

IBM Cloud® Databases for Redis 서비스는 인증이 사용으로 설정된 상태로 프로비저닝됩니다. 연결하고 명령을 실행하려면 사용자 이름, 비밀번호 및 연결 문자열이 필요합니다.

배포에 대한 연결 문자열은 개요 페이지의 엔드포인트 패널에 표시됩니다. 배치에 있는 모든 사용자는 공용 또는 개인 엔드포인트에 대한 연결 문자열을 포함하여 연결 문자열을 사용할 수 있습니다.

연결 문자열은 기본적으로 데이터베이스 0 설정됩니다. 그러나 0 아닌 다른 데이터베이스에 연결하도록 연결을 수정하는 것은 지원됩니다.

Redis 배치에는 admin 사용자가 프로비저닝됩니다. admin 사용자를 사용하여 데이터베이스에 연결하려면 admin 비밀번호를 설정해야 합니다. 자세한 정보는 관리 비밀번호 설정 페이지를 참조하십시오.

UI에서 연결 문자열 가져오기

다음 단계에 따라 Databases for Redis 인스턴스 연결 문자열을 검색합니다:

  1. 배포의 개요 페이지에서 아래로 스크롤하여 엔드포인트 섹션으로 이동합니다.
  2. 엔드포인트 섹션에는 다음 섹션이 있는 빠른 시작 탭이 있습니다:
    • CLI를 사용하여 연결- This section contains information for connecting to your deployment through the IBM CLI.
    • Redis 클라이언트를 사용하여 연결- 이 섹션에서는 TLS 인증서를 가져와서 배포에 연결할 수 있습니다.

CLI에서 연결 문자열 가져오기

CLI에서 연결 문자열을 가져올 수 있습니다.

ibmcloud cdb deployment-connections <INSTANCE_NAME_OR_CRN> -u <NEWUSERNAME> [--endpoint-type <endpoint type>]

전체 연결 정보는 ibmcloud cdb deployment-connections 플래그와 함께 --all 명령으로 리턴됩니다. 배포에 대한 모든 연결 정보를 검색하려면 다음 명령을 사용하세요:

ibmcloud cdb deployment-connections <INSTANCE_NAME_OR_CRN> -u <NEWUSERNAME> --all [--endpoint-type <endpoint type>]

사용자를 지정하지 않으면 deployment-connections 명령이 기본적으로 admin 사용자에 대한 정보를 리턴합니다. 엔드포인트 유형을 지정하지 않으면, 연결 문자열이 기본적으로 공용 엔드포인트를 리턴합니다. 배치에 개인용 엔드포인트만 있는 경우, --endpoint-type private를 지정해야 하며 그렇지 않으면 명령이 오류를 리턴합니다. 사용자 및 엔드포인트 유형이 적용되지 않습니다. 배치의 모든 사용자를 두 엔드포인트 중 하나와 함께 사용할 수 있습니다(두 엔드포인트가 모두 배치에 있는 경우).

ibmcloud cdb CLI 명령을 사용하려면 Cloud Databases 플러그인을 설치해야 합니다.

API에서 연결 문자열 가져오기

API에서 사용자의 연결 문자열을 검색하려면 /users/{userid}/connections엔드포인트를 사용하십시오. 리턴된 연결 문자열에서 사용되는 엔드포인트의 유형(공용 또는 개인용)과 사용자를 경로에서 지정해야 합니다. 사용자 및 엔드포인트 유형이 적용되지 않습니다. 배치의 모든 사용자를 두 엔드포인트 중 하나와 함께 사용할 수 있습니다(두 엔드포인트가 모두 배치에 있는 경우).

curl -X GET https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/users/{user_type}/{user_id}/connections/{endpoint_type} \
-H 'Authorization: Bearer <>' \

추가 사용자 및 연결 문자열

Databases for Redis 배치에 대한 액세스는 admin 사용자로 제한되지 않습니다. 서비스 자격 증명 페이지, IBM 클라우드 CLI 또는 IBM Cloud Databases API를 통해 사용자를 만들 수 있습니다.

배치에 있는 모든 사용자는 공용 또는 개인 엔드포인트에 대한 연결 문자열을 포함하여 연결 문자열을 사용할 수 있습니다.

UI에서 사용자 만들기

  1. 서비스에 대한 리소스 상세 페이지로 이동합니다.
  2. 서비스 자격 증명을 클릭하여 서비스 자격 증명 페이지를 엽니다.
  3. 새 인증 정보를 클릭하십시오.
  4. 새 인증 정보에 대한 설명 이름을 선택하십시오.
  5. (선택사항) 새 인증 정보가 공용 또는 개인용 엔드포인트를 사용하는지를 지정하십시오. 인라인 구성 매개변수 추가 필드에서 { "service-endpoints": "public" } / { "service-endpoints": "private" }를 사용하여 지정된 엔드포인트를 사용하는 연결 문자열을 생성하십시오. 엔드포인트의 사용은 연결 문자열에 어떤 호스트 이름이 포함되는지 제어하므로 강제되지 않습니다. 공용 엔드포인트는 기본적으로 생성됩니다.
  6. 새 인증 정보를 제공하려면 추가를 클릭하십시오. 사용자 아이디와 비밀번호, 연결된 Redis 사용자가 자동으로 생성됩니다.

새 인증 정보가 테이블에 표시되며 연결 문자열은 인증 정보 보기 아래의 click-to-copy 필드에서 JSON으로 사용 가능합니다.

CLI에서 사용자 만들기

IBM Cloud CLI 및 클라우드 데이터베이스 플러그인을 통해 서비스를 관리하는 경우 cdb user-create를 사용하여 새 사용자를 작성할 수 있습니다. 예를 들어, "example-deployment"에 대해 새 사용자를 작성하려면 다음 명령을 사용하십시오.

ibmcloud cdb user-create example-deployment <NEWUSERNAME> <NEWPASSWORD>

태스크가 완료되면 ibmcloud cdb deployment-connections 명령을 사용하여 새 사용자의 연결 문자열을 검색할 수 있습니다.

API로 사용자 만들기

서비스의 개요 패널에 표시되는 _기반 엔드포인트_는 API를 통해 이 배치에 액세스할 수 있는 기본 URL을 제공합니다. 사용자를 작성 및 관리하려면 /users 엔드포인트에서 기본 URL을 사용하십시오.

curl -X POST 'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/users/{user_type}' \
-H "Authorization: Bearer $APIKEY" \
-H "Content-Type: application/json" \
-d '{"user": {"username": "user", "password": "v3ry-1-secUre-pAssword-2"}}'

사용자의 연결 문자열을 검색하려면 /users/{userid}/connections 엔드포인트에서 기본 URL을 사용하십시오.

UI에서 서비스 자격 증명에 사용자 추가하기

CLI에서 사용자를 새로 작성하면 해당 사용자의 연결 문자열이 _서비스 인증 정보_에 자동으로 채워지지 않습니다. 추가하려는 경우 기존 사용자 정보로 새 인증 정보를 작성할 수 있습니다.

JSON 필드 _인라인 구성 매개변수 추가_에 사용자 이름 및 비밀번호를 입력하거나, JSON 정보가 저장된 파일을 지정하십시오. 예를 들어, 필드에 {"existing_credentials":{"username":"Robert","password":"supersecure"}}를 입력하면 사용자 이름 "Robert"와 비밀번호 "supersecure"가 연결 문자열에 채워진 _서비스 인증 정보_가 생성됩니다.

기존 사용자의 인증 정보를 생성해도 해당 사용자를 확인하거나 작성하지 않습니다.

연결 문자열 명세

Redis 섹션

서비스 자격 증명 페이지에서 만든 자격 증명의Redis' 섹션에는 Redis 연결하는 애플리케이션에 적합한 정보가 포함되어 있습니다.

Redis 연결 정보
필드 이름 색인 설명
Type 연결 유형 - Redis 의 경우 "URI"입니다.
Scheme URI에 대한 스키마 - Redis 의 경우 "rediss"입니다.
Path URI의 경로 - Redis 의 경우 데이터베이스 번호입니다.
Authentication Username 연결하는 데 사용하는 사용자 이름입니다.
Authentication Password 사용자의 비밀번호 - $PASSWORD 로 표시될 수 있습니다.
Authentication Method 인증이 수행되는 방법이며 "직접" 인증은 드라이버에 의해 처리됩니다.
Hosts 0... 연결할 호스트 이름 및 포트입니다.
Composed 0... 스키마, 인증, 호스트 및 경로를 결합한 URI입니다.
Certificate Name 데이터베이스 배포를 위한 서비스 전용 인증서에 할당된 이름입니다.
Certificate Base64 base64 인코딩된 인증서 버전입니다.
  • 0... 배열에 이러한 항목이 하나 이상 있을 수 있음을 표시합니다.

자세한 내용은 외부 애플리케이션 연결하기를 참조하세요.

CLI 섹션

서비스 자격 증명 페이지에서 만든 자격 증명의 "CLI" 섹션에는 Redis 연결하는 명령줄 클라이언트에 적합한 정보가 포함되어 있습니다.

Redis 연결 정보
필드 이름 색인 설명
Bin 연결을 작성하기 위해 권장되는 바이너리입니다. 이 경우 redli입니다.
Composed 배치에 대한 연결을 설정하는 형식화된 명령. 명령은 Bin 실행 파일 및 Environment 변수 설정을 결합하며 Arguments를 명령행 매개변수로 사용합니다.
Environment 환경 변수로 설정한 키 또는 값 목록입니다.
Arguments 0... Bin 필드에 표시된 명령에 인수로 전달되는 정보입니다.
Certificate Base64 애플리케이션이 적절한 서버에 연결 중인지 확인하는 데 사용되는 서비스 전용 인증서입니다. 이는 base64로 인코딩됩니다.
Certificate 이름 서비스 전용 인증서에 할당된 이름입니다.
Type 이 연결 정보를 사용하는 패키지 유형입니다. 여기서는 cli입니다.
  • 0... 배열에 이러한 항목이 하나 이상 있을 수 있음을 표시합니다.

자세한 내용은 명령줄 클라이언트로 연결하기를 참조하세요.