docs: READMEを更新

This commit is contained in:
shimoda.m@nds-tyo.co.jp 2024-08-30 16:52:20 +09:00
parent b2cdb4dc2a
commit a0cb93bcdb

View File

@ -1,7 +1,8 @@
## 脆弱スキャン用ツール # MeDaCA ECR脆弱スキャンツール
### 前提
- `docker cli`インストール済み ## 前提
- `docker cli`インストール済み(WSL想定)
- `AWS CLI`インストール済み - `AWS CLI`インストール済み
- AWS CLIでアカウント情報設定されていること - AWS CLIでアカウント情報設定されていること
@ -15,40 +16,41 @@
bash build-push-scanpoint.sh bash build-push-scanpoint.sh
``` ```
- *実行したコマンド失敗したとき、スクリプトが停止する* - 実行したコマンド失敗したとき、スクリプトが停止する
- *その場合は`build-push-scanpoint`直下から失敗したコマンド単体実行できる* - その場合は`build-push-scanpoint`直下から失敗したコマンド単体実行できる
- *例:`bash dataimport.sh`* - 例:`bash build-dataimport.sh`
- *スクリプトを強制停止したい場合、`Ctrl + C`で停止できる* - スクリプトを強制停止したい場合、`Ctrl + C`で停止できる
### ビルドしたECRをlatestに再タグ、プッシュする ### ビルドしたECRをlatestに再タグ、プッシュする
- 前提:プッシュした`scan-point` ECRを動作確認済 - **前提ECRにプッシュした`scan-point`タグのイメージでステージング環境での動作確認が完了していること。**
- `vulnerability-scan`の直下フォルダで以下コマンド実行する - `vulnerability-scan`の直下フォルダで以下コマンド実行する
```bash ```bash
bash retag-push-latest.sh bash retag-push-latest.sh
``` ```
- *実行したコマンド失敗したとき、スクリプトが停止する* - 実行したコマンド失敗したとき、スクリプトが停止する
- *その場合は`retag-push-latest`直下から失敗したコマンド単体実行できる* - その場合は`retag-push-latest`直下から失敗したコマンド単体実行できる
- *例:`bash retag-dataimport.sh`* - 例:`bash retag-dataimport.sh`
- *スクリプトを強制停止したい場合、`Ctrl + C`で停止できる* - スクリプトを強制停止したい場合、`Ctrl + C`で停止できる
## フォルダ構成 ## フォルダ構成
├── build-push-scanpoint.sh -- 全ECRモジュールをアップデート、Dockerイメージにビルドし、プッシュするスクリプト ├── build-push-scanpoint.sh -- 全ECRモジュールをアップデート、Dockerイメージにビルドし、プッシュするスクリプト
├── retag-push-latest.sh -- ビルドしたDockerイメージをlatestの再タグして、ステージング環境と本番環境にプッシュするスクリプト ├── retag-push-latest.sh -- ビルドしたDockerイメージをlatestの再タグして、ステージング環境と本番環境にプッシュするスクリプト
├── README.md -- 当ファイル ├── README.md -- 当ファイル
├── build-push-scanpoint ├── build-push-scanpoint
│ ├── dataimport.sh -- データ登録機能のアップデートスクリプト │ ├── build-dataimport.sh -- データ登録機能の脆弱性スキャンスクリプト
│ ├── sap-data-decrypt.sh -- SAPデータ登録 SAPデータ復号化機能アップデートスクリプト │ ├── build-sap-data-decrypt.sh -- SAPデータ登録 SAPデータ復号化機能脆弱性スキャンスクリプト
│ ├── check-view-security-option.sh -- Viewセキュリティオプションチェック機能アップデートスクリプト │ ├── build-check-view-security-option.sh -- Viewセキュリティオプションチェック機能脆弱性スキャンスクリプト
│ ├── crm-datafetch.sh -- CRMデータ連携 CRMデータ取得機能アップデートスクリプト │ ├── build-crm-datafetch.sh -- CRMデータ連携 CRMデータ取得機能脆弱性スキャンスクリプト
│ ├── jskult-dbdump.sh -- 実消化&アルトマーク日次バッチ実行前dump取得機能アップデートスクリプト │ ├── build-jskult-dbdump.sh -- 実消化&アルトマーク日次バッチ実行前dump取得機能脆弱性スキャンスクリプト
│ ├── jskult-batch-daily.sh -- 実消化&アルトマーク日次バッチ機能アップデートスクリプト │ ├── build-jskult-batch-daily.sh -- 実消化&アルトマーク日次バッチ機能脆弱性スキャンスクリプト
│ ├── jskult-batch-laundering.sh -- 実消化&アルトマーク週次バッチ機能アップデートスクリプト │ ├── build-jskult-batch-laundering.sh -- 実消化&アルトマーク週次バッチ機能脆弱性スキャンスクリプト
│ ├── jskult-webapp.sh -- 実消化&アルトマークWebアプリケーションアップデートスクリプト │ ├── build-jskult-webapp.sh -- 実消化&アルトマークWebアプリケーション脆弱性スキャンスクリプト
| └── export-dbdump.sh -- DBダンプ取得機能アップデートスクリプト | ├── build-export-dbdump.sh -- DBダンプ取得機能脆弱性スキャンスクリプト
| └── build-transfer-medpass-data.sh -- medパス社データ転送機能脆弱性スキャンスクリプト
└── retag-push-latest └── retag-push-latest
├── retag-dataimport.sh -- データ登録機能の再タグ本番環境にプッシュスクリプト ├── retag-dataimport.sh -- データ登録機能の再タグ本番環境にプッシュスクリプト
├── retag-sap-data-decrypt.sh -- SAPデータ登録 SAPデータ復号化機能再タグ本番環境にプッシュスクリプト ├── retag-sap-data-decrypt.sh -- SAPデータ登録 SAPデータ復号化機能再タグ本番環境にプッシュスクリプト
@ -58,11 +60,21 @@ bash retag-push-latest.sh
├── retag-jskult-batch-daily.sh -- 実消化&アルトマーク日次バッチ機能再タグ本番環境にプッシュスクリプト ├── retag-jskult-batch-daily.sh -- 実消化&アルトマーク日次バッチ機能再タグ本番環境にプッシュスクリプト
├── retag-jskult-batch-laundering.sh -- 実消化&アルトマーク週次バッチ機能再タグ本番環境にプッシュスクリプト ├── retag-jskult-batch-laundering.sh -- 実消化&アルトマーク週次バッチ機能再タグ本番環境にプッシュスクリプト
├── retag-jskult-webapp.sh -- 実消化&アルトマークWebアプリケーション再タグ本番環境にプッシュスクリプト ├── retag-jskult-webapp.sh -- 実消化&アルトマークWebアプリケーション再タグ本番環境にプッシュスクリプト
└── retag-export-dbdump.sh -- DBダンプ取得機能再タグ本番環境にプッシュスクリプト ├── retag-export-dbdump.sh -- DBダンプ取得機能再タグ本番環境にプッシュスクリプト
└── retag-transfer-medpass-data.sh -- medパス社データ転送機能再タグ本番環境にプッシュスクリプト
## 作成方法とタイミング ## 作成タイミングと作成方法
- 本番リリース済みのECRリポジトリに対して脆弱性スキャン対象になるため、リリース済のECRにスクリプト作成する
- `vulnerability-scan/build-push-scanpoint/dataimport.sh` を参考にしてスクリプト実装する ### 作成タイミング
- ECRリポジトリにて資材を管理する機能のUAT完了後、脆弱性スキャン手順を作成するタイミングで、当スクリプトをreleaseブランチに登録する。
### 作成方法
- 脆弱性スキャンスクリプトを`build-push-scanpoint`フォルダ配下に作成する。
- `vulnerability-scan/build-push-scanpoint/build-crm-datafetch.sh` を参考にしてスクリプト実装する
- リポジトリによってコマンドの組み方が微妙に異なるため、作成後にレビューを受けること
- 実装したスクリプトを親スクリプト`vulnerability-scan/build-push-scanpoint.sh`に追加する - 実装したスクリプトを親スクリプト`vulnerability-scan/build-push-scanpoint.sh`に追加する
- `vulnerability-scan/retag-push-latest/-retag-dataimport.sh` を参考にしてスクリプト実装する - 再タグ&本番環境へのPUSHスクリプトを`retag-push-latest`フォルダ配下に作成する。
- `vulnerability-scan/retag-push-latest/retag-dataimport.sh` を参考にしてスクリプト実装する
- 実装したスクリプトを親スクリプト`vulnerability-scan/retag-push-latest.sh`に追加する - 実装したスクリプトを親スクリプト`vulnerability-scan/retag-push-latest.sh`に追加する