aws部署ssh_将Quarkus应用程序部署到AWS Elastic Beanstalk

朱雀 2023-02-25 03:58 158阅读 0赞

aws部署ssh

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][https]

## TL; DR：创建软件包并上传到Elastic Beanstalk ##

### 在Elastic Beanstalk控制台中创建新应用程序 ###

如果您还不是AWS客户，则需要创建一个AWS账户。 通过注册，您可以访问Elastic Beanstalk和其他所需的AWS服务。

*  使用以下链接打开Elastic Beanstalk控制台： [https][https 1] ://us-west-2.console.aws.amazon.com/elasticbeanstalk/home?region=us-west-2\#/gettingStarted?applicationName [=Pet诊所API][https 1]
 *  对于`Platform`选择`Docker`
 *  对于`Application Code`选择`Sample Application`
 *  选择`Configure more options`
    
     *  在列表中找到`Database` ，然后单击`Modify`
 *  点击`Create app`

Elastic Beanstalk将为您创建具有所有必需资源（包括RDS）的示例应用程序。

创建应用程序后，您将可以看到该应用程序的链接。

注意：以上步骤基于官方文档： [https][https 2] : [//docs.aws.amazon.com/elasticbeanstalk/latest/dg/GettingStarted.CreateApp.html][https 2]

### 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][https_console.aws.amazon.com_elasticbeanstalk]

而已。 在下一段中，您将学习如何使用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][https 3] : [//docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.managing.db.html][https 3]

### `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]

## 参考资料 ##

*  [https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/single-container-docker.html][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 3]
 *  [https://quarkus.io/guides/config\#package-and-run-the-application][https_quarkus.io_guides_config_package-and-run-the-application]

## 也可以看看 ##

*  Quarkus入门
 *  使用Testcontainers和PostgreSQL进行Quarkus测试

> 翻译自: [https://www.javacodegeeks.com/2020/03/deploy-quarkus-application-to-aws-elastic-beanstalk.html][https_www.javacodegeeks.com_2020_03_deploy-quarkus-application-to-aws-elastic-beanstalk.html]

aws部署ssh

[https]: https://github.com/kolorobot/quarkus-petclinic-api
[https 1]: https://us-west-2.console.aws.amazon.com/elasticbeanstalk/home?region=us-west-2#/gettingStarted?applicationName=Pet%20Clinic%20API
[https 2]: https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/GettingStarted.CreateApp.html
[https_console.aws.amazon.com_elasticbeanstalk]: https://console.aws.amazon.com/elasticbeanstalk
[https 3]: https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/using-features.managing.db.html
[https_docs.aws.amazon.com_elasticbeanstalk_latest_dg_single-container-docker.html]: https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/single-container-docker.html
[https_quarkus.io_guides_config_package-and-run-the-application]: https://quarkus.io/guides/config#package-and-run-the-application
[https_www.javacodegeeks.com_2020_03_deploy-quarkus-application-to-aws-elastic-beanstalk.html]: https://www.javacodegeeks.com/2020/03/deploy-quarkus-application-to-aws-elastic-beanstalk.html