Provide a way to implement a MultiKueue support for the custom Jobs

This is blocked by 

- [x] #2331 
- [x] #2350.

**What would you like to be added**:
I would like to support the extension mechanism so that we can implement the MultiKueue controller for the custom / in-house Jobs. I'm thinking of exposing the `jobAdapter` interface and implementing a mechanism to add arbitrary objects to the `adapters` similar to the jobframework integration manager:

`adapters`: https://github.com/kubernetes-sigs/kueue/blob/e461fe0827786e5cd6f45ff6739ebeed9a700b05/pkg/controller/admissionchecks/multikueue/workload.go#L48-L51
`jobAdapters` interface: https://github.com/kubernetes-sigs/kueue/blob/e461fe0827786e5cd6f45ff6739ebeed9a700b05/pkg/controller/admissionchecks/multikueue/workload.go#L66-L81

`jobframework integration manager`: https://github.com/kubernetes-sigs/kueue/blob/e461fe0827786e5cd6f45ff6739ebeed9a700b05/pkg/controller/jobframework/integrationmanager.go

**Why is this needed**:
In many company, they have company specific CustomResources, and we should give a possibility to manage such CustomResources across multiple clusters.

**Completion requirements**:


This enhancement requires the following artifacts:

- [x] Design doc
- [ ] API change
- [x] Docs update

The artifacts should be linked in subsequent comments.

	type jobAdapter interface {
	// Creates the Job object in the worker cluster using remote client, if not already created.
	// Copy the status from the remote job if already exists.
	SyncJob(ctx context.Context, localClient client.Client, remoteClient client.Client, key types.NamespacedName, workloadName, origin string) error
	// Deletes the Job in the worker cluster.
	DeleteRemoteObject(ctx context.Context, remoteClient client.Client, key types.NamespacedName) error
	// KeepAdmissionCheckPending returns true if the state of the multikueue admission check should be
	// kept Pending while the job runs in a worker. This might be needed to keep the managers job
	// suspended and not start the execution locally.
	KeepAdmissionCheckPending() bool
	// IsJobManagedByKueue returns:
	// - a bool indicating if the job object identified by key is managed by kueue and can be delegated.
	// - a reason indicating why the job is not managed by Kueue
	// - any API error encountered during the check
	IsJobManagedByKueue(ctx context.Context, localClient client.Client, key types.NamespacedName) (bool, string, error)
	}

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Provide a way to implement a MultiKueue support for the custom Jobs #2349

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

	adapters = map[string]jobAdapter{
	batchv1.SchemeGroupVersion.WithKind("Job").String(): &batchJobAdapter{},
	jobset.SchemeGroupVersion.WithKind("JobSet").String(): &jobsetAdapter{},
	}