You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
75 lines
2.7 KiB
75 lines
2.7 KiB
3 years ago
|
# Read Me First
|
||
|
|
|
||
|
|
The following was discovered as part of building this project:
|
||
|
|
|
||
|
|
* The following dependency is not known to work with Spring Native: 'MS SQL Server Driver'. As a result, your
|
||
|
|
application may not work as expected.
|
||
|
|
|
||
|
|
# Getting Started
|
||
|
|
|
||
|
|
### Reference Documentation
|
||
|
|
|
||
|
|
For further reference, please consider the following sections:
|
||
|
|
|
||
|
|
* [Official Apache Maven documentation](https://maven.apache.org/guides/index.html)
|
||
|
|
* [Spring Boot Maven Plugin Reference Guide](https://docs.spring.io/spring-boot/docs/2.5.6/maven-plugin/reference/html/)
|
||
|
|
* [Create an OCI image](https://docs.spring.io/spring-boot/docs/2.5.6/maven-plugin/reference/html/#build-image)
|
||
|
|
* [Spring Web](https://docs.spring.io/spring-boot/docs/2.5.6/reference/htmlsingle/#boot-features-developing-web-applications)
|
||
|
|
* [Spring Native Reference Guide](https://docs.spring.io/spring-native/docs/current/reference/htmlsingle/)
|
||
|
|
|
||
|
|
### Guides
|
||
|
|
|
||
|
|
The following guides illustrate how to use some features concretely:
|
||
|
|
|
||
|
|
* [Building a RESTful Web Service](https://spring.io/guides/gs/rest-service/)
|
||
|
|
* [Serving Web Content with Spring MVC](https://spring.io/guides/gs/serving-web-content/)
|
||
|
|
* [Building REST services with Spring](https://spring.io/guides/tutorials/bookmarks/)
|
||
|
|
|
||
|
|
### Additional Links
|
||
|
|
|
||
|
|
These additional references should also help you:
|
||
|
|
|
||
|
|
* [Configure the Spring AOT Plugin](https://docs.spring.io/spring-native/docs/0.10.5/reference/htmlsingle/#spring-aot-maven)
|
||
|
|
|
||
|
|
## Spring Native
|
||
|
|
|
||
|
|
This project has been configured to let you generate either a lightweight container or a native executable.
|
||
|
|
|
||
|
|
### Lightweight Container with Cloud Native Buildpacks
|
||
|
|
|
||
|
|
If you're already familiar with Spring Boot container images support, this is the easiest way to get started with Spring
|
||
|
|
Native. Docker should be installed and configured on your machine prior to creating the image,
|
||
|
|
see [the Getting Started section of the reference guide](https://docs.spring.io/spring-native/docs/0.10.5/reference/htmlsingle/#getting-started-buildpacks)
|
||
|
|
.
|
||
|
|
|
||
|
|
To create the image, run the following goal:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ ./mvnw spring-boot:build-image
|
||
|
|
```
|
||
|
|
|
||
|
|
Then, you can run the app like any other container:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ docker run --rm -p 8080:8080 demo2:0.0.1-SNAPSHOT
|
||
|
|
```
|
||
|
|
|
||
|
|
### Executable with Native Build Tools
|
||
|
|
|
||
|
|
Use this option if you want to explore more options such as running your tests in a native image. The GraalVM
|
||
|
|
native-image compiler should be installed and configured on your machine,
|
||
|
|
see [the Getting Started section of the reference guide](https://docs.spring.io/spring-native/docs/0.10.5/reference/htmlsingle/#getting-started-native-build-tools)
|
||
|
|
.
|
||
|
|
|
||
|
|
To create the executable, run the following goal:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ ./mvnw package -Pnative
|
||
|
|
```
|
||
|
|
|
||
|
|
Then, you can run the app as follows:
|
||
|
|
|
||
|
|
```
|
||
|
|
$ target/demo2
|
||
|
|
```
|