Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

hccdoc-2065 update description and auth description #4877

Merged
merged 4 commits into from
Jan 26, 2024

Conversation

neal-timpe
Copy link
Contributor

@neal-timpe neal-timpe commented Jan 24, 2024

Jira Ticket

HCCDOC-2065

Description

This change will update the main description and the description of the Auth section, although I think the auth section needs to be updated from basic to service token.

Testing

  1. Checkout Branch
  2. Restart Koku
  3. Hit endpoint or launch shell
    1. You should see ...
  4. Do more things...

Notes

...

@neal-timpe neal-timpe requested review from a team as code owners January 24, 2024 18:28
@app-sre-bot
Copy link
Collaborator

Can one of the admins verify this patch?

@@ -1,7 +1,7 @@
{
"openapi": "3.0.0",
"info": {
"description": "The API for Cost Management",
"description": "Access your cloud and OpenShift data you integrated with cost management.",
"version": "1.0.2",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you also set this version to v1? I have no idea where 1.0.2 came from, and given that our api path is api/cost-management/v1, it feels like this version should also be v1.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I changed to v 1 with no dots. Does it need to be 1.0.0?

I'm editing the right openapi file right? The only other ones are in /koku/sources and /koku/masu and look like they do different stuff.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it should be v1. And yes, this is the correct doc to edit.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There seems to be zero consistency, but looking at this one:
https://console.redhat.com/docs/api/compliance
it uses v1.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, updated to "v1"

@maskarb maskarb added hot-fix-smoke-tests pr_check label to run minimal smoke tests for fast moving bug-fix smoke-tests pr_check will build the image and run minimal required smokes and removed hot-fix-smoke-tests pr_check label to run minimal smoke tests for fast moving bug-fix labels Jan 24, 2024
Copy link

codecov bot commented Jan 24, 2024

Codecov Report

Merging #4877 (01f4240) into main (e99123d) will increase coverage by 0.0%.
The diff coverage is n/a.

Additional details and impacted files
@@          Coverage Diff          @@
##            main   #4877   +/-   ##
=====================================
  Coverage   94.0%   94.0%           
=====================================
  Files        372     372           
  Lines      30679   30679           
  Branches    3658    3658           
=====================================
+ Hits       28846   28848    +2     
+ Misses      1169    1166    -3     
- Partials     664     665    +1     

@maskarb
Copy link
Member

maskarb commented Jan 26, 2024

/retest

@@ -6103,7 +6103,7 @@
"securitySchemes": {
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@maskarb Will this securitySchemes be updated as the basic auth moves to service account auth?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I had not thought about that at all, but it will probably need to, yes.

@maskarb maskarb merged commit 9c2b130 into project-koku:main Jan 26, 2024
8 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
smoke-tests pr_check will build the image and run minimal required smokes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants