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

[CIVIS-2985] upgrade guide for 1.0 #163

Merged
merged 6 commits into from
Apr 23, 2024
Merged

Conversation

anmarchenko
Copy link
Member

What does this PR do?
Adds upgrade guide for users upgrading from ddtrace gem and updates readme.

Motivation
Next major release for Datadog ruby libraries is coming

@codecov-commenter
Copy link

codecov-commenter commented Apr 23, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.05%. Comparing base (92ad381) to head (b1579b2).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #163   +/-   ##
=======================================
  Coverage   99.05%   99.05%           
=======================================
  Files         196      196           
  Lines        9340     9340           
  Branches      404      404           
=======================================
  Hits         9252     9252           
  Misses         88       88           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@anmarchenko anmarchenko added this to the 1.0 milestone Apr 23, 2024
Copy link
Contributor

@juan-fernandez juan-fernandez left a comment

Choose a reason for hiding this comment

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

LGTM! Mostly nitpicks

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
docs/UpgradeGuide.md Outdated Show resolved Hide resolved
docs/UpgradeGuide.md Outdated Show resolved Hide resolved
docs/UpgradeGuide.md Outdated Show resolved Hide resolved
anmarchenko and others added 5 commits April 23, 2024 16:03
Co-authored-by: Juan Antonio Fernández de Alba <juan.fernandezdealba@datadoghq.com>
Co-authored-by: Juan Antonio Fernández de Alba <juan.fernandezdealba@datadoghq.com>
Co-authored-by: Juan Antonio Fernández de Alba <juan.fernandezdealba@datadoghq.com>
Copy link

@romainkomorndatadog romainkomorndatadog left a comment

Choose a reason for hiding this comment

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

Makes sense to me. I tried reviewing it from the "I'm a newbie to all this" angle, but I'm not sure I'm great at that. :)

README.md Outdated
@@ -212,15 +201,15 @@ VCR.configure do |config|

# when using agentless mode
# note to use the correct datadog site (e.g. datadoghq.eu, etc)
config.ignore_hosts "citestcycle-intake.datadoghq.com", "api.datadoghq.com"
config.ignore_hosts "citestcycle-intake.datadoghq.com", "api.datadoghq.com", "citestcov-intake.datadoghq.com"

Choose a reason for hiding this comment

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

Just out of curiosity, how does this interact with our staging endpoints?

Copy link
Member Author

Choose a reason for hiding this comment

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

Our users do not hit staging endpoints so there is no need to include it in the docs. When I use open source porject that uses VCR, I add all the endpoints I need to ignore in project's configs.

```ruby
VCR.configure do |config|
# note to use the correct datadog site (e.g. datadoghq.eu, etc)
config.ignore_hosts "citestcycle-intake.datadoghq.com", "api.datadoghq.com", "citestcov-intake.datadoghq.com"

Choose a reason for hiding this comment

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

TIL... maybe I can use this in Python if vcrpy uses it. :D


## Change WebMock or VCR configuration

We work on adding new features to the test visibility product in Ruby (intelligent test runner, git metadata upload, code coverage support) that require new endpoints being allowlisted by WebMock/VCR tools when using agentless mode.

Choose a reason for hiding this comment

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

Suggested change
We work on adding new features to the test visibility product in Ruby (intelligent test runner, git metadata upload, code coverage support) that require new endpoints being allowlisted by WebMock/VCR tools when using agentless mode.
Ongoing work on new features to the test visibility product (intelligent test runner, git metadata upload, code coverage support) require new endpoints being allowlisted by WebMock/VCR tools when using agentless mode.

@anmarchenko anmarchenko merged commit 57b8b1f into main Apr 23, 2024
26 checks passed
@anmarchenko anmarchenko deleted the anmarchenko/upgrade_guide_1.0 branch April 23, 2024 14:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants