AWS SaaS Boost가 오픈 소스로 공개됐기 때문에 얼른 와서 해보세요

개시하다

얼마 전 AWS 블로그에'AWS SaaS Boost가 오픈 소스로 발표됐다'는 기사가 올라왔다.
https://aws.amazon.com/jp/blogs/news/aws-saas-boost-released-as-open-source/
보통은 AWS SaaS Boost를 서비스로 이용하면 되는데, 아, 코드가 공개됐기 때문에 통과하고 싶은데 자꾸 신경이 쓰여요.창고를 가로질러 마법 개조를 할 때가 있을지도 몰라요.아니오, 그는 오지 않을 겁니다
그래서 이런 상황에 대비해 개조된 것을 움직여 봤으면 좋겠다는 생각에 펜을 들었다.

말하자면'AWS SaaS Boost'는 어떤 분인가요?

AWS SaaS Boost란 자신이 가진 앱을 SaaS화하려는 것이다!이럴 때는 강력한 파트너가 되는 서비스다.
https://aws.amazon.com/jp/partners/saas-boost/
AWS의 블로그에 쓴 내용도 그대로 게재되는데, 어쨌든 이 서비스는 SaaS화할 때 반드시 만들어야 할 기능을 보완할 수 있다.
기존 앱을 SaaS 부스트에 설치하기만 하면 세입자 관리, 디버깅, 세입자별 분석, 할부(요청), 계기판을 모두 설치해 바로 사용할 수 있다.이렇게 하면 복구 솔루션의 비용을 들이지 않아도 SaaS 모델로 시장에 제품을 더 빨리 제공할 수 있다.
https://aws.amazon.com/jp/blogs/news/transforming-your-monolith-to-saas-with-aws-saas-boost/
따라서 사용자는 응용의 핵심 기능 개발에 더 많은 시간을 들일 수 있기 때문에 나는 사용의 장점이 매우 충분하다고 생각한다.

먼저 오리지널 환경을 만들어 보도록 하겠습니다.

응?개조해야 되는 거 아니에요?이렇게 생각하는 사람이 옳다!하지만 개조 전에 꼭 해야 할 과정이다.특히 젊은 오픈 소스에는 "순서대로 했는데 움직일 수가 없네!"그런 일이 있었어요.그래서 리모델링에 앞서 추가적인 전제조건과 절차가 있는지 확인하고 싶다.
그래서 저는 이쪽 문서에 따라 기본적으로 만들고 싶습니다.참고로 이 글의 Step과 문서의 Step의 숫자는 일치합니다.제목이 좀 달라요.
https://github.com/awslabs/aws-saas-boost/blob/main/docs/getting-started.md

0단계: 환경 준비

이번에는 Amazon Linux2의 EC2 인스턴스를 준비했습니다.4GB 이상의 메모리가 필요합니다.

1단계: 사전 패키지 가져오기

공식 문서에 나열된 패키지를 설치하세요.

Java 11 Amazon Corretto 11

Apache Maven

AWS Command Line Interface version 2

Git

Node 14.15 (LTS)

Yarn

공식 문서에는 명령줄이 적혀 있지 않지만 아마존 라인 2는 아래의 예처럼 느껴진다.보충적으로 필자의 환경에서 OpenJDK8은 기본적인java버전이므로 필요에 따라 명령예시처럼 자바버전으로 전환하여 사용하십시오.지속되지 않도록 주의해라.

명령 실행 예(AmazonLinux2)

$ sudo yum update -y
$ sudo yum install -y java-11-amazon-corretto maven
$ sudo alternatives --config java
$ export JAVA_HOME=/usr/lib/jvm/java-11-amazon-corretto.x86_64/

$ curl --silent --location https://rpm.nodesource.com/setup_14.x | sudo bash -
$ sudo yum install -y nodejs

$ curl --silent --location https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
$ sudo yum install -y yarn

AWS CLI v2는 처음 시작하는 환경이므로 단계를 생략하고 직접 가져오는 경우에는 여기를 참조하십시오.
https://docs.aws.amazon.com/ja_jp/cli/latest/userguide/install-cliv2-linux.html

2단계: 소스 코드 가져오기

GiitHub에서 AWS SaaS Boost의 소스 코드를 다운로드합니다.
여기 공식 문서에는 명령줄이 적혀 있는데 그대로 집행하면 되며, 이번에는 오리지널 포크의 개인 창고를 사용했다.
명령 실행 예(AmazonLinux2)

$ git clone https://github.com/chacco38/aws-saas-boost.git ./aws-saas-boost

3단계: 어플리케이션 및 설계 작성

AWS CLI 설정에서 대화형 설치기를 사용하여 AWS SaaS Boost 가져오기
The system where you run the installation should have at least 4 GB of memory.
다시 정신을 가다듬고 명령을 실행해라.이런 느낌이에요.참고로 출력 형식을'YAML'로 설정하면 설치됩니다.sh에 오류가 발생하여 JSON으로 설정합니다.
명령 실행 예(AmazonLinux2)

$ aws configure
$ aws configure set output json

$ cd aws-saas-boost
$ sh -x install.sh

install.sh 스크립트를 처리하면 설치 프로그램 시작 옵션을 입력해야 합니다.이번에는'1'을 선택했다.
스크립트 출력 예(설치 프로그램 시작 옵션을 입력할 때)

===========================================================
Welcome to the AWS SaaS Boost Installer
Setting version to v0 as it is missing from the git properties file.
Installer Version: d64277c-dirty, Commit time: 2021-05-19T21:15:02+0000
Checking maven, yarn and AWS CLI...
Environment Checks for maven, yarn, and AWS CLI PASSED.
===========================================================
1. New AWS SaaS Boost install.
2. Install Metrics and Analytics in to existing AWS SaaS Boost deployment.
3. Update Web Application for existing AWS SaaS Boost deployment.
4. Update existing AWS SaaS Boost deployment.
5. Delete existing AWS SaaS Boost deployment.
6. Exit installer.
Please select an option to continue (1-6): 1

이어서 각 파라미터를 입력해야 하기 때문에 적절하게 설정한다
스크립트 출력 예(매개변수를 입력할 때)

Directory path of saas-boost download (Press Enter for '/home/ssm-user/aws-saas-boost') : *****
Enter name of the AWS SaaS Boost environment to deploy (Ex. dev, test, uat, prod, etc.): *****
Enter the email address for your AWS SaaS Boost administrator: *****
Enter the email address address again to confirm: *****
Would you like to setup a domain in Route 53 as a Hosted Zone for the AWS SaaS Boost environment (y or n)? *****
Would you like to install the metrics and analytics module of AWS SaaS Boost (y or n)? *****

If your application requires a FSX for Windows Filesystem, an Active Directory is required.
Would you like to provision a Managed Active Directory to use with FSX for Windows Filesystem (y or n)? *****

마지막으로 파라미터를 확인한 후'continue'를 의미하는'y'를 입력하면 나머지는 아무것도 하지 않고 완성만 기다린다.필자의 환경에 따라 완성까지 15분도 걸리지 않았다.
스크립트 출력 예(입력 매개변수를 확인할 때)

Would you like to continue the installation with the following options?
AWS SaaS Boost Environment Name: *****
Admin Email Address: *****
Route 53 Domain for AWS SaaS Boost environment: *****
Install Metrics and Analytics: *****
Amazon Quicksight user for setup of Metrics and Analytics: *****
Setup Active Directory for FSX for Windows: *****
Enter y to continue or n to cancel: y

install.스크립트가 완료되면 EC2 인스턴스에서 당사의 작업이 일시적으로 종료되는 것 같습니다.그래서 관리자 이메일 주소로 새로운 메일을 받았으니 메일을 보러 가자.

4단계: AWS SaaS Boost에 처음 로그인

다음은 웹 브라우저 중심의 작업입니다.이 단계에서는 관리자가 보낸 메시지의 본문에 적힌 URL에 액세스하여 로그인한 다음 암호를 변경합니다.확인해. 넣으면 끝이야.
공식 문서에서는 5단계 이후 AWS SaaS Boost 앱에서 설정이 이뤄지지만, 이번에는 도입 전 절차를 확인하려는 것일 뿐 향후 절차는 필요 없다.

여담, 도입 성공 전 과정 중 발생한 오류

그래서 이번 도입에서 발생한 두 가지 오류를 소개하고 싶습니다.

Case1: Error with build of Java installer for SaaS Boost에 대한 오류 메시지를 내보내고 스크립트를 중지합니다.

1단계에서 필요한 패키지만 설치하고 스크립트를 실행할 때 오류가 발생합니다.mvn 명령이 틀린 것 같지만 mvn은 틀린 것이 없습니다.
명령 실행 예

$ sh -x install.sh
(省略)
+ cd /home/ssm-user/aws-saas-boost/installer
+ echo 'Build installer jar with maven'
Build installer jar with maven
+ mvn
+ echo 'Error with build of Java installer for SaaS Boost'
Error with build of Java installer for SaaS Boost
+ exit 2

나는 그곳에서 각본의 내용을 보았다.따라서 mvn의 표준 출력과 표준 오류 출력은/dev/null로 변경됩니다.
명령 실행 예

$ less install.sh
(/mvn)
(n)
if ! mvn > /dev/null 2>&1 ;
then
  echo "Error with build of Java installer for SaaS Boost"
  exit 2
fi

그래서 mvn 명령이 무엇을 출력하는지 보기 위해 수동으로 실행했습니다.
다음과 같이 메시지를 잘 보냈습니다."javac:invalid target release:11"또는 자바의 목표 발표가 11이 아니어서 욕을 먹었습니다.
명령 실행 예

$ cd /home/ssm-user/aws-saas-boost/installer
$ mvn
(省略)
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.6.0:compile (default-compile) on project SaaSBoostInstall: Compilation failure
[ERROR] javac: invalid target release: 11
[ERROR] Usage: javac <options> <source files>
[ERROR] use -help for a list of possible options
[ERROR] -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException

확인 후 OpenJDK 버전 8이 설정되었습니다.무릇 잘못.
명령 실행 예

$ java -version
openjdk version "1.8.0_282"
$ mvn -version
Java version: 1.8.0_282, vendor: Red Hat, Inc.

따라서 Corretto 버전 11에서 이동하도록 설정하고 mvn을 다시 실행하면 성공합니다.
명령 실행 예

$ sudo alternatives --config java
$ java -version
openjdk version "11.0.11" 2021-04-20 LTS
$ export JAVA_HOME=/usr/lib/jvm/java-11-amazon-corretto.x86_64/
$ mvn -version
Java version: 11.0.11, vendor: Amazon.com Inc.
$ mvn

그래서 설치.sh부터 시행된 후 빌딩도 순조롭게 통과되었다.장난꾸러기.

Case2: 「Could not execute 'aws sts get-caller-identity', please check AWS CLI configuration.」오류 메시지 출력 및 스크립트 중지

하지만 다음 실수가 곧 올 것이다.'aws sts get-calller identity'를 실행할 수 없다고 합니다.
명령 실행 예

$ sh -x install.sh
：
+ echo 'Launch Java Installer for SaaS Boost'Launch Java Installer for SaaS Boost
+ java -Djava.util.logging.config.file=logging.properties -jar /home/ssm-user/aws-saas-boost/installer/target/SaaSBoostInstall-1.0.0-shaded.jar
WARNING: sun.reflect.Reflection.getCallerClass is not supported. This will impact performance.
Setting version to v0 as it is missing from the git properties file.
===========================================================
Welcome to the AWS SaaS Boost Installer
Setting version to v0 as it is missing from the git properties file.
Installer Version: d64277c-dirty, Commit time: 2021-05-19T21:15:02+0000
Checking maven, yarn and AWS CLI...
Could not execute 'aws sts get-caller-identity', please check AWS CLI configuration.

실행할 수 없다는 게 무슨 뜻인지 전혀 모르기 때문에 일단 수동으로 해보면 이유를 알 수 있을 것이다.YAML이라는 모르는 출력 유형을 설정했다고 합니다. 그렇군요. aws configure의 설정값이 좋지 않습니까?
명령 실행 예

$ aws sts get-caller-identity
Unknown output type: yaml

따라서 출력 형식을 JSON 형식으로 실행하면 설치기의 메뉴 표시까지 잘 추진할 수 있다.장난꾸러기.
명령 실행 예

$ aws configure set output json
$ sh install.sh
：
===========================================================
Welcome to the AWS SaaS Boost Installer
Setting version to v0 as it is missing from the git properties file.
Installer Version: d64277c-dirty, Commit time: 2021-05-19T21:15:02+0000
Checking maven, yarn and AWS CLI...
Environment Checks for maven, yarn, and AWS CLI PASSED.
===========================================================
1. New AWS SaaS Boost install.
2. Install Metrics and Analytics in to existing AWS SaaS Boost deployment.
3. Update Web Application for existing AWS SaaS Boost deployment.
4. Update existing AWS SaaS Boost deployment.
5. Delete existing AWS SaaS Boost deployment.
6. Exit installer.
Please select an option to continue (1-6):

그래서 오류집의 소개다.

그럼 변장을 해서 사용해보도록 하겠습니다.

하지만 오리지널 제품만 도입하면 배가 불러요. 그래서 시간이 있을 때 다시 갱신하고 싶어요.

최후

그래서 이번에는 "AWS SaaS Boost가 오픈소스로 공개됐으니 얼른 가서 해보자(단지 그렇게 생각했을 뿐)"고 설명했다.아, 제목이 달라요?됐어, 됐어.