k6-jslib-aws
A library allowing to interact with AWS resources for k6.io
This is an AWS client library for k6. It intends to allow interacting with a subset of AWS services in the context of k6 load test script.
Supported features
At the moment, this library provides the following:
S3Client
: allows to list buckets and bucket's objects, as well as uploading, downloading, and deletion of objects.SecretsManager
: allows to list, get, create, update and delete secrets from the AWS secrets manager service.V4 signature
: allows to sign requests to amazon AWS services
Demo
S3
import exec from 'k6/execution'
import {
// listBuckets,
AWSConfig,
S3Client,
} from 'https://jslib.k6.io/aws/0.3.0/s3.js'
const testFile = open('./bonjour.txt', 'r')
const awsConfig = new AWSConfig(
__ENV.AWS_REGION,
__ENV.AWS_ACCESS_KEY_ID,
__ENV.AWS_SECRET_ACCESS_KEY
)
const s3 = new S3Client(awsConfig)
const testBucketName = 'test-jslib-aws'
const testFileKey = 'bonjour.txt'
export default function () {
// List the buckets the AWS authentication configuration
// gives us access to.
const buckets = s3.listBuckets()
// If our test bucket does not exist, abort the execution.
if (buckets.filter((b) => b.name === testBucketName).length == 0) {
exec.test.abort()
}
// Let's upload our test file to the bucket
s3.putObject(testBucketName, testFileKey, testFile)
// Let's list the test bucket objects
const objects = s3.listObjects(testBucketName)
// And verify it does contain our test object
if (objects.filter((o) => o.key === testFileKey).length == 0) {
exec.test.abort()
}
// Let's redownload it verify it's correct, and delete it
const obj = s3.getObject(testBucketName, testFileKey)
s3.deleteObject(testBucketName, testFileKey)
}
Secrets Manager
import exec from 'k6/execution'
import { AWSConfig, SecretsManagerClient } from 'https://jslib.k6.io/aws/0.3.0/secrets-manager.js'
const awsConfig = new AWSConfig(
__ENV.AWS_REGION,
__ENV.AWS_ACCESS_KEY_ID,
__ENV.AWS_SECRET_ACCESS_KEY
)
const secretsManager = new SecretsManagerClient(awsConfig)
const testSecretName = 'jslib-test-secret'
const testSecretValue = 'jslib-test-value'
export default function () {
// Let's make sure our test secret is created
const testSecret = secretsManager.createSecret(
testSecretName,
testSecretValue,
'this is a test secret, delete me.'
)
// List the secrets the AWS authentication configuration
// gives us access to, and verify the creation was successful.
const secrets = secretsManager.listSecrets()
if (!secrets.filter((s) => s.name === testSecret.name).length == 0) {
exec.test.abort('test secret not found')
}
// Now that we know the secret exist, let's update its value
const newTestSecretValue = 'new-test-value'
secretsManager.putSecretValue(testSecretName, newTestSecretValue)
// Let's get its value and verify it was indeed updated
const updatedSecret = secretsManager.getSecret(testSecretName)
if (updatedSecret.secretString !== newTestSecretValue) {
exec.test.abort('unable to update test secret')
}
// Finally, let's delete our test secret and verify it worked
secretsManager.deleteSecret(updatedSecret.name, { noRecovery: true })
}
Development
Contributing
The scope of this library has been kept minimal and limited to the use cases we, and our clients, need. If the library doesn't cater to your needs just yet, feel free to add it, and open a pull-request. We welcome contributions.
Build
# Install the local dependencies
npm install
# Bundle it in preparation for a publication
npm run-script webpack
# Run the tests
npm test
Deploying new versions
- Build.
- Use the
./build/aws.min.js
to make a PR to jslib.k6.io.
Maintainers
k6-jslib-aws is developped by the k6 core development team. Maintainers of this jslib specifically are the following:
- Théo Crevon, core k6 developer @oleiade