Skip to content

Release notes

Release notes are compiled from per-change fragments by antsibull-changelog when a release is cut (how releases work); the authoritative rendered file is CHANGELOG.rst in the repository. The highlights:

v2.0.0 (in development on this branch)

A full, breaking rewrite of the collection on top of netorca-sdk ≥ 1.0.9 - the SDK v2 architecture. The migration guide maps every v1 module and pattern to its replacement.

Major changes

  • All v1 modules (get_* / update_*) removed and replaced by idiomatic netorca_*_info / netorca_* modules; removed names fail with a pointer to their replacement.
  • Username/password authentication removed - the NetOrca API is API-key only. Connection parameters can come from NETORCA_* environment variables.
  • Check mode is honoured by every module (v1 update modules performed real writes during --check); write modules report accurate changed and diff.
  • Info modules auto-paginate (v1 returned only the first API page) and return an empty list instead of failing when nothing matches.

Breaking changes

  • url renamed to api_url, verify_ssl to validate_certs; username/password removed.
  • The opaque filters: dictionary replaced by explicit, validated per-module parameters.
  • Return shapes are flat lists under a resource key plus count (no .results nesting).

New in the first v2 slice

  • netorca_service_item_info, netorca_change_instance_info - every platform filter as a validated parameter, declaration content search, history/referenced/dependant views.
  • netorca_change_instance - transition-validated lifecycle management with log and deployed_item.
  • netorca_deployed_item - idempotent create/update/delete of deployed records.

v1.0.25

The final release of the v1 module generation (frozen; pin version: "<2.0.0" to stay on it).