Describe what the change is solving It helps to add screenshots if it affects the frontend.
Describe the solution
x.java
y.python
Are there any breaking changes? What is the end result perceived by the user?
For connector PRs, use this section to explain which type of semantic versioning bump occurs as a result of the changes. Refer to our Semantic Versioning for Connectors guidelines for more information. Breaking changes to connectors must be documented by an Airbyte engineer (PR author, or reviewer for community PRs) by using the Breaking Change Release Playbook.
If there are breaking changes, please merge this PR with the 🚨🚨 emoji so changelog authors can further highlight this if needed.
Expand the relevant checklist and delete the others.
New Connector
- Community member? Grant edit access to maintainers (instructions)
- Secrets in the connector's spec are annotated with
airbyte_secret
- Unit & integration tests added and passing. Community members, please provide proof of success locally e.g: screenshot or copy-paste unit, integration, and acceptance test output. To run acceptance tests for a Python connector, follow instructions in the README. For java connectors run
./gradlew :airbyte-integrations:connectors:<name>:integrationTest
. - Code reviews completed
- Connector version is set to
0.0.1
-
Dockerfile
has version0.0.1
-
- Documentation updated
- Connector's
README.md
- Connector's
bootstrap.md
. See description and examples -
docs/integrations/<source or destination>/<name>.md
including changelog with an entry for the initial version. See changelog example -
docs/integrations/README.md
-
airbyte-integrations/builds.md
- Connector's
- PR name follows PR naming conventions
If this is a community PR, the Airbyte engineer reviewing this PR is responsible for the below items.
- Create a non-forked branch based on this PR and test the below items on it
- Build is successful
- If new credentials are required for use in CI, add them to GSM. Instructions.
-
/test connector=connectors/<name>
command is passing - New Connector version released on Dockerhub by running the
/publish
command described here - After the connector is published, connector added to connector index as described here
- Seed specs have been re-generated by building the platform and committing the changes to the seed spec files, as described here
Updating a connector
-
Grant edit access to maintainers (instructions)
-
Secrets in the connector's spec are annotated with
airbyte_secret
-
Unit & integration tests added and passing. Community members, please provide proof of success locally e.g: screenshot or copy-paste unit, integration, and acceptance test output. To run acceptance tests for a Python connector, follow instructions in the README. For java connectors run
./gradlew :airbyte-integrations:connectors:<name>:integrationTest
. -
Code reviews completed
-
Connector version has been incremented
- Version has been bumped according to our Semantic Versioning for Connectors guidelines
-
Dockerfile
has updated version
-
Documentation updated
- Connector's
README.md
- Connector's
bootstrap.md
. See description and examples - Changelog updated in
docs/integrations/<source or destination>/<name>.md
with an entry for the new version. See changelog example
- Connector's
-
PR name follows PR naming conventions
If this is a community PR, the Airbyte engineer reviewing this PR is responsible for the below items.
- Create a non-forked branch based on this PR and test the below items on it
- Build is successful
- If new credentials are required for use in CI, add them to GSM. Instructions.
-
/test connector=connectors/<name>
command is passing - New Connector version released on Dockerhub and connector version bumped by running the
/publish
command described here
Connector Generator
- Issue acceptance criteria met
- PR name follows PR naming conventions
- If adding a new generator, add it to the list of scaffold modules being tested
- The generator test modules (all connectors with
-scaffold
in their name) have been updated with the latest scaffold by running./gradlew :airbyte-integrations:connector-templates:generator:testScaffoldTemplates
then checking in your changes - Documentation which references the generator is updated as needed