This is an API that can be used to query a version-controlled key value store. I've delete it from the cloud so this API is currently unavailable. Please contact me if you want to use and test this API in production.

(Temporarily unavailable)Base path: http://key-value-store.ap-southeast-1.elasticbeanstalk.com/api/v1

{
    "data": [
        {
            "key": "key7",
            "value": "example text content of key 7.",
            "timestamp": 1656397200
        },
        {
            "key": "key7",
            "value": "\t example text content of key 7",
            "timestamp": 1656397211
        },
        {
            "key": "key10",
            "value": "example text content of key 10.",
            "timestamp": 1656483600
        }
    ]
}

{
    "data": {
        "key": "key7",
        "value": "\t example text content of key 7",
        "timestamp": 1656397211
    }
}

{
    "data": {
        "key": "key7",
        "value": "\t new example text content of key 7",
        "timestamp": 1656397200
    }
}

{
    "data": {
        "key": "mykey",
        "value": "value1",
        "timestamp": 1719344835
    }
}

the cloud infrastructure resource, DynamoDb are defined and provisioned using AWS Cloudformation. Deployment to Elastic Beanstalk environment has been made using awsebcli. This is the architecture used.

The DynamoDB data model looks like this.

Example

Please note that data model design of the dynamodb table varies depending on the data size and predicted read&write frequency. For example, if the predicted read&frequency rate is not that high, we could create a Global Secondary Index(GSI) that has a constant static key like "ALL_ITEMS" as the partition key. By doing so, the query to get all records will become more efficient since dynamodb query perfomance will be very fast if we specify partition key during query. On the other hand, if the read&frequency rate is predicted to be very high, we shall consider partition key sharding.

#6 (comment)

You need these on your computer before you can proceed with the setup.

• PHP >= 8.2
• aws cli
• dynamodb local

1. Clone this repository

$ git clone https://github.com/SarahTeoh/key-value-store.git 
$ cd key-value-store 

2. Set up configuration

$ cp .env.example .env

Open .env file and configure the DYNAMODB_* and AWS_*.

• DYNAMODB_CONNECTION: 'local' or 'test' for local
• DYNAMODB_LOCAL_ENDPOINT: Your DynamoDB local endpoint with port
• DYNAMODB_TABLE_NAME: DynamoDB table name you've created.
• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY
• AWS_DEFAULT_REGION

3. Install PHP dependencies

$ composer install

4. Generate application key

$ php artisan key:generate

5. Create dynamodb table in dynamodb local

aws dynamodb create-table --cli-input-json file://database/create-dynamodb-table.json --endpoint-url http://localhost:8000 

Change the endpoint url to your dynamodb local endpoint url.

6. Check table created

aws dynamodb list-tables --endpoint-url http://localhost:8000

7. Seed local dynamodb table

php artisan db:seed --class=KeyValueSeeder

8. Run the dev server (the output will give the address):

$ php artisan serve

That's it! You can use curl or Postman to try the API.