Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hiperium/cities-module
Administration module for Smart Cities information and configuration for the Hiperium Project.
https://github.com/hiperium/cities-module
aws-dynamodb aws-lambda aws-sam docker graalvm java localstack maven shell-scripts spring-boot spring-cloud-function spring-native testcontainers
Last synced: 21 days ago
JSON representation
Administration module for Smart Cities information and configuration for the Hiperium Project.
- Host: GitHub
- URL: https://github.com/hiperium/cities-module
- Owner: hiperium
- License: agpl-3.0
- Created: 2024-07-20T02:54:06.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-08-23T22:24:22.000Z (2 months ago)
- Last Synced: 2024-08-23T23:34:11.774Z (2 months ago)
- Topics: aws-dynamodb, aws-lambda, aws-sam, docker, graalvm, java, localstack, maven, shell-scripts, spring-boot, spring-cloud-function, spring-native, testcontainers
- Language: Java
- Homepage:
- Size: 643 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
### Hiperium City Management.
* **Author**: [Andres Solorzano](https://www.linkedin.com/in/aosolorzano/).
* **Level**: 300 - Senior.
* **Technologies**: GraalVM, Spring Boot, Spring Cloud, Spring Native, Spring Modulith, Docker, Testcontainers, LocalStack, Amazon DynamoDB, AWS Lambda, and AWS SAM.
---
### Description.
This project uses Spring Cloud Functions to create an AWS Lambda Function for the Hiperium City Management module.
---
### Prerequisites.
- Git.
- AWS SAM CLI.
- GraalVM with OpenJDK (version 21.+). You can use SDKMAN.
- Apache Maven. You can install it using SDKMAN.
- Docker Engine with the Compose Plugin.
---
### Project Structure.
The project is divided into the following files/directories:
- **functions**: Directory used Lambda functions.
- **utils**: Directory used for script files and other project documentation.
---
### GraalVM Tracing Agent.
The Tracing Agent monitors our application’s behavior to see what classes, methods, and resources are being accessed dynamically.
Then, it outputs configuration files that describe this dynamic behavior.
These config files can be provided to the native-image utility when building a native image.
First, execute the following command from the `project's root` directory to start the application with the Tracing Agent:
```bash
mvn clean process-classes \
-f functions/city-read-function/pom.xml \
-P tracing-agent
```
Then, navigate to the `functions/city-read-function/src/test/http/local.http` file, and execute the requests
to the deployed function.
At this point, the Tracing Agent will generate the necessary configuration files for the native-image utility.
You can exit the application after the request is completed by pressing `Ctrl+C`.
Finally, copy the output files into the `META-INF/native-image` directory to be included by the native-image utility:
```bash
cp -rf functions/city-read-function/target/native-image/* \
functions/city-read-function/src/main/resources/META-INF/native-image
```
After this, you can build the native image using as usual and make tests with the AWS Lambda Function.
---
### Deployment Options.
So far, we have only one deployment option for the Lambda Function as this project is in development.
This option is using SAM CLI to deploy the Lambda Function to AWS.
You can execute the following script to show you the deployment options:
```bash
./setup.sh
```
Select the default option to deploy the Lambda Function to AWS.
---
### Maven Parent overrides
Due to Maven's design, elements are inherited from the parent POM to the project POM.
While most of the inheritance is fine, it also inherits unwanted elements like `` and `` from the parent.
To prevent this, the project POM contains empty overrides for these elements.
If you manually switch to a different parent and actually want the inheritance, you need to remove those overrides.