빠른 시작: Java 앱과 함께 Azure Cache for Redis 사용

이 빠른 시작에서는 Jedis Redis 클라이언트를 사용하여 Azure Cache for Redis를 Java 앱에 통합합니다. 앱은 Azure의 모든 애플리케이션에서 액세스할 수 있는 안전한 전용 캐시에 연결합니다.

코드로 건너뛰기

이 빠른 시작에서는 Maven 원형 기능을 사용하여 Java 앱용 스캐폴딩을 생성합니다. 이 빠른 시작에서는 Azure Cache for Redis에 연결하는 작동하는 앱을 만들기 위해 코드를 구성하는 방법을 설명합니다.

코드로 바로 이동하려면 GitHub의 Java 빠른 시작 샘플을 참조하세요.

필수 구성 요소

• Azure 구독 무료로 계정 만들기
• Apache Maven

캐시 만들기

1. 캐시를 만들려면 Azure Portal에 로그인합니다. Portal 메뉴에서 리소스 만들기를 선택합니다.

   

2. 시작 창의 검색 창에서 Aure Cache for Redis를 입력합니다. 검색 결과에서 Azure Cache for Redis를 찾은 다음, 만들기를 선택합니다.

   

3. 새 Redis Cache 창의 기본 탭에서 캐시에 대해 다음 설정을 구성합니다.

   설정	작업	설명
   구독	Azure 구독을 선택합니다.	Azure Cache for Redis의 새 인스턴스를 만드는 데 사용할 구독입니다.
   리소스 그룹	리소스 그룹을 선택하거나 새로 만들기를 선택하고 새 리소스 그룹 이름을 입력합니다.	캐시 및 기타 리소스를 만들 리소스 그룹의 이름입니다. 모든 앱 리소스를 하나의 리소스 그룹에 배치하면 앱 리소스를 쉽게 관리하거나 삭제할 수 있습니다.
   DNS 이름	고유한 이름을 입력합니다.	캐시 이름은 숫자, 문자 및 하이픈만 포함하는 1~63자의 문자열이어야 합니다. 이름은 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다. 캐시 인스턴스의 호스트 이름은 \<DNS name>.redis.cache.windows.net입니다.
   위치	위치를 선택합니다.	캐시를 사용하는 다른 서비스 근처에 있는 Azure 지역입니다.
   캐시 SKU	SKU를 선택합니다.	SKU는 캐시에 사용할 수 있는 크기, 성능 및 기능 매개 변수를 결정합니다. 자세한 내용은 Azure Cache for Redis 개요를 참조하세요.
   캐시 크기	캐시 크기를 선택합니다.	자세한 내용은 Azure Cache for Redis 개요를 참조하세요.

4. 네트워킹 탭을 선택하거나 다음: 네트워킹을 선택합니다.

5. 네트워킹 탭에서 캐시에 사용할 연결 방법을 선택합니다.

6. 고급 탭을 선택하거나 다음: 고급을 선택합니다.

7. 고급 창에서 다음 정보에 따라 인증 방법을 확인하거나 선택합니다.

   

   • 기본적으로 새 기본, 표준 또는 프리미엄 캐시의 경우 Microsoft Entra 인증이 활성화되고 액세스 키 인증이 비활성화됩니다.
   • 기본 또는 표준 캐시의 경우 비 TLS 포트 선택 영역을 선택/해제할 수 있습니다.
   • 표준 및 프리미엄 캐시의 경우 가용성 영역을 사용하도록 선택할 수 있습니다. 캐시를 만든 후에는 가용성 영역을 비활성화할 수 없습니다.
   • 프리미엄 캐시의 경우 비 TLS 포트, 클러스터링, 관리 ID 및 데이터 지속성에 대한 설정을 구성합니다.

   Important

   최적의 보안을 위해 관리 ID와 함께 Microsoft Entra ID를 사용하여 가능한 경우 캐시에 대한 요청에 권한을 부여하는 것이 좋습니다. Microsoft Entra ID 및 관리 ID를 사용한 인증은 공유 액세스 키 인증에 비해 뛰어난 보안과 사용 편의성을 제공합니다. 캐시에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 캐시 인증을 위한 Microsoft Entra ID 사용을 참조하세요.

8. (선택 사항) 태그 탭을 선택하거나 다음: 태그를 선택합니다.

9. (선택 사항) 태그 탭에서 캐시 리소스를 분류하려는 경우 태그 이름과 값을 입력합니다.

10. 검토 + 만들기 단추를 선택합니다.

    검토 + 만들기 탭에서 Azure는 자동으로 구성의 유효성을 검사합니다.

11. 녹색 유효성 검사 통과 메시지가 표시되면 만들기를 선택합니다.

새 캐시 배포는 몇 분 동안 발생합니다. Azure Cache for Redis 개요 창에서 배포 진행률을 모니터링할 수 있습니다. 상태가 실행 표시되면 캐시를 사용할 준비가 됩니다.

호스트 이름, 포트 및 액세스 키 가져오기

Azure Cache for Redis 서버에 연결하려면 캐시 클라이언트에 캐시의 호스트 이름, 포트 및 액세스 키가 필요합니다. 일부 클라이언트는 약간 다른 이름을 사용하여 이러한 항목을 참조할 수 있습니다. Azure Portal에서 호스트 이름, 포트 및 키를 가져올 수 있습니다.

• 캐시에 대한 액세스 키를 가져오려면 다음을 수행합니다.

  1. Azure Portal에서 캐시로 이동합니다.
  2. 서비스 메뉴의 설정 아래에서 인증을 선택합니다.
  3. 인증 창에서 액세스 키 탭을 선택합니다.
  4. 액세스 키 값을 복사하려면 키 필드에서 복사 아이콘을 선택합니다.

  

• 캐시에 대한 호스트 이름 및 포트를 가져오려면 다음을 수행합니다.

  1. Azure Portal에서 캐시로 이동합니다.
  2. 서비스 메뉴에서 개요를 선택합니다.
  3. Essentials 아래에서 호스트 이름의 경우 복사 아이콘을 선택하여 호스트 이름 값을 복사합니다. 호스트 이름 값에는 <DNS name>.redis.cache.windows.net 형식이 있습니다.
  4. 포트의 경우 복사 아이콘을 선택하여 포트 값을 복사합니다.

  

작업 환경 설정

운영 체제에 따라 앞서 언급한 호스트 이름 및 기본 액세스 키에 대한 환경 변수를 추가합니다. 명령 프롬프트 창 또는 터미널 창에서 다음 값을 설정합니다.

export REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
export REDISCACHEKEY=<your-primary-access-key>

set REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
set REDISCACHEKEY=<your-primary-access-key>

자리 표시자를 다음 값으로 바꿉니다.

• <your-host-name>: Azure Portal에 있는 Azure Cache for Redis 리소스의 속성 섹션에서 가져온 DNS 호스트 이름입니다.
• <your-primary-access-key>: Azure Portal에 있는 Azure Cache for Redis 리소스의 액세스 키 섹션에서 가져온 기본 액세스 키입니다.

Java 샘플 검토

이 샘플에서는 Maven을 사용하여 빠른 시작 앱을 실행합니다.

1. 새 redistest 프로젝트 디렉터리로 이동합니다.

2. pom.xml 파일을 엽니다. 파일에서 Jedis에 대한 종속성이 표시되는지 확인합니다.

   <dependency>
     <groupId>redis.clients</groupId>
     <artifactId>jedis</artifactId>
     <version>4.1.0</version>
     <type>jar</type>
     <scope>compile</scope>
   </dependency>
   

3. pom.xml 파일을 저장합니다.

4. App.java를 열고 다음 코드가 표시되는지 확인합니다.

   package example.demo;
   
   import redis.clients.jedis.DefaultJedisClientConfig;
   import redis.clients.jedis.Jedis;
   
   /**
    * Redis test
    *
    */
   public class App 
   {
       public static void main( String[] args )
       {
   
           boolean useSsl = true;
           String cacheHostname = System.getenv("REDISCACHEHOSTNAME");
           String cachekey = System.getenv("REDISCACHEKEY");
   
           // Connect to the Azure Cache for Redis over the TLS/SSL port using the key.
           Jedis jedis = new Jedis(cacheHostname, 6380, DefaultJedisClientConfig.builder()
               .password(cachekey)
               .ssl(useSsl)
               .build());
   
           // Perform cache operations by using the cache connection object. 
   
           // Simple PING command
           System.out.println( "\nCache Command  : Ping" );
           System.out.println( "Cache Response : " + jedis.ping());
   
           // Simple get and put of integral data types into the cache
           System.out.println( "\nCache Command  : GET Message" );
           System.out.println( "Cache Response : " + jedis.get("Message"));
   
           System.out.println( "\nCache Command  : SET Message" );
           System.out.println( "Cache Response : " + jedis.set("Message", "Hello! The cache is working from Java!"));
   
           // Demonstrate "SET Message" executed as expected...
           System.out.println( "\nCache Command  : GET Message" );
           System.out.println( "Cache Response : " + jedis.get("Message"));
   
           // Get the client list, useful to see if connection list is growing...
           System.out.println( "\nCache Command  : CLIENT LIST" );
           System.out.println( "Cache Response : " + jedis.clientList());
   
           jedis.close();
       }
   }
   

   이 코드는 캐시 호스트 이름과 키 환경 변수를 사용하여 Azure Cache for Redis 인스턴스에 연결하는 방법을 보여 줍니다. 코드는 또한 캐시에 문자열 값을 저장하고 검색합니다. 또한 PING 및 CLIENT LIST 명령을 실행했습니다.

5. App.java를 닫습니다.

앱 빌드 및 실행

1. 앞에서 설명한 대로 환경 변수를 설정합니다.

   • Linux
   • Windows

   export REDISCACHEHOSTNAME=<your-host-name>.redis.cache.windows.net
   export REDISCACHEKEY=<your-primary-access-key>
   

2. 앱을 빌드하고 실행하려면 다음 Maven 명령을 실행합니다.

   • Linux
   • Windows

   mvn compile
   mvn exec:java -D exec.mainClass=example.demo.App
   

다음 출력에서 이전에 Message 키에는 캐시된 값이 있었음을 확인할 수 있습니다. jedis.set을(를) 사용하여 값이 새 값으로 업데이트되었습니다. 또한 앱에서 PING 및 CLIENT LIST 명령을 실행했습니다.

Cache Command  : Ping
Cache Response : PONG

Cache Command  : GET Message
Cache Response : Hello! The cache is working from Java!

Cache Command  : SET Message
Cache Response : OK

Cache Command  : GET Message
Cache Response : Hello! The cache is working from Java!

Cache Command  : CLIENT LIST
Cache Response : id=777430 addr=             :58989 fd=22 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-free=32768 obl=0 oll=0 omem=0 ow=0 owmem=0 events=r cmd=client numops=6

리소스 정리

이 문서에서 만든 리소스를 계속 사용하려면 리소스 그룹을 유지합니다.

그렇지 않은 경우 리소스와 관련된 요금을 방지하려면 리소스 사용을 완료한 경우 만든 Azure 리소스 그룹을 삭제할 수 있습니다.

리소스 그룹 삭제

1. Azure Portal에 로그인한 다음, 리소스 그룹을 선택합니다.

2. 삭제할 리소스 그룹을 선택합니다.

   리소스 그룹이 많은 경우 필드 필터링에서 이 문서를 완료하기 위해 만든 리소스 그룹의 이름을 입력합니다. 검색 결과 목록에서 리소스 그룹을 선택합니다.

   

3. 리소스 그룹 삭제를 선택합니다.

4. 리소스 그룹 삭제 창에서 확인할 리소스 그룹의 이름을 입력한 다음 삭제를 선택합니다.

   

몇 분 내에 리소스 그룹과 모든 해당 리소스가 삭제됩니다.

관련 콘텐츠

• 캐시에 대한 연결 복원력 모범 사례
• 캐시에 대한 개발 모범 사례
• Jakarta EE와 함께 Azure Cache for Redis 사용
• Spring와 함께 Azure Cache for Redis 사용