Skip to content

Commit e600bba

Browse files
Merge pull request #3 from infinitePi-io/development
Move it to the main branch
2 parents 0fd5595 + a87d6b2 commit e600bba

File tree

15 files changed

+5109
-480
lines changed

15 files changed

+5109
-480
lines changed

CONTRIBUTING.md

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# Contributing to Project Name
2+
3+
We love your input! We want to make contributing to this project as easy and transparent as possible, whether it's:
4+
5+
- Reporting a bug
6+
- Discussing the current state of the code
7+
- Submitting a fix
8+
- Proposing new features
9+
- Becoming a maintainer
10+
11+
## We Develop with Github
12+
13+
We use github to host code, to track issues and feature requests, as well as accept pull requests.
14+
15+
## We Use [Github Flow](https://guides.github.com/introduction/flow/index.html), So All Code Changes Happen Through Pull Requests
16+
17+
Pull requests are the best way to propose changes to the codebase. We actively welcome your pull requests:
18+
19+
1. Fork the repo and create your branch from `main`.
20+
2. If you've added code that should be tested, add tests.
21+
3. If you've changed APIs, update the documentation.
22+
4. Ensure the test suite passes.
23+
5. Make sure your code lints.
24+
6. Issue that pull request!
25+
26+
## Any contributions you make will be under the MIT Software License
27+
28+
In short, when you submit code changes, your submissions are understood to be under the same Apache License 2.0 that covers the project. Feel free to contact the maintainers if that's a concern.
29+
30+
## Report bugs using Github's [issues](https://github.com/briandk/transcriptase-atom/issues)
31+
32+
We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/infinitePi-io/ecs-graphql-api/issues); it's that easy!
33+
34+
## Write bug reports with detail, background, and sample code
35+
36+
Here are few example of bug report:
37+
38+
- [Example1](http://www.openradar.me/11905408)
39+
- [Example2](https://stackoverflow.com/questions/12488905/why-wont-the-ggplot2-legend-combine-manual-fill-and-scale-values)
40+
41+
**Great Bug Reports** tend to have:
42+
43+
- A quick summary and/or background
44+
- Steps to reproduce
45+
- Be specific!
46+
- Give sample code if you can.
47+
- What you expected would happen
48+
- What actually happens
49+
- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
50+
51+
People *love* thorough bug reports. I'm not even kidding.
52+
53+
## Use a Consistent Coding Style
54+
55+
* 2 spaces for indentation rather than tabs
56+
* You can try running `npx standard --fix` for style unification
57+
58+
## License
59+
60+
By contributing, you agree that your contributions will be licensed under its Apache License 2.0 License.
61+
62+
## References
63+
64+
This document was adapted from the open-source contribution guidelines for [Facebook's Draft](https://github.com/facebook/draft-js)

README.md

Lines changed: 90 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,90 @@
1-
# ecs-graphql-api
1+
# aws-graphql-api
2+
3+
This is a[ GraphQL](https://graphql.org/) API designed to retrieve service information by querying the cluster name, service name, and the region where the cluster is deployed. The long-term plan for this API is to expand its capabilities to interact with various AWS resources.
4+
5+
## Docs
6+
7+
- [Install](#install)
8+
- [Quick Start](#quick-start)
9+
- [Running the tests](running-the-tests)
10+
- [Examples](#examples)
11+
- [Acknowledgements](#acknowledgements)
12+
- [License](#license)
13+
14+
## Getting Started
15+
16+
### Install
17+
18+
```bash
19+
npm install
20+
```
21+
22+
### Quick Start
23+
24+
```bash
25+
npm start
26+
```
27+
28+
Server will be running on:
29+
30+
Playground:
31+
32+
```bash
33+
localhost:3000/graphiql
34+
```
35+
36+
API Endpoint:
37+
38+
```bash
39+
localhost:3000/graphql
40+
```
41+
42+
## Running the tests
43+
44+
```bash
45+
npm test
46+
```
47+
48+
## Examples
49+
50+
Query:
51+
52+
```graphql
53+
query getService($serviceNames: String!, $clusterName: String!, $clusterDeployedRegion: String!){
54+
gdsServicesInfo(serviceNames: $serviceNames, clusterName: $clusterName, clusterDeployedRegion: $clusterDeployedRegion){
55+
clusterArn
56+
loadBalancers{
57+
containerName
58+
containerPort
59+
targetGroupArn
60+
}
61+
}
62+
}
63+
64+
# Varables
65+
{
66+
"serviceNames": "my-service-1,my-service-2",
67+
"clusterName": "my-cluster",
68+
"clusterDeployedRegion": "us-east-1"
69+
}
70+
```
71+
72+
The AWS SDK and CLI have certain limitations when it comes to retrieving service information. For instance, the [describe-services](vscode-file://vscode-app/Applications/Visual%20Studio%20Code.app/Contents/Resources/app/out/vs/code/electron-sandbox/workbench/workbench.html "https://docs.aws.amazon.com/cli/latest/reference/ecs/describe-services.html") command can only handle up to 10 services at a time. However, this API overcomes that limitation, allowing you to query information for as many services as you need in a single request. This makes it a more efficient and flexible tool for managing large-scale AWS environments.
73+
74+
More query examples will be added [here]([https://infinitepi-io.github.io/](https://github.com/your_username/repo_name)).
75+
76+
## Acknowledgements
77+
78+
[David Dai ](https://github.com/ddai1)and [Phil Hadviger](https://github.com/datfinesoul) have significantly contributed to the development of this API with their valuable suggestions and improvements.
79+
80+
## Contributing
81+
82+
Please follow the guideline [here](https://github.com/infinitePi-io/ecs-graphql-api/blob/development/CONTRIBUTING.md)
83+
84+
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
85+
86+
## License
87+
88+
[Apache License 2.0](https://github.com/infinitePi-io/ecs-graphql-api/blob/development/LICENSE)
89+
90+
## Contact

0 commit comments

Comments
 (0)