在 Azure Stack Hub 中搭配 Java 使用 API 版本配置檔

若要使用最新版的服務，請使用 最新的 配置檔作為相依性。

您可以採用現有的 com.azure.resourcemanager 相依性，並將版本從 x.y.z 變更為 x.y.z-hybrid，以將應用程式設為 Azure tack Hub 中的資源。 提供 Azure Stack Hub 支援的混合式套件會在版本結尾使用 -hybrid 後綴，例如 1.0.0-hybrid。 這會指向與版本相關聯的端點靜態集合。

若要取得最新的配置檔，請採用您現有的 com.azure.resourcemanager 相依性，並將版本變更為 最新版本。 最新的配置檔 Java 套件提供與 Azure 的一致體驗。 套件與 Azure com.azure.resourcemanager 共用相同的群組標識符。 成品標識碼和命名空間也與全域 Azure 相同。 這有助於將 Azure 應用程式移植到 Azure Stack Hub。 若要深入瞭解 Azure Stack Hub 中用來作為混合式配置檔剖析的端點，請參閱 API 配置檔的摘要。

配置檔是在 Maven 專案中的檔案中 pom.xml 指定為相依性。 如果您從下拉式清單中選擇正確的類別，配置檔會自動載入模組（就像使用 .NET 一樣）。

設定開發環境

若要準備執行 SDK 的環境，您可以使用 Eclipse 或 Visual Studio Code 之類的 IDE，但您必須安裝 Git、Java SDK 和 Apache Maven。 您可以在使用 Azure SDK for Java 找到設定開發環境必要條件的詳細數據

1. 安裝 Git。 您可以在 開始使用 - 安裝 Git 中找到安裝 Git 的官方指示。

2. 安裝 Java SDK，並將您的 JAVA_HOME 環境變數設定為 Java 開發工具包的二進位檔位置。 您可以找到 OpenJDK 的可下載安裝媒體指示。 安裝第 8 版或更新版本的 Java Developer Kit。

3. 安裝 Apache Maven。 您可以在 Apache Maven 專案找到指示。 安裝 Apache Maven 是 3.0 或更新版本。

Java 和 API 版本設定檔

若要使用所有服務的最新版本，請使用 最新的 配置檔作為相依性。

• 若要使用最新的配置檔，相依性為 com.microsoft.azure。

• 若要使用 Azure Stack Hub 中可用的最新支援服務，請使用 com.microsoft.azure.profile_2019_03_01_hybrid 配置檔。

  • 配置檔會在 Pom.xml 檔案中指定為相依性，如果您從下拉式清單中選擇正確的類別，就會自動載入模組（如同 .NET 一樣）。

• 相依性如下所示：

  <dependency>
  <groupId>com.microsoft.azure.profile_2019_03_01_hybrid</groupId>
  <artifactId>azure</artifactId>
  <version>1.0.0-beta-1</version>
  </dependency>
  

• 若要針對特定資源提供者中的資源類型使用特定 API 版本，請使用透過 Intellisense 定義的特定 API 版本。

您可以在相同的應用程式中合併所有選項。

安裝 Azure Java SDK

請遵循下列步驟來安裝 Java SDK：

1. 請遵循官方指示來安裝 Git。 請參閱 用戶入門 - 安裝 Git。

2. 請遵循指示來安裝 Java SDK 和 Maven。 正確的版本是 Java Developer Kit 第 8 版。 正確版本的 Apache Maven 為 3.0 或更新版本。 若要完成快速入門， JAVA_HOME 環境變數必須設定為Java開發工具包的安裝位置。 如需詳細資訊，請參閱 使用 Java 和 Maven 建立您的第一個函式。

3. 若要安裝正確的相依性套件，請在 Java 應用程式中開啟 Pom.xml 檔案。 新增相依性，如下列程式代碼所示：

   <dependency>
   <groupId>com.microsoft.azure.profile_2019_03_01_hybrid</groupId>
   <artifactId>azure</artifactId>
   <version>1.0.0-beta-1</version>
   </dependency>
   

4. 需要安裝的套件集取決於您要使用的配置檔版本。 設定檔案版本的套件名稱如下：

   • com.microsoft.azure.profile_2019_03_01_hybrid
   • com.microsoft.azure
     • 最新

信任或接受 Azure Stack Hub CA 根憑證

如果您使用 Azure Stack 開發工具套件 （ASDK），您必須信任遠端電腦上的 CA 跟證書。 您不需要信任 Azure Stack Hub 整合系統的 CA 根憑證。

窗戶

1. 將 Azure Stack Hub 自我簽署憑證匯出至您的桌面。

2. 在命令提示字元中，將目錄變更為 %JAVA_HOME%\bin。

3. 執行下列命令：

   .\keytool.exe -importcert -noprompt -file <location of the exported certificate here> -alias root -keystore %JAVA_HOME%\lib\security\cacerts -trustcacerts -storepass changeit
   

現有的 API 設定檔

• com.microsoft.azure.profile_2019_03_01_hybrid：針對 Azure Stack Hub 建置的最新配置檔。 只要您是 1904 或更新版本，即可將此配置檔用於與 Azure Stack Hub 最相容的服務。

• com.microsoft.azure.profile_2018_03_01_hybrid：針對 Azure Stack Hub 建置的配置檔。 使用此配置檔讓服務與 Azure Stack Hub 1808 版或更新版本相容。

• com.microsoft.azure：包含所有服務最新版本的配置檔。 使用所有服務的最新版本。

如需 Azure Stack Hub 和 API 配置檔的詳細資訊，請參閱 API 設定檔的摘要。

Azure Java SDK API 設定檔使用量

下列程式代碼會驗證 Azure Stack Hub 上的服務主體。 它會使用租使用者標識碼和驗證基底來建立令牌，這是 Azure Stack Hub 特有的：

AzureTokenCredentials credentials = new ApplicationTokenCredentials(client, tenant, key, AZURE_STACK)
                    .withDefaultSubscriptionID(subscriptionID);
Azure azureStack = Azure.configure()
                    .withLogLevel(com.microsoft.rest.LogLevel.BASIC)
                    .authenticate(credentials, credentials.defaultSubscriptionID());

此程式代碼可讓您使用 API 設定檔相依性，將應用程式成功部署至 Azure Stack Hub。

定義 Azure Stack Hub 環境設定函式

若要向正確的端點註冊 Azure Stack Hub 雲端，請使用下列程式代碼：

// Get Azure Stack Hub cloud endpoints
final HashMap<String, String> settings = getActiveDirectorySettings(armEndpoint);

AzureEnvironment AZURE_STACK = new AzureEnvironment(new HashMap<String, String>() {
                {
                    put("managementEndpointUrl", settings.get("audience"));
                    put("resourceManagerEndpointUrl", armEndpoint);
                    put("galleryEndpointUrl", settings.get("galleryEndpoint"));
                    put("activeDirectoryEndpointUrl", settings.get("login_endpoint"));
                    put("activeDirectoryResourceID", settings.get("audience"));
                    put("activeDirectoryGraphResourceID", settings.get("graphEndpoint"));
                    put("storageEndpointSuffix", armEndpoint.substring(armEndpoint.indexOf('.')));
                    put("keyVaultDnsSuffix", ".vault" + armEndpoint.substring(armEndpoint.indexOf('.')));
                }
            });

先前 getActiveDirectorySettings 程式代碼中的呼叫會從元數據端點擷取端點。 它會從所進行的呼叫中指出環境變數：

public static HashMap<String, String> getActiveDirectorySettings(String armEndpoint) {

    HashMap<String, String> adSettings = new HashMap<String, String>();
    try {

        // create HTTP Client
        HttpClient httpClient = HttpClientBuilder.create().build();

        // Create new getRequest with below mentioned URL
        HttpGet getRequest = new HttpGet(String.format("%s/metadata/endpoints?api-version=1.0",
                             armEndpoint));

        // Add additional header to getRequest which accepts application/xml data
        getRequest.addHeader("accept", "application/xml");

        // Execute request and catch response
        HttpResponse response = httpClient.execute(getRequest);

        // Check for HTTP response code: 200 = success
        if (response.getStatusLine().getStatusCode() != 200) {
            throw new RuntimeException("Failed : HTTP error code : " + response.getStatusLine().getStatusCode());
        }

        String responseStr = EntityUtils.toString(response.getEntity());
        JSONObject responseJson = new JSONObject(responseStr);
        adSettings.put("galleryEndpoint", responseJson.getString("galleryEndpoint"));
        JSONObject authentication = (JSONObject) responseJson.get("authentication");
        String audience = authentication.get("audiences").toString().split("\"")[1];
        adSettings.put("login_endpoint", authentication.getString("loginEndpoint"));
        adSettings.put("audience", audience);
        adSettings.put("graphEndpoint", responseJson.getString("graphEndpoint"));

    } catch (ClientProtocolException cpe) {
        cpe.printStackTrace();
        throw new RuntimeException(cpe);
    } catch (IOException ioe) {
        ioe.printStackTrace();
        throw new RuntimeException(ioe);
    }
    return adSettings;
}

範例單元測試專案

1. 使用下列命令複製存放庫：

   git clone https://github.com/Azure-Samples/Hybrid-Java-Samples.git -b resourcegroup-2019-03-01-hybrid
   

2. 建立 Azure 服務主體，並指派角色以存取訂用帳戶。 如需建立服務主體的指示，請參閱 使用 Azure PowerShell 建立具有憑證的服務主體。

3. 擷取下列必要的環境變數：

   • AZURE_TENANT_ID
   • AZURE_CLIENT_ID
   • AZURE_CLIENT_SECRET
   • AZURE_SUBSCRIPTION_ID
   • ARM_ENDPOINT
   • RESOURCE_LOCATION

4. 使用從您使用命令提示字元建立的服務主體擷取的信息，設定下列環境變數：

   • export AZURE_TENANT_ID={your tenant ID}
   • export AZURE_CLIENT_ID={your client ID}
   • export AZURE_CLIENT_SECRET={your client secret}
   • export AZURE_SUBSCRIPTION_ID={your subscription ID}
   • export ARM_ENDPOINT={your Azure Stack Hub Resource Manager URL}
   • export RESOURCE_LOCATION={location of Azure Stack Hub}

   在 Windows 中，使用 set 而非 export。

5. 使用函式 getActiveDirectorySettings 來擷取 Azure Resource Manager 元數據端點。

   // Get Azure Stack Hub cloud endpoints
   final HashMap<String, String> settings = getActiveDirectorySettings(armEndpoint);
   

6. 在 Pom.xml 檔案中，新增下列相依性，以使用 Azure Stack Hub 的 2019-03-01-hybrid 配置檔。 此相依性會針對計算、網路、記憶體、Key Vault 和 App Services 資源提供者安裝與此設定檔相關聯的模組：

   <dependency>
     <groupId>com.microsoft.azure.profile_2019_03_01_hybrid</groupId>
     <artifactId>azure</artifactId>
     <version>1.0.0-beta-1</version>
   </dependency>
   

7. 開啟以設定環境變數的命令提示字元中，輸入下列命令：

   mvn clean compile exec:java
   

如需適用於 Azure Stack 版本或設定檔2008的範例，請參閱2019-03-01。