Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add beta version dependencies local build step #19507

Merged
merged 8 commits into from
Mar 4, 2021
Merged
Show file tree
Hide file tree
Changes from 6 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ while protecting the identities of your customers at the same time.
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven](https://maven.apache.org/) 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # "{x-version-update-start;com.azure.spring:azure-spring-boot-starter-active-directory-b2c;current}"
Expand Down Expand Up @@ -235,3 +236,5 @@ Please follow [instructions here](https://github.com/Azure/azure-sdk-for-java/bl
[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK#use-logback-logging-framework-in-a-spring-boot-application
[azure_subscription]: https://azure.microsoft.com/free
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ The `azure-spring-boot-starter-active-directory` (`aad-starter` for short) provi
- [Azure Subscription][azure_subscription]
- [Maven](https://maven.apache.org/) 3.0 and above
- [Register an application in Azure Portal][register_an_application_in_portal]
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

## Key concepts

Expand Down Expand Up @@ -430,3 +431,5 @@ Please follow [instructions here] to build from source or contribute.
[register_an_application_in_portal]: https://docs.microsoft.com/azure/active-directory/develop/quickstart-register-app
[prerequisite]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/azure-spring-boot-starter-active-directory#prerequisites
[Accessing a web application]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/azure-spring-boot-starter-active-directory#accessing-a-web-application
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

3 changes: 3 additions & 0 deletions sdk/spring/azure-spring-boot-starter-cosmos/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven](https://maven.apache.org/) 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-boot-starter-cosmos;current})
Expand Down Expand Up @@ -299,3 +300,5 @@ Please follow [instructions here](https://github.com/Azure/azure-sdk-for-java/bl
[azure_subscription]: https://azure.microsoft.com/free
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[sample_cosmos_switch_key]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/cosmos/azure-spring-data-cosmos/src/samples/java/com/azure/spring/data/cosmos/SampleApplication.java
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

3 changes: 3 additions & 0 deletions sdk/spring/azure-spring-boot-starter-data-gremlin/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ The Spring Data Gremlin Starter provides Spring Data support for the Gremlin que
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven](https://maven.apache.org/) 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-boot-starter-data-gremlin;current})
Expand Down Expand Up @@ -233,3 +234,5 @@ Please follow [instructions here](https://github.com/Azure/azure-sdk-for-java/bl
[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK#use-logback-logging-framework-in-a-spring-boot-application
[azure_subscription]: https://azure.microsoft.com/free
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Azure Key Vault Certificates Spring Boot Starter is Spring starter for [Azure Ke
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven](https://maven.apache.org/) 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-boot-starter-keyvault-certificates;current})
Expand Down Expand Up @@ -400,3 +401,5 @@ Please follow [instructions here](https://github.com/Azure/azure-sdk-for-java/bl
[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK#use-logback-logging-framework-in-a-spring-boot-application
[azure_subscription]: https://azure.microsoft.com/free
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ Azure Key Vault Secrets Spring Boot Starter is Spring starter for [Azure Key Vau
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven](https://maven.apache.org/) 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-boot-starter-keyvault-secrets;current})
Expand Down Expand Up @@ -211,3 +212,5 @@ Please follow [instructions here](https://github.com/Azure/azure-sdk-for-java/bl
[azure_subscription]: https://azure.microsoft.com/free
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[version_link]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/keyvault/azure-security-keyvault-secrets/src/main/java/com/azure/security/keyvault/secrets/SecretServiceVersion.java#L12
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

3 changes: 3 additions & 0 deletions sdk/spring/azure-spring-boot-starter-servicebus-jms/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ With this starter you could easily use Spring JMS Queue and Topic with Azure Ser
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven](https://maven.apache.org/) 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-boot-starter-servicebus-jms;current})
Expand Down Expand Up @@ -230,3 +231,5 @@ Please follow [instructions here](https://github.com/Azure/azure-sdk-for-java/bl
[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK#use-logback-logging-framework-in-a-spring-boot-application
[azure_subscription]: https://azure.microsoft.com/free
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

2 changes: 2 additions & 0 deletions sdk/spring/azure-spring-boot-starter-storage/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ The project provides a Spring Boot Starter `azure-spring-boot-starter-storage` t
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven][maven] 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-boot-starter-storage;current})
Expand Down Expand Up @@ -129,3 +130,4 @@ Please follow [instructions here][contributing_md] to build from source or contr
[azure_storage]: https://azure.microsoft.com/services/storage/blobs/
[other_operation]: https://docs.spring.io/spring/docs/current/spring-framework-reference/core.html#resources
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md
2 changes: 2 additions & 0 deletions sdk/spring/azure-spring-boot-starter/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ This repository is for Spring Boot Starters of Azure services. It helps Spring B
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven](https://maven.apache.org/) 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the Package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-boot-starter;current})
Expand Down Expand Up @@ -80,3 +81,4 @@ Please follow [instructions here](https://github.com/Azure/azure-sdk-for-java/bl
[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK#use-logback-logging-framework-in-a-spring-boot-application
[azure_subscription]: https://azure.microsoft.com/free
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md
3 changes: 3 additions & 0 deletions sdk/spring/azure-spring-cloud-starter-cache/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ This starter provides auto-configuration of Azure Cache for Redis. Azure Cache f
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven][maven] 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-cloud-starter-cache;current})
Expand Down Expand Up @@ -65,3 +66,5 @@ Please follow [instructions here][contributing_md] to build from source or contr
[contributing_md]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/CONTRIBUTING.md
[maven]: https://maven.apache.org/
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ The Spring Cloud Stream Kafka binder for Azure Event Hubs helps developers to fi
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven][maven] 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-cloud-starter-eventhubs-kafka;current})
Expand Down Expand Up @@ -66,3 +67,5 @@ Please follow [instructions here][contributing_md] to build from source or contr
[contributing_md]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/CONTRIBUTING.md
[maven]: https://maven.apache.org/
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

3 changes: 3 additions & 0 deletions sdk/spring/azure-spring-cloud-starter-eventhubs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ For Spring Integration on Event Hubs, please refer to the [source code][source_c
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven][maven] 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-cloud-starter-eventhubs;current})
Expand Down Expand Up @@ -69,3 +70,5 @@ Please follow [instructions here][contributing_md] to build from source or contr
[maven]: https://maven.apache.org/
[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/azure-spring-integration-eventhubs
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

3 changes: 3 additions & 0 deletions sdk/spring/azure-spring-cloud-starter-servicebus/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ The Spring Cloud Service Bus starter helps developers to finish the auto-configu
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven][maven] 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-cloud-starter-servicebus;current})
Expand Down Expand Up @@ -69,3 +70,5 @@ Please follow [instructions here][contributing_md] to build from source or contr
[spring_integration]: https://spring.io/projects/spring-integration
[spring_cloud_starter_sample_with_service_bus]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/azure-spring-boot-samples/azure-spring-integration-sample-servicebus
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

3 changes: 3 additions & 0 deletions sdk/spring/azure-spring-cloud-starter-storage-queue/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ The Spring Cloud Storage Queue starter helps developers to finish the auto-confi
- [Java Development Kit (JDK)][jdk_link] with version 8 or above
- [Azure Subscription][azure_subscription]
- [Maven][maven] 3.0 and above
- [Build developing version artifacts if needed][build-developing-version-artifacts-if-needed]

### Include the package
[//]: # ({x-version-update-start;com.azure.spring:azure-spring-cloud-starter-storage-queue;current})
Expand Down Expand Up @@ -68,3 +69,5 @@ Please follow [instructions here][contributing_md] to build from source or contr
[contributing_md]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/CONTRIBUTING.md
[maven]: https://maven.apache.org/
[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
[build-developing-version-artifacts-if-needed]: https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/spring/build-developing-version-artifacts-if-needed.md

29 changes: 29 additions & 0 deletions sdk/spring/build-developing-version-artifacts-if-needed.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
### Released version

We **highly recommend** you refer to the `README.md` files of the released versions.

Here are the steps to get `README.md` files of the released version:

1 On GitHub, navigate to the main page of the repository.
2 Click the `master` button, then click `Tags`.
3 In the "Find a tag" text box, input and enter the starter module name you want to search, such as `azure-spring-boot-starter-xxx`.
![Search for tag](images/search-for-tag.png "Search for a tag")
4 Click one of the searched tags. (You will find that the address in your browser bar changes to that specific version. You can manually edit the address with other versions, then quickly switch to other versions.)
![Tag main page](images/tag-main-page.png "Main page of a tag")
5 Then check the README.md file there.
michaelqi793 marked this conversation as resolved.
Show resolved Hide resolved


### Developing version

If you want to use the latest function in master branch, you can build the artifacts by yourself.

For example, if you want to build latest `azure-spring-boot-starter-active-directory`, you can execute commands:
michaelqi793 marked this conversation as resolved.
Show resolved Hide resolved

```shell script
cd azure-sdk-for-java
mvn clean install -pl .\sdk\spring\azure-spring-boot-starter-active-directory\ -am
```
michaelqi793 marked this conversation as resolved.
Show resolved Hide resolved

You can refer [Maven CLI Options] for more detail about `-pl` and `-am`.
michaelqi793 marked this conversation as resolved.
Show resolved Hide resolved

[Maven CLI Options]: https://maven.apache.org/ref/3.1.0/maven-embedder/cli.html
Binary file added sdk/spring/images/search-for-tag.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added sdk/spring/images/tag-main-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.