Skip to content

Remove or deprecate service-template support #17

@guoqqqi

Description

@guoqqqi

Background

The latest API7 EE versions have removed the service template APIs, including the control-plane endpoints currently used by a7 service-template, such as:

  • /api/services/template
  • /api/services/template/{id}
  • /api/services/publish

In PR #16, E2E was adjusted to skip service-template tests when the current API7 EE environment returns 404 HTML or resource not found. That keeps CI green, but it is only a compatibility guard. The CLI still exposes service-template commands even though the backing API is no longer available in current API7 EE.

Problem

Keeping a7 service-template as a normal command can mislead users into expecting the feature to work against supported API7 EE versions.

Current affected areas:

  • pkg/cmd/service-template/*
  • docs/user-guide/service-template.md
  • skills or recipes that reference a7 service-template
  • E2E tests in test/e2e/service_template_test.go
  • command discovery/help output

Proposed Follow-Up

Decide how to remove or deprecate service-template support.

Suggested options:

  • Remove the service-template command group entirely if no supported API7 EE version exposes these APIs.
  • Or keep a compatibility command that fails fast with a clear message explaining that service templates are no longer supported by API7 EE.
  • Remove or update docs and skills that teach users to use service templates.
  • Remove service-template E2E CRUD coverage, or keep only a lightweight compatibility/error-message test.
  • Update any roadmap or API spec docs that still describe service-template as available.

Acceptance Criteria

  • Users are not guided toward a7 service-template as a working API7 EE workflow.
  • CLI behavior is explicit: removed command, hidden command, or clear deprecation/unsupported error.
  • Docs and skills no longer present service-template as a supported current API7 EE resource.
  • E2E no longer contains full CRUD coverage for APIs that no longer exist.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions