update cdk deployment docs (#610)

Author: vincentsarago

.github/workflows/ci.yml

@@ -231,7 +231,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          python -m pip install -r requirements.txt
+          python -m pip install -r requirements-cdk.txt
 
       # Let's wait a bit to make sure package is available on pypi
       - name: Sleep for 120 seconds
@@ -240,7 +240,7 @@ jobs:
 
       # Build and Deploy CDK application
       - name: Build & Deploy
-        run: npm run cdk deploy ${{ secrets.STACK_NAME }}-lambda-${{ secrets.STACK_STAGE }} --require-approval never
+        run: npm run cdk -- deploy ${{ secrets.STACK_NAME }}-lambda-${{ secrets.STACK_STAGE }} --require-approval never
         env:
           TITILER_STACK_NAME: ${{ secrets.STACK_NAME }}
           TITILER_STACK_STAGE: ${{ secrets.STACK_STAGE }}

deployment/aws/requirements.txt renamed to deployment/aws/requirements-cdk.txt

@@ -17,23 +17,30 @@ The Lambda stack is also deployed by the [AWS CDK](https://aws.amazon.com/cdk/)
 
     ```bash
     # Download titiler repo
-    $ git clone https://github.com/developmentseed/titiler.git
+    git clone https://github.com/developmentseed/titiler.git
+    cd titiler/deployment/aws
 
-    # install cdk dependencies
-    $ cd titiler/deployment/aws
-    $ pip install -r requirements.txt
-    $ npm install
+    # Create a virtual environment
+    python -m pip install --upgrade virtualenv
+    virtualenv .venv
+    source .venv/bin/activate
 
-    $ npm run cdk bootstrap # Deploys the CDK toolkit stack into an AWS environment
+    # Install CDK dependencies
+    python -m install -r requirements-cdk.txt
 
-    # in specific region
-    $ npm run cdk bootstrap aws://${AWS_ACCOUNT_ID}/eu-central-1
+    # Install NodeJS dependencies
+    npm install
+
+    $ npm run cdk -- bootstrap # Deploys the CDK toolkit stack into an AWS environment
+
+    # or in specific region
+    $ npm run cdk -- bootstrap aws://${AWS_ACCOUNT_ID}/eu-central-1
     ```
 
 2. Pre-Generate CFN template
 
     ```bash
-    $ npm run cdk synth  # Synthesizes and prints the CloudFormation template for this stack
+    $ npm run cdk -- synth  # Synthesizes and prints the CloudFormation template for this stack
     ```
 
 3. Update settings (see [intro.md](intro.md))
@@ -58,8 +65,8 @@ The Lambda stack is also deployed by the [AWS CDK](https://aws.amazon.com/cdk/)
 4. Deploy
 
     ```bash
-    $ npm run cdk deploy mytiler-lambda-dev # Deploys the stack(s) titiler-lambda-dev in cdk/app.py
+    $ npm run cdk -- deploy mytiler-lambda-dev # Deploys the stack(s) titiler-lambda-dev in cdk/app.py
 
     # Deploy in specific region
-    $ AWS_DEFAULT_REGION=eu-central-1 AWS_REGION=eu-central-1 npm run cdk deploy mytiler-lambda-dev
+    $ AWS_DEFAULT_REGION=eu-central-1 AWS_REGION=eu-central-1 npm run cdk -- deploy mytiler-lambda-dev
     ```