This uses the binaries from the serverless-chrome project to prototype running headless chromium with selenium-webdriver in AWS Lambda. I've also bundled the chromedriver binary so the browser can be interacted with using the Webdriver Protocol.
The function interacts with headless Chromium process using chromedriver and a popular webdriver node.js client library.
This is highly experimental and not all chromedriver functions will work. Check issues for known issues.
Since this Lambda function is written using node.js, you can run almost any script written for selenium-webdriver. Example scripts can be found in the examples directory.
If you don't want to build the archive, you can also download a pre-built AWS Lambda *.zip that you can upload directly to a new
node6.10runtime function using the AWS CLI or Console with at least 256mb of memory. Visit lambdium releases.
- An AWS Account
- Terraform (optional but highly recommended for function creation and deploy)
- node.js + npm
make
The headless chromium binary is too large for Github, you need to fetch it using a script bundled in this repository. Marco Lüthy has an excellent post on Medium about how he built chromium for for AWS Lambda here.
$ ./scripts/fetch-dependencies.sh $ makeThis will create the function using Terraform with all required permissions.
$ make deployThe optional DEBUG_ENV environment variable will log additional information to Cloudwatch. The PATH environment variable points to the bin directory in this project—this is required in order to launch the chromedriver process.
If dependencies are installed and make deploy succeeds you can have Lambda run a script. There's an example of a selenium-webdriver simple script in the examples/ directory that the Lambda function can now run.
Expected JSON input for the function: {"Base64Script": "<Base64 Encoding of Selenium Script>"} (this can also be provided as an environment variable named BASE64_SCRIPT).
To run the example Selenium script, you can use the example with the AWS CLI in the scripts directory. It takes care of base64 encoding the file:
$ scripts/invoke.shTo use your own selenium-webdriver script:
$ scripts/invoke.sh ~/Desktop/my-script.js