跳到主要內容

如何在 AWS Elastic Beanstalk上部屬Node.js應用程式(快速入門)



前言

以下的教學將手把手帶著大家把Nodejs應用程式部屬到AWS Elastic Beanstalk上面, 文章若有不清楚的地方也歡迎大家在文章底下留言反應

以下教學將會使用到aws cli,以及 awseb cli


首先, 安裝CLI工具

apt-get update
apt-get install python-pip
apt-get install awscli
apt-get install awsebcli

設定CLI工具

aws configure
填入region, id, key


工具的設定好之後, 接下來要帶著大家在Elastic Beanstalk上面建立以下資源


1. 建立Application

首先在Elastic Beanstalk建立應用程式基本資料, 我們可以在這邊給應用程式一個名子, 以及相關描述

appname="andytestawseb12345"
aws elasticbeanstalk create-application \
    --application-name $appname \
    --description "my application"

2. 建立Application version

在這邊可以任意地定義部屬的應用程式版本

appver="dev"
aws elasticbeanstalk create-application-version \
    --application-name $appname \
    --version-label $appver
輸出結果
{
    "ApplicationVersion": {
        "ApplicationName": "andytestawseb12345",
        "Status": "UNPROCESSED",
        "VersionLabel": "dev",
        "ApplicationVersionArn": "arn:aws:elasticbeanstalk:us-east-2:900616790362:applicationversion/andytestawseb12345/dev",
        "DateCreated": "2019-07-20T12:38:04.503Z",
        "DateUpdated": "2019-07-20T12:38:04.503Z",
        "SourceBundle": {
            "S3Bucket": "elasticbeanstalk-us-east-2",
            "S3Key": "GenericSampleApplication"
        }
    }
}

3. 建立Configuration Template

在AWS portal上有個頁面可以用來設定部屬的相關環境, 如EC2的instance種類, 以及將要部屬的instance數量 ,,,等等如下



而Portal上的操作可以簡化成以下的指令


cfgName="t2vmcfg"
aws elasticbeanstalk create-configuration-template \
--application-name $appname  \
--template-name $cfgName \
--solution-stack-name "64bit Amazon Linux 2018.03 v4.9.2 running Node.js" \
--option-settings \
    "ResourceName=AWSEBAutoScalingGroup,Namespace=aws:autoscaling:asg,OptionName=MinSize,Value=2" \
    "Namespace=aws:autoscaling:launchconfiguration,OptionName=InstanceType,Value=t2.micro"
輸出結果
{
    "ApplicationName": "andytestawseb12345",
    "PlatformArn": "arn:aws:elasticbeanstalk:us-east-2::platform/Node.js running on 64bit Amazon Linux/4.9.2",
    "TemplateName": "t2vmcfg",
    "DateCreated": "2019-07-20T12:42:05Z",
    "DateUpdated": "2019-07-20T12:42:05Z",
    "SolutionStackName": "64bit Amazon Linux 2018.03 v4.9.2 running Node.js"
}

4. 建立Environment

當app基本資料還有部屬的相關環境設定都建置完後, 接下來就是執行以下指令, 將部屬環境建起來

aws elasticbeanstalk create-environment \
    --cname-prefix $appname \
    --application-name $appname \
    --template-name $cfgName \
    --version-label $appver \
    --environment-name $appname \
    --option-settings Namespace="aws:autoscaling:launchconfiguration",OptionName="IamInstanceProfile",Value="aws-elasticbeanstalk-ec2-role"

輸出結果
{
    "ApplicationName": "andytestawseb12345",
    "EnvironmentName": "andytestawseb12345",
    "VersionLabel": "dev",
    "Status": "Launching",
    "EnvironmentArn": "arn:aws:elasticbeanstalk:us-east-2:900616790362:environment/andytestawseb12345/andytestawseb12345",
    "PlatformArn": "arn:aws:elasticbeanstalk:us-east-2::platform/Node.js running on 64bit Amazon Linux/4.9.2",
    "SolutionStackName": "64bit Amazon Linux 2018.03 v4.9.2 running Node.js",
    "EnvironmentId": "e-rp3dadug9x",
    "CNAME": "andytestawseb12345.us-east-2.elasticbeanstalk.com",
    "Tier": {
        "Version": "1.0",
        "Type": "Standard",
        "Name": "WebServer"
    },
    "Health": "Grey",
    "DateUpdated": "2019-07-20T12:47:04.633Z",
    "DateCreated": "2019-07-20T12:47:04.633Z"
}

這個指令會花一段時間大概3~5分鐘去建背後所需的資源, 在AWS portal 上可以看到建立中的狀態, 當它轉為綠燈時表示建立完成

或是使用指令來看新環境狀態是否Ready

aws elasticbeanstalk describe-environments --environment-names $appname

成功建立之後可以連上去看看結果(如下所示)





當雲端上的資源建立好之後, 就可以開始寫程式然後部屬到上面去嘍, 接下來請大家找一個乾淨的資料夾進行以下的步驟

1. 建立一個 server.js

把以下的程式碼複製到 server.js

var express = require('express');
var app = express();

app.get('/', function (req, res) {
  res.send('Hello World! andy');
});

app.listen(process.env.PORT || 3000 , function () {
  console.log('Example app listening on port 3000!');
});


2. 初始化環境


git init

echo node_modules > .gitignore

npm init --yes

npm install --save express

為了避免等等執行awseb cli出現錯誤訊息, 請大家將程式碼加入版控


git add -A

git commit -m 'first commit'
建立部屬設定檔

eb init $appname

最後部屬程式


eb deploy

測試

eb open
執行完這個指令之後, 瀏覽器會被開啟並且導向到我們部屬的web應用程式的網址上, 若成功部屬會看到



結論

要在AWS Elastic Beanstalk上部屬一個Node.js應用程式其實非常的簡單, 因為相關的資源建置比如EC2, Load Balancer, Auto Scaling Group, Cloudwatch 等等,,,都在建立Elastic Beanstalk的時候時一併建立了, 除此之外, 透過CIL工具還, 透過CIL工具還可以將整個部屬的步驟做到CI\CD流程當中, 達到自動化的目的


Ref:
https://docs.aws.amazon.com/zh_cn/elasticbeanstalk/latest/dg/environments-create-awscli.html
https://docs.aws.amazon.com/zh_tw/elasticbeanstalk/latest/dg/eb3-init.html
https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/create-configuration-template.html
https://docs.aws.amazon.com/cli/latest/reference/elasticbeanstalk/describe-environments.html






留言

這個網誌中的熱門文章

如何在 QNAP QuTS hero 上設定共享資料夾與 NFS 存取權限

如何在 QNAP QuTS hero 上設定共享資料夾與 NFS 存取權限 How to Set Up Shared Folders and NFS Access on QNAP QuTS Hero QNAP 的 QuTS hero 是一個強大的儲存解決方案,結合 ZFS 檔案系統,提供高效能和高可靠性的數據管理功能。如果您需要在 QuTS hero 上建立共享資料夾並啟用 NFS 存取權限,以下是完整的教學步驟,適合用於數據密集型工作負載。 步驟 1:建立共享資料夾並設定儲存屬性 首先,透過以下指令建立一個名為 test123 的共享資料夾,同時設定壓縮啟用、快速複製 (Fast Clone)、以及適合 VDI 或資料庫的 4KB 記錄大小: # 建立共享資料夾並設定儲存屬性 qcli_sharedfolder -s sharename=test123 poolID=1 \ compress=1 \ dedup=0 \ read_cache=0 \ fast_clone=1 \ sync=0 \ record_size=4 \ type=1 \ worm_type=0 \ size=107374182400 參數說明: compress=1 :啟用壓縮以節省存儲空間。 dedup=0 :關閉重複數據刪除以降低系統負擔。 record_size=4 :設定 4KB 記錄大小,適合資料庫應用。 fast_clone=1 :啟用快速複製以提升數據處理效率。 size=107374182400: 100 Gb 步驟 2:啟用並設定 NFS 存取 共享資料夾建立完成後,接下來啟用 NFS 存取,並設定所有主機 ( * ) 皆具有讀寫權限: # 啟用 NFS 存取 qcli_sharedfolder -N sharename=test123 Access=Enabled qcli_sharedfolder -U sharename=test123 userrw=guest # 為所有主機設定 NFS 權限 qcli_sharedfolder -K sharename=test123 remove_HostIP="*" qcli_sharedfolder -T sharename=test123 HostIP="*...

[解決方法] docker: permission denied

前言 當我們執行docker 指令時若出現以下錯誤訊息 docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post http://%2Fvar%2Frun%2Fdocker.sock/v1.26/containers/create: dial unix /var/run/docker.sock: connect: permission denied. See 'docker run --help'. 表示目前的使用者身分沒有權限去存取docker engine, 因為docker的服務基本上都是以root的身分在執行的, 所以在指令前加sudo就能成功執行指令 但每次實行docker指令(就連docker ps)都還要加sudo實在有點麻煩, 正確的解法是 我們可以把目前使用者加到docker群組裡面, 當docker service 起來時, 會以這個群組的成員來初始化相關服務 sudo groupadd docker sudo usermod -aG docker $USER 需要退出重新登錄後才會生效 Workaround 因為問題是出在權限不足, 如果以上方法都不管用的話, 可以手動修改權限來解決這個問題 sudo chmod 777 /var/run/docker.sock https://docs.docker.com/install/linux/linux-postinstall/

[C#] Visual Studio, 如何在10分鐘內快速更改命名專案名稱

前言: 由於工作需要, 而且懶得再重寫類似的專案, 所以常常將之前寫的專案複製一份加料後, 再重新命名編譯 假設今天我有一個專案HolyUWP, 我想把它重新命名成 BestUWP 時該怎麼做? 以下是幾個簡單的的步驟 使用Visual Studio 2017 備份原來專案 更改Solution名稱 更改Assembly name, Default namespce 更改每支程式碼的Namespace 更改專案資料夾名稱 備份原來專案 由於怕改壞掉, 所以在改之前先備份 更改Solution名稱 更改sln的名稱, 這邊我改成BestUWP.sln 使用Visual Studio打開你的.sln, 右鍵點擊Solution後選擇Rename, 這邊我把它重新命名成BestUWP(跟檔案名稱一致) 必要的話可以順便修改Porject名稱 更改Assembly name, Default namespce 進入 Project > OOXX Properties    修改Assembly Name, Default namesapce 更改每支程式碼的Namespace 基本上隨便挑一支有用到預設Namesapce(HolyUWP)的程式碼來改就好了 重新命名後點擊Apply,  這個動作做完後所有用到舊Namespace的程式碼都會被改成新的 更改專案資料夾名稱 以上動作做完後, 基本上就可以把專案編譯出來測看看了~