Skip to content

asyncapi/server-api

This branch is 13 commits ahead of, 5 commits behind master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

739f4ba Β· Apr 18, 2024
Apr 18, 2024
Jan 30, 2024
Sep 15, 2023
Jan 17, 2022
Jan 30, 2024
Dec 13, 2022
Jan 14, 2022
Jan 18, 2023
Dec 14, 2021
Jan 14, 2022
Jan 30, 2024
Oct 9, 2023
Dec 14, 2021
Mar 1, 2022
May 27, 2022
May 12, 2022
Mar 16, 2022
Nov 29, 2021
Jan 30, 2024
Jan 18, 2023
Dec 14, 2021
Sep 15, 2023
Apr 18, 2024
Apr 18, 2024
Jan 14, 2022
Jan 14, 2022

Repository files navigation

AsyncAPI Server API

Server API providing official AsyncAPI tools.

All Contributors


πŸ“’ ATTENTION:

This package is still under development and has not published and reached version 1.0.0 yet. This means that its API may contain breaking changes until we're able to deploy the first stable version and begin semantic versioning.


Requirements

Using it locally

Run:

npm install
npm run start:prod

server is ready to use on http://localhost:80.

Using it via Docker

Run:

docker run -it -p 80:80 asyncapi/server-api

server is ready to use on http://localhost:80.

Development

  1. Setup project by installing dependencies npm install
  2. Write code and tests.
  3. Make sure all tests pass npm test

Deployment

This project is deployed to DigitalOcean App Platform using Terraform and GitHub Actions. To deploy it to your own account, follow these steps:

  1. Fork this repository.
  2. Create a DigitalOcean Personal Access Token with read and write permissions. For more information, see DigitalOcean's documentation.
  3. Run terraform init to initialize the Terraform project as can be seen here. This should be run being located at ./deployments/apps directory preferably.
  4. Run terraform apply to create the necessary infrastructure.

Note

You need to export the following environment variables before running terraform apply:

  • DIGITALOCEAN_ACCESS_TOKEN: Your DigitalOcean Personal Access Token.

How the GitHub workflow works

The GitHub workflow is triggered when a new tag is pushed to the repository. It will build a new Docker image and push it to the Docker Hub repository. Then the DigitalOcean App Platform GitHub Action updates the application with the new image.

Contribution

Read CONTRIBUTING guide.

Supported by

Contributors

Thanks goes to these wonderful people (emoji key):

Maciej UrbaΕ„czyk
Maciej UrbaΕ„czyk

🚧 πŸ’» πŸ“– πŸ› πŸ€” πŸ‘€ ⚠️ πŸš‡ πŸ§‘β€πŸ«
David Pereira
David Pereira

🚧 πŸ’» πŸ“– πŸ› πŸ€” πŸ‘€ ⚠️ πŸš‡ πŸ§‘β€πŸ«
Sergio Moya
Sergio Moya

🚧 πŸ’» πŸ“– πŸ› πŸ€” πŸ‘€ ⚠️ πŸš‡ πŸ§‘β€πŸ«
Ritik Rawal
Ritik Rawal

πŸ’» πŸ“–
Everly Precia Suresh
Everly Precia Suresh

πŸ’» πŸ“–
Ashish Padhy
Ashish Padhy

πŸ“– πŸš‡

This project follows the all-contributors specification. Contributions of any kind welcome!