Elastic Beanstalk允许在AWS云中部署和管理应用程序，而无需了解运行这些应用程序的基础架构。
使用Elastic Beanstalk，您可以运行可处理HTTP请求的网站，Web应用程序或Web API，但也可以运行辅助应用程序以运行长任务。 Elastic Beanstalk支持多个预配置平台，包括Go ， .NET或Java （仅Java 8），也支持通用Docker平台。
您只需使用AWS CLI ， AWS EB CLI或Elastic Beanstack console上传应用程序，然后Elastic Beanstalk即可自动处理其余部分。
在此博客文章中，您将学习如何在Elastic Beanstalk上使用基于Quarkus的应用程序启动单容器Docker环境。
注意：此博客没有描述从头开始创建应用程序。 相反，它基于我为Quarkus入门博客文章创建的Quarkus Pet Clinic REST API应用程序 。 可以在Github上找到源代码： https : //github.com/kolorobot/quarkus-petclinic-api
TL; DR：创建软件包并上传到Elastic Beanstalk
在Elastic Beanstalk控制台中创建新的应用程序
如果您还不是AWS客户，则需要创建一个AWS账户。 通过注册，您可以访问Elastic Beanstalk和其他所需的AWS服务。
- 使用以下链接打开Elastic Beanstalk控制台： https ://us-west-2.console.aws.amazon.com/elasticbeanstalk/home?region=us-west-2#/gettingStarted?applicationName =Pet Clinic API
- 对于
Platform选择Docker - 对于
Application Code选择Sample Application - 选择
Configure more options- 在列表中找到
Database，然后单击Modify - 对于
Engine选择postgres - 对于
Engine version选择11.6 - 设置您选择的
username和password - 对于
Retention如果您不创建快照主机，请选择Delete。 - 点击
Save。
- 在列表中找到
- 点击
Create app
Elastic Beanstalk将使用所有必需的资源（包括RDS）为您创建示例应用程序。
创建应用程序后，您将可以看到该应用程序的链接。
注意：以上步骤基于官方文档： https : //docs.aws.amazon.com/elasticbeanstalk/latest/dg/GettingStarted.CreateApp.html
Preapare应用程序包
- 克隆存储库
git clone https: //github.com/kolorobot/quarkus-petclinic-api - 导航到应用程序目录并执行：
./mvnw clean package assembly:single -Dquarkus. package .uber-jar= true 上面的命令创建具有以下内容的软件包：
$ unzip -l target/quarkus-petclinic-api- 1.0 . 1 -eb.zip Archive: target/quarkus-petclinic-api- 1.0 . 1 -eb.zip
Length Date Time Name --------- ---------- ----- ----
0 03 - 15 - 2020 13 : 35 config/
2059 03 - 15 - 2020 13 : 34 Dockerfile
369 03 - 15 - 2020 13 : 34 config/application.properties
38604205 03 - 15 - 2020 13 : 35 quarkus-petclinic-api- 1.0 . 1 -runner.jar --------- -------
38606633 4 files 将应用程序上传到Elastic Beanstalk
- 使用Elastic Beanstalk控制台上传软件包
- 导航到https://console.aws.amazon.com/elasticbeanstalk
- 导航到应用程序仪表板
- 点击
Upload and Deploy - 选择上一步中创建的包，然后单击
Deploy - 等待应用程序部署
而已。 在下一段中，您将学习如何使用Maven准备软件包。
循序渐进：为Elastic Beanstalk配置应用程序
运行时配置
让我们从特定于Elastic Beanstalk环境的应用程序配置开始。
Quarkus提供了几种在运行时覆盖属性的选项。 我决定将这种方法与配置文件一起放在config/application.properties文件中。 Quarkus将自动读取该文件，并且该文件中的所有属性都优先于默认值。
创建src/main/resources/application-eb.properties文件，并将quarkus.http.port设置为5000因为这是Elastic Beanstalk Web应用程序的默认端口。
随着应用程序将连接到RDS（PostgreSQL），下一个属性与数据源配置有关。 RDS实例的连接信息可通过运行容器可用的RDS_*环境属性提供给在Elastic Beanstalk上运行的应用程序。 要使用此属性，请设置以下属性：
quarkus.datasource.url=jdbc:postgresql: //${RDS_HOSTNAME}:${RDS_PORT}/${RDS_DB_NAME} quarkus.datasource.username=${RDS_USERNAME} quarkus.datasource.password=${RDS_PASSWORD} 阅读有关将应用程序连接到RDS的更多信息： https : //docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.managing.db.html
Dockerfile
Elastic Beanstalk使用Dockerfile构建和运行映像。 该文件必须位于应用程序目录的root目录中。 我使用了原始的src/main/docker/Dockerfile.jvm并进行了以下调整：
- 将
config/application.properties复制到容器 - 暴露端口
5000而不是8080
完整的src/main/docker/Dockerfile.eb ：
FROM registry.access.redhat.com/ubi8/ubi-minimal: 8.1 ARG JAVA_PACKAGE=java- 11 -openjdk-headless ARG RUN_JAVA_VERSION= 1.3 . 5 ENV LANG= 'en_US.UTF-8' LANGUAGE= 'en_US:en' # Install java and the run-java script # Also set up permissions for user ` 1001 ` RUN microdnf install openssl curl ca-certificates ${JAVA_PACKAGE} \
&& microdnf update \
&& microdnf clean all \
&& mkdir /deployments \
&& chown 1001 /deployments \
&& chmod "g+rwX" /deployments \
&& chown 1001 :root /deployments \
&& curl https: //repo1.maven.org/maven2/io/fabric8/run-java-sh/${RUN_JAVA_VERSION}/run-java-sh-${RUN_JAVA_VERSION}-sh.sh -o /deployments/run-java.sh \
&& chown 1001 /deployments/run-java.sh \
&& chmod 540 /deployments/run-java.sh \
&& echo "securerandom.source=file:/dev/urandom" >> /etc/alternatives/jre/lib/security/java.security ENV JAVA_OPTIONS= "-Djava.util.logging.manager=org.jboss.logmanager.LogManager" COPY *-runner.jar /deployments/app.jar COPY config /deployments/config EXPOSE 5000 USER 1001 ENTRYPOINT [ "/deployments/run-java.sh" ] 使用Maven创建应用程序包
到目前为止，已创建以下两个文件：
-
src/main/resources/application-eb.properties具有特定于Elastic Beanstalk环境的属性 -
src/main/docker/Dockerfile.eb具有用于Elastic Beanstack环境的容器配置。
要完成配置和配置程序包组装，我们将使用“ Copy Rename Maven Plugin和“ Maven Assembly Plugin 。
准备组装文件
修改pom.xml并添加复制和重命名将存储在最终应用程序包zip文件中的文件的目标：
< build >
< plugin >
< groupId >com.coderplus.maven.plugins</ groupId >
< artifactId >copy-rename-maven-plugin</ artifactId >
< version >1.0</ version >
< executions >
< execution >
< id >copy-file</ id >
< phase >package</ phase >
< goals >
< goal >copy</ goal >
</ goals >
< configuration >
< fileSets >
< fileSet >
< sourceFile >src/main/resources/application-eb.properties</ sourceFile >
< destinationFile >target/eb/application.properties</ destinationFile >
</ fileSet >
< fileSet >
< sourceFile >src/main/docker/Dockerfile.eb</ sourceFile >
< destinationFile >target/eb/Dockerfile</ destinationFile >
</ fileSet >
</ fileSets >
</ configuration >
</ execution >
</ executions >
</ plugin > </ build > copy-file目标将在package阶段运行，并将先前创建的文件（名称已调整）复制到target/eb 。
配置程序集插件
Maven Assembly Plugin将用于创建应用程序包。 将以下配置添加到pom.xml ：
< build >
< plugin >
< artifactId >maven-assembly-plugin</ artifactId >
< version >3.2.0</ version >
< configuration >
< descriptors >
< descriptor >src/assembly/eb.xml</ descriptor >
</ descriptors >
</ configuration >
</ plugin > </ build > 现在，创建src/assembly/eb.xml指示所述组件插件来创建一个描述符zip含有Dockerfile ， config/application.properties和Quarkus uber-jar 。 所有这三个文件将位于存档的root中：
< assembly >
< id >eb</ id >
< formats >
< format >zip</ format >
</ formats >
< includeBaseDirectory >false</ includeBaseDirectory >
< files >
< file >
< source >target/eb/Dockerfile</ source >
< outputDirectory ></ outputDirectory >
< filtered >false</ filtered >
</ file >
< file >
< source >target/eb/application.properties</ source >
< outputDirectory >config</ outputDirectory >
< filtered >false</ filtered >
</ file >
< file >
< source >target/${project.build.finalName}-runner.jar</ source >
< outputDirectory ></ outputDirectory >
< filtered >false</ filtered >
</ file >
</ files > </ assembly > 这样就完成了配置。 现在，您可以通过运行以下命令创建包（程序集）：
经过以上所有更改，我们可以创建程序包：
./mvnw clean package assembly:single -Dquarkus. package .uber-jar= true 在本地测试软件包
要在本地测试包，请运行：
unzip target/quarkus-petclinic-api- 1.0 . 1 -eb.zip -d target/eb-dist && cd target/eb-dist docker build -t quarkus/petclinic-api-jvm-eb . 在运行容器之前，请启动数据库：
docker run -it --name petclinic-db -p 5432 : 5432 -e POSTGRES_DB=petclinic -e POSTGRES_USER=petclinic -e POSTGRES_PASSWORD=petclinic -d postgres: 11.6 -alpine 运行传递RDS环境变量的应用程序并链接到数据库容器：
docker run -i --rm -p 8080 : 5000 --link petclinic-db -e RDS_HOSTNAME=petclinic-db -e RDS_PORT= 5432 -e RDS_DB_NAME=petclinic -e RDS_USERNAME=petclinic -e RDS_PASSWORD=petclinic quarkus/petclinic-api-jvm-eb 在浏览器中打开http://localhost:8080 ，您应该会看到主页。
源代码
可以在Github上找到本文的源代码： https : //github.com/kolorobot/quarkus-petclinic-api
参考文献
- https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/single-container-docker.html
- https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.managing.db.html
- https://quarkus.io/guides/config#package-and-run-the-application
也可以看看
翻译自: https://www.javacodegeeks.com/2020/03/deploy-quarkus-application-to-aws-elastic-beanstalk.html