{"id":19046,"date":"2023-08-11T08:29:23","date_gmt":"2023-08-11T12:29:23","guid":{"rendered":"https:\/\/qxf2.com\/blog\/?p=19046"},"modified":"2024-03-14T09:20:39","modified_gmt":"2024-03-14T13:20:39","slug":"test-lambda-deployment-ci-localstack","status":"publish","type":"post","link":"https:\/\/qxf2.com\/blog\/test-lambda-deployment-ci-localstack\/","title":{"rendered":"Test Lambda before deployment on CI using LocalStack"},"content":{"rendered":"

In my previous posts, I covered how to write tests for Lambdas, run them on LocalStack<\/a> and addressed the issue<\/a> I encountered while working on LocalStack<\/a>. Now, in this post, I will show you how to set up a GitHub Action job to run tests on LocalStack before deploying Lambdas to production. At Qxf2<\/a>, we place high importance on CI\/CD, and it is crucial for us to test Lambdas before deploying them into production. LocalStack proves to be helpful by allowing us to deploy Lambdas locally for testing purposes.<\/p>\n

\"CICD<\/a>
CICD Workflow<\/figcaption><\/figure>\n

Nowadays, we are using Github Action for CI\/CD. Look at the steps below for setup.
\nSteps to setup with Github Action:<\/strong>
\n1. Create a .yml file under .github\/workflow directory
\n2. Write a workflow to run Lambda tests on LocalStack and then deploy to production
\n3. Use act tool to test your workflow locally
\n4. Push your code and merge it into master\/main branch<\/p>\n

\n

1. Create a .yml file under .github\/workflow directory:<\/h4>\n

Please skip this step if you already have a YAML file for GitHub Actions. If you haven’t set up GitHub Actions yet, please create a directory named .github\/workflows and create a file named url-filter-lambda.yml<\/p>\n

\n

2. Write a workflow to run Lambda tests on LocalStack and then deploy to production:<\/h4>\n

Now we need to write a workflow to start LocalStack and run the test that deploys the Lambda and tests it. Please refer our previous blog<\/a> for the test and docker-compose file used to start LocalStack. Look at the workflow below:<\/p>\n

 \r\nname: Test with LocalStack\r\n\r\non:\r\n  push:\r\n    branches:\r\n      - main # Adjust the branch name if needed\r\n\r\njobs:\r\n  test:\r\n    name: Test\r\n    runs-on: ubuntu-latest\r\n\r\n    steps:\r\n      - name: Checkout repository\r\n        uses: actions\/checkout@v2\r\n\r\n      - name: Set up Docker Compose\r\n        run: |\r\n          sudo apt-get update\r\n          sudo apt-get install -y docker-compose\r\n\r\n      - name: Start LocalStack\r\n        run: |\r\n          docker-compose -f docker-compose.yml up -d\r\n\r\n      - name: Wait for LocalStack to be ready\r\n        run: |\r\n          timeout 300 bash -c 'until echo > \/dev\/tcp\/localhost\/4566; do sleep 1; done'\r\n\r\n      - name: Set up Python\r\n        uses: actions\/setup-python@v2\r\n        with:\r\n          python-version: \"3.8\" # Replace version with your desired Python version \r\n\r\n      - name: Install dependencies\r\n        run: pip install -r requirements.txt \r\n\r\n      - name: Run tests\r\n        run: pytest -s -v test_lambda.py # Replace with the appropriate command to run your tests\r\n\r\n      - name: Stop LocalStack\r\n        run: docker-compose -f docker-compose.yml down\r\n\r\n  production:\r\n    name: Deploy to production\r\n    needs: test\r\n    runs-on: ubuntu-latest\r\n\r\n    steps:\r\n    .......\r\n    .......\r\n    .......\r\n<\/pre>\n
Refer to our GitHub Action script of the URL filter Lambda for your reference here<\/a>. Our workflow tests the Lambda on LocalStack before deploying it to the Staging and the Production.<\/p>\n
\n
3. Use act tool to test your workflow locally: <\/h4>\n
To test a workflow locally before pushing the changes, we need to use ‘act’ tool. Refer to the nektos\/act<\/a> README and install the ‘act’ tool. Once you’re set with the ‘act’ tool, run the script using the ‘act’ command.<\/p>\n
Command to run the workflow:<\/p>\n
 act -W \n
In the above command, you can use the --env-file option if you want to pass environment variable values, or you can skip it. For more commands, please refer to the nektos\/act readme file.<\/p>\n
\n
4. Push your code and merge it into master\/main branch:<\/h4>\n
Once you can successfully run the workflow using 'act,' you can push your changes and merge them with the master\/main branch. After the merge, GitHub Actions trigger the workflow for every push to the branch mentioned under the workflow. It runs the test on LocalStack, and if the test runs successfully, it proceeds to the next jobs. <\/p>\n
\n
I hope this blog helps you get set up with GitHub Actions for your Lambda deployment.<\/p>\n
\n
Hire testers from Qxf2!<\/h4>\n
Hiring Qxf2<\/a> brings technical expertise that extends beyond traditional test automation. Our skilled testers possess diverse technical skills and practical knowledge. We excel in crafting and executing comprehensive test strategies, enabling seamless integration of testing into the development process. Our team's proficiency in various tools and frameworks ensures efficient testing of complex software systems, contributing to enhanced product quality and faster iteration cycles.<\/p>\n
\n","protected":false},"excerpt":{"rendered":"
In my previous posts, I covered how to write tests for Lambdas, run them on LocalStack and addressed the issue I encountered while working on LocalStack. Now, in this post, I will show you how to set up a GitHub Action job to run tests on LocalStack before deploying Lambdas to production. At Qxf2, we place high importance on CI\/CD, […]<\/p>\n","protected":false},"author":12,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[301,316,179,297],"tags":[],"class_list":["post-19046","post","type-post","status-publish","format-standard","hentry","category-github-action","category-infrastructure","category-lambda-functions","category-localstack"],"_links":{"self":[{"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/posts\/19046","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/comments?post=19046"}],"version-history":[{"count":17,"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/posts\/19046\/revisions"}],"predecessor-version":[{"id":20308,"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/posts\/19046\/revisions\/20308"}],"wp:attachment":[{"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/media?parent=19046"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/categories?post=19046"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/qxf2.com\/blog\/wp-json\/wp\/v2\/tags?post=19046"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}