Skip to content

Commit c9158f7

Browse files
committed
On branch dd-2275862 Copyeding. Please take out of DRAFT state.
modified: articles/storage/blobs/TOC.yml - Differentiate between Java SE, Spring Boot and Quarkus as flavors of what Microsoft thnks of as "Java". modified: articles/storage/blobs/storage-quickstart-blobs-java-quarkus.md - Declare dependency on Azure CLI. - Warn about using local file storage. - Add **Clean up** section. - Add **Next steps** links to deploy the app the reader just created. modified: articles/storage/blobs/storage-quickstart-blobs-java.md - Clarify that this article applies to Java SE. The other two articles, about Spring and Quarkus, also apply to Java. Therefore, this article became incorrectly named as soon as an article about Spring was added. It became even more incorrectly named when an artile about Quarkus was adde. All three articles are about Java. modified: includes/assign-roles.md - Include a link to Storage Blob Data Contributor reading. Signed-off-by: Ed Burns <[email protected]>
1 parent c41bacc commit c9158f7

File tree

4 files changed

+29
-16
lines changed

4 files changed

+29
-16
lines changed

articles/storage/blobs/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,9 @@ items:
3434
href: storage-quickstart-blobs-dotnet.md
3535
- name: Java
3636
items:
37-
- name: Java
37+
- name: Java SE
3838
href: storage-quickstart-blobs-java.md
39-
- name: Spring
39+
- name: Spring Boot
4040
href: /azure/developer/java/spring-framework/configure-spring-boot-starter-java-app-with-azure-storage?toc=/azure/storage/blobs/toc.json
4141
- name: Quarkus
4242
href: storage-quickstart-blobs-java-quarkus.md

articles/storage/blobs/storage-quickstart-blobs-java-quarkus.md

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,11 @@ Get started with the Quarkus extension for Azure Blob Storage to manage blobs an
1818

1919
## Prerequisites
2020

21-
- Azure account with an active subscription - [create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio)
21+
- Azure account with an active subscription - [create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
22+
- Azure CLI - [Install the Azure CLI](/cli/azure/install-azure-cli) 2.62.0 or above to run Azure CLI commands.
2223
- Azure Storage account - [create a storage account](../common/storage-account-create.md).
23-
- [Java Development Kit (JDK)](/java/azure/jdk/) version 17 or above
24-
- [Apache Maven](https://maven.apache.org/download.cgi)
24+
- [Java Development Kit (JDK)](/java/azure/jdk/) version 17 or above.
25+
- [Apache Maven](https://maven.apache.org/download.cgi).
2526

2627
## Setting up
2728

@@ -81,13 +82,13 @@ You can authorize access to data in your storage account using the following ste
8182

8283
The code example performs the following actions:
8384

84-
- Injects a client object that is already authorized for data access via `DefaultAzureCredential` using the Quarkus extension for Azure Blob Storage
85-
- Creates a container in a storage account
86-
- Uploads a blob to the container
87-
- Lists the blobs in the container
88-
- Downloads the blob data to the local file system
89-
- Deletes the blob and container resources created by the app
90-
- Deleting the local source and downloaded files
85+
- Injects a client object that is already authorized for data access via `DefaultAzureCredential` using the Quarkus extension for Azure Blob Storage.
86+
- Creates a container in a storage account.
87+
- Uploads a blob to the container.
88+
- Lists the blobs in the container.
89+
- Downloads the blob data to the local file system.
90+
- Deletes the blob and container resources created by the app.
91+
- Deleting the local source and downloaded files.
9192

9293
Run the application in JVM mode using the following command:
9394

@@ -186,7 +187,10 @@ This is all you need to code to get a client object using the Quarkus extension
186187

187188
### Manage blobs and containers
188189

189-
The following code snippet shows how to create a container, upload a blob, list blobs in a container, and download a blob:
190+
The following code snippet shows how to create a container, upload a blob, list blobs in a container, and download a blob.
191+
192+
> [!NOTE]
193+
> Writing to the local filesystem is considered a bad practice in cloud native applications. However, the sample uses the local filesystem to illustrate the use of blob storage in a way that is easy to for the user to verify. If taking an application to production, review your storage options and choose the best option for your needs. See [Review your storage options](/azure/architecture/guide/technology-choices/storage-options).
190194
191195
```java
192196
// Create a unique name for the container
@@ -262,7 +266,13 @@ These operations are similar to the [Quickstart: Azure Blob Storage client libra
262266
- [Download blobs](storage-quickstart-blobs-java.md#download-blobs)
263267
- [Delete a container](storage-quickstart-blobs-java.md#delete-a-container)
264268

265-
## Next step
269+
## Clean up
270+
271+
You can choose to follow the links in the **Next steps** section to deploy the Quarkus application to Azure. Or you can clean up the storage account by deleting the resource group. For more information, see [Azure Resource Manager resource group and resource deletion](/azure/azure-resource-manager/management/delete-resource-group).
272+
273+
## Next steps
266274

267275
> [!div class="nextstepaction"]
268276
> [Azure Storage samples and developer guides for Java](../common/storage-samples-java.md?toc=/azure/storage/blobs/toc.json)
277+
> [Deploy a Java application with Quarkus on an Azure Kubernetes Service cluster](/azure/aks/howto-deploy-java-quarkus-app)
278+
> [Deploy a Java application with Quarkus on Azure Container Apps](https://learn.microsoft.com/en-us/azure/developer/java/ee/deploy-java-quarkus-app)

articles/storage/blobs/storage-quickstart-blobs-java.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.devlang: java
1111
zone_pivot_groups: azure-blob-storage-quickstart-options
1212
---
1313

14-
# Quickstart: Azure Blob Storage client library for Java
14+
# Quickstart: Azure Blob Storage client library for Java SE
1515

1616
::: zone pivot="blob-storage-quickstart-scratch"
1717

@@ -612,3 +612,6 @@ You'll be prompted to confirm the deletion of the resources. Enter `y` to confir
612612

613613
> [!div class="nextstepaction"]
614614
> [Azure Storage samples and developer guides for Java](../common/storage-samples-java.md?toc=/azure/storage/blobs/toc.json)
615+
> [Azure Storage samples and developer guides for Java](../common/storage-samples-java.md?toc=/azure/storage/blobs/toc.json)
616+
> [Quickstart: Quarkus extension for Azure Blob Storage](storage-quickstart-blobs-java-quarkus)
617+
> [Use Spring Boot to upload a file to Azure Blob Storage](/azure/developer/java/spring-framework/configure-spring-boot-starter-java-app-with-azure-storage?toc=/azure/storage/blobs/toc.json)

includes/assign-roles.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.author: alexwolf
1010
ms.custom: include file
1111
---
1212

13-
When developing locally, make sure that the user account that is accessing blob data has the correct permissions. You'll need **Storage Blob Data Contributor** to read and write blob data. To assign yourself this role, you'll need to be assigned the **User Access Administrator** role, or another role that includes the **Microsoft.Authorization/roleAssignments/write** action. You can assign Azure RBAC roles to a user using the Azure portal, Azure CLI, or Azure PowerShell. You can learn more about the available scopes for role assignments on the [scope overview](../articles/role-based-access-control/scope-overview.md) page.
13+
When developing locally, make sure that the user account that is accessing blob data has the correct permissions. You'll need **Storage Blob Data Contributor** to read and write blob data. To assign yourself this role, you'll need to be assigned the **User Access Administrator** role, or another role that includes the **Microsoft.Authorization/roleAssignments/write** action. You can assign Azure RBAC roles to a user using the Azure portal, Azure CLI, or Azure PowerShell. You can learn more about the Storage Blob Data Contributor role in [Storage Blob Data Contributor](/azure/role-based-access-control/built-in-roles/storage#storage-blob-data-contributor). You can learn more about the available scopes for role assignments on the [scope overview](../articles/role-based-access-control/scope-overview.md) page.
1414

1515
In this scenario, you'll assign permissions to your user account, scoped to the storage account, to follow the [Principle of Least Privilege](../articles/active-directory/develop/secure-least-privileged-access.md). This practice gives users only the minimum permissions needed and creates more secure production environments.
1616

0 commit comments

Comments
 (0)