feat: trigger.enabled + job.run_id lifecycle control (operator v0.1.6, provider v0.1.4)
- TriggerSpec.Enabled bool (default=true): enabled=false масштабирует Deployment до 0
- FunctionJobSpec.RunID int64 (default=0): run_id=0 = skip, >0 = run
- API: PATCH /v1/namespaces/{ns}/triggers/{name} (UpdateTrigger)
- Provider: enabled attribute (Optional, Computed, in-place update)
- Provider: run_id attribute (Optional, Computed, default=0, RequiresReplace)
- operator image: naeel/sless-operator:v0.1.6
- provider: terra.k8c.ru/naeel/sless v0.1.4
This commit is contained in:
“Naeel”
@@ -1,4 +1,4 @@
|
||||
// 2026-03-07
|
||||
// 2026-03-08
|
||||
// client.go — HTTP-клиент для REST API sless оператора.
|
||||
// Намеренно изолирован от terraform-plugin-framework — при переносе в nubes
|
||||
// этот файл кладётся в internal/core/ без изменений.
|
||||
@@ -68,6 +68,14 @@ type TriggerRequest struct {
|
||||
Type string `json:"type"`
|
||||
FunctionRef string `json:"function"`
|
||||
Schedule string `json:"schedule,omitempty"`
|
||||
// Enabled: nil = не передавать (по умолчанию true)
|
||||
Enabled *bool `json:"enabled"`
|
||||
}
|
||||
|
||||
// TriggerUpdateRequest — тело PATCH /v1/namespaces/{ns}/triggers/{name}
|
||||
// Используем *bool чтобы различать nil (не передано) от false (явно выключен).
|
||||
type TriggerUpdateRequest struct {
|
||||
Enabled *bool `json:"enabled"`
|
||||
}
|
||||
|
||||
// TriggerResponse — ответ GET /v1/namespaces/{ns}/triggers/{name}
|
||||
@@ -77,6 +85,7 @@ type TriggerResponse struct {
|
||||
Type string `json:"type"`
|
||||
FunctionRef string `json:"function"`
|
||||
Schedule string `json:"schedule"`
|
||||
Enabled bool `json:"enabled"`
|
||||
Active bool `json:"active"`
|
||||
URL string `json:"url"`
|
||||
Message string `json:"message"`
|
||||
@@ -291,6 +300,23 @@ func (c *Client) DeleteTrigger(ctx context.Context, ns, name string) error {
|
||||
return nil
|
||||
}
|
||||
|
||||
// UpdateTrigger — PATCH /v1/namespaces/{ns}/triggers/{name} → 200
|
||||
// Позволяет изменить enabled без пересоздания триггера.
|
||||
func (c *Client) UpdateTrigger(ctx context.Context, ns, name string, req TriggerUpdateRequest) (*TriggerResponse, error) {
|
||||
url := fmt.Sprintf("%s/v1/namespaces/%s/triggers/%s", c.endpoint, ns, name)
|
||||
resp, err := c.doJSON(ctx, http.MethodPatch, url, req)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
if resp.StatusCode != http.StatusOK {
|
||||
body, _ := io.ReadAll(resp.Body)
|
||||
return nil, fmt.Errorf("update trigger: status %d: %s", resp.StatusCode, body)
|
||||
}
|
||||
var tr TriggerResponse
|
||||
return &tr, json.NewDecoder(resp.Body).Decode(&tr)
|
||||
}
|
||||
|
||||
// --- Job CRUD ---
|
||||
|
||||
// JobRequest — тело POST /v1/namespaces/{ns}/jobs
|
||||
@@ -298,6 +324,8 @@ type JobRequest struct {
|
||||
Name string `json:"name"`
|
||||
FunctionRef string `json:"function"`
|
||||
EventJSON string `json:"event_json,omitempty"`
|
||||
// RunID: 0 = создать без запуска, >0 = запустить
|
||||
RunID int64 `json:"run_id"`
|
||||
}
|
||||
|
||||
// JobResponse — ответ GET /v1/namespaces/{ns}/jobs/{name}
|
||||
@@ -306,6 +334,7 @@ type JobResponse struct {
|
||||
Namespace string `json:"namespace"`
|
||||
FunctionRef string `json:"function"`
|
||||
EventJSON string `json:"event_json"`
|
||||
RunID int64 `json:"run_id"`
|
||||
Phase string `json:"phase"`
|
||||
JobName string `json:"job_name"`
|
||||
StartTime string `json:"start_time"`
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
// 2026-03-07
|
||||
// 2026-03-08
|
||||
// job_resource.go — Terraform ресурс sless_job.
|
||||
//
|
||||
// Lifecycle:
|
||||
@@ -6,12 +6,13 @@
|
||||
// Create: POST /v1/namespaces/{ns}/jobs → WaitJobDone (10 мин)
|
||||
// Блокирует terraform apply до завершения джоба (Succeeded/Failed).
|
||||
// Если Failed — terraform apply падает с ошибкой.
|
||||
// Если run_id=0 — джоб создаётся в k8s, но k8s Job не запускается.
|
||||
// Read: GET /v1/namespaces/{ns}/jobs/{name} → sync phase/timing в state
|
||||
// Delete: DELETE /v1/namespaces/{ns}/jobs/{name}
|
||||
// Семантически no-op (джоб уже выполнен), но убирает CR из кластера.
|
||||
//
|
||||
// Update не поддерживается — любое изменение name/function/event_json требует пересоздания.
|
||||
// Это корректно: job — одноразовое действие, нельзя "обновить" уже выполненное.
|
||||
// run_id: значение 0 = создать без запуска. >0 = запустить/перезапустить джоб.
|
||||
// run_id имеет RequiresReplace: изменение значения (1→2→3) триггерирует повторный запуск.
|
||||
package resources
|
||||
|
||||
import (
|
||||
@@ -23,6 +24,8 @@ import (
|
||||
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema/int64default"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema/int64planmodifier"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema/planmodifier"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema/stringplanmodifier"
|
||||
"github.com/hashicorp/terraform-plugin-framework/types"
|
||||
@@ -48,6 +51,9 @@ type JobModel struct {
|
||||
Name types.String `tfsdk:"name"`
|
||||
Function types.String `tfsdk:"function"`
|
||||
EventJSON types.String `tfsdk:"event_json"`
|
||||
// RunID: 0 = не запускать (Skipped), 1+ = запустить/перезапустить.
|
||||
// RequiresReplace: изменение = пересоздание FunctionJob → новый запуск.
|
||||
RunID types.Int64 `tfsdk:"run_id"`
|
||||
// wait_timeout_sec — максимальное ожидание завершения джоба. Дефолт 600 сек.
|
||||
WaitTimeoutSec types.Int64 `tfsdk:"wait_timeout_sec"`
|
||||
Phase types.String `tfsdk:"phase"`
|
||||
@@ -90,8 +96,17 @@ func (r *JobResource) Schema(_ context.Context, _ resource.SchemaRequest, resp *
|
||||
PlanModifiers: []planmodifier.String{
|
||||
stringplanmodifier.RequiresReplace(),
|
||||
},
|
||||
},
|
||||
// wait_timeout_sec — сколько ждать завершения джоба. Увеличь если код долго работает (например миграция БД).
|
||||
}, // run_id: 0 = создать без запуска (Skipped), >0 = запустить.
|
||||
// Изменение run_id (1→2→3...) триггерирует пересоздание = новый запуск.
|
||||
"run_id": schema.Int64Attribute{
|
||||
Optional: true,
|
||||
Computed: true,
|
||||
Default: int64default.StaticInt64(0),
|
||||
MarkdownDescription: "0 = не запускать; >0 = запустить. Увеличьте run_id для повторного запуска джоба.",
|
||||
PlanModifiers: []planmodifier.Int64{
|
||||
int64planmodifier.RequiresReplace(),
|
||||
},
|
||||
}, // wait_timeout_sec — сколько ждать завершения джоба. Увеличь если код долго работает (например миграция БД).
|
||||
"wait_timeout_sec": schema.Int64Attribute{
|
||||
Optional: true,
|
||||
Computed: true,
|
||||
@@ -146,16 +161,42 @@ func (r *JobResource) Create(ctx context.Context, req resource.CreateRequest, re
|
||||
eventJSON = "{}"
|
||||
}
|
||||
|
||||
// run_id=0: создаём FunctionJob в k8s, но оператор не запустит k8s Job.
|
||||
// Пользователь может поменять run_id > 0 позже чтобы запустить.
|
||||
runID := plan.RunID.ValueInt64()
|
||||
_, err := r.client.CreateJob(ctx, ns, client.JobRequest{
|
||||
Name: plan.Name.ValueString(),
|
||||
FunctionRef: plan.Function.ValueString(),
|
||||
EventJSON: eventJSON,
|
||||
RunID: runID,
|
||||
})
|
||||
if err != nil {
|
||||
resp.Diagnostics.AddError("create job", err.Error())
|
||||
return
|
||||
}
|
||||
|
||||
// Если RunID=0 — не ждём завершения, пишем state сразу
|
||||
if runID == 0 {
|
||||
// state: Namespace/Name/Function из plan, RunID=0, Phase=Skipped, остальное empty
|
||||
waitTimeoutSec := plan.WaitTimeoutSec
|
||||
if waitTimeoutSec.IsNull() || waitTimeoutSec.IsUnknown() || waitTimeoutSec.ValueInt64() <= 0 {
|
||||
waitTimeoutSec = types.Int64Value(defaultWaitTimeoutSec)
|
||||
}
|
||||
resp.Diagnostics.Append(resp.State.Set(ctx, JobModel{
|
||||
Namespace: types.StringValue(plan.Namespace.ValueString()),
|
||||
Name: types.StringValue(plan.Name.ValueString()),
|
||||
Function: types.StringValue(plan.Function.ValueString()),
|
||||
EventJSON: plan.EventJSON,
|
||||
RunID: types.Int64Value(0),
|
||||
WaitTimeoutSec: waitTimeoutSec,
|
||||
Phase: types.StringValue("Skipped"),
|
||||
StartTime: types.StringValue(""),
|
||||
CompletionTime: types.StringValue(""),
|
||||
Message: types.StringValue("run_id=0: set run_id>0 to execute"),
|
||||
})...)
|
||||
return
|
||||
}
|
||||
|
||||
// Блокируем apply до завершения джоба (Succeeded или Failed)
|
||||
waitSec := plan.WaitTimeoutSec.ValueInt64()
|
||||
if waitSec <= 0 {
|
||||
@@ -220,6 +261,7 @@ func jobToModel(plan JobModel, j *client.JobResponse) JobModel {
|
||||
Name: types.StringValue(j.Name),
|
||||
Function: types.StringValue(j.FunctionRef),
|
||||
EventJSON: plan.EventJSON,
|
||||
RunID: types.Int64Value(j.RunID),
|
||||
WaitTimeoutSec: waitTimeoutSec,
|
||||
Phase: types.StringValue(j.Phase),
|
||||
StartTime: types.StringValue(j.StartTime),
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
// 2026-03-07
|
||||
// 2026-03-08
|
||||
// trigger_resource.go — Terraform ресурс sless_trigger.
|
||||
// Поддерживает type=http (создаёт Service+Ingress) и type=cron (запускает по schedule).
|
||||
// Все ключевые поля имеют RequiresReplace — API не поддерживает обновление триггеров.
|
||||
// URL функции (для http-триггера) — computed, пишется оператором в status.url.
|
||||
// enabled=false: масштабирует Deployment функции до 0 (не принимает запросы, не потребляет ресурсы).
|
||||
// enabled не требует RequiresReplace — поддерживает in-place обновление через PATCH.
|
||||
package resources
|
||||
|
||||
import (
|
||||
@@ -13,6 +13,7 @@ import (
|
||||
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema/booldefault"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema/boolplanmodifier"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema/planmodifier"
|
||||
"github.com/hashicorp/terraform-plugin-framework/resource/schema/stringplanmodifier"
|
||||
@@ -36,8 +37,11 @@ type TriggerModel struct {
|
||||
Type types.String `tfsdk:"type"`
|
||||
FunctionRef types.String `tfsdk:"function"`
|
||||
Schedule types.String `tfsdk:"schedule"`
|
||||
Active types.Bool `tfsdk:"active"`
|
||||
URL types.String `tfsdk:"url"`
|
||||
// Enabled — false = Deployment масштабируется до 0, функция не потребляет ресурсы.
|
||||
// Не требует пересоздания - изменяется in-place через PATCH.
|
||||
Enabled types.Bool `tfsdk:"enabled"`
|
||||
Active types.Bool `tfsdk:"active"`
|
||||
URL types.String `tfsdk:"url"`
|
||||
}
|
||||
|
||||
func (r *TriggerResource) Metadata(_ context.Context, req resource.MetadataRequest, resp *resource.MetadataResponse) {
|
||||
@@ -80,6 +84,13 @@ func (r *TriggerResource) Schema(_ context.Context, _ resource.SchemaRequest, re
|
||||
stringplanmodifier.RequiresReplace(),
|
||||
},
|
||||
},
|
||||
// enabled: false → Deployment масштабируется до 0 (не удаляет ресурс).
|
||||
// Не имеет RequiresReplace: применяется in-place через PATCH.
|
||||
"enabled": schema.BoolAttribute{
|
||||
Optional: true,
|
||||
Computed: true,
|
||||
Default: booldefault.StaticBool(true),
|
||||
},
|
||||
// active, url — только для чтения, вычисляются оператором
|
||||
"active": schema.BoolAttribute{
|
||||
Computed: true,
|
||||
@@ -124,6 +135,7 @@ func (r *TriggerResource) Create(ctx context.Context, req resource.CreateRequest
|
||||
Type: plan.Type.ValueString(),
|
||||
FunctionRef: plan.FunctionRef.ValueString(),
|
||||
Schedule: plan.Schedule.ValueString(),
|
||||
Enabled: boolPtr(plan.Enabled.ValueBool()),
|
||||
})
|
||||
if err != nil {
|
||||
resp.Diagnostics.AddError("create trigger", err.Error())
|
||||
@@ -153,10 +165,26 @@ func (r *TriggerResource) Read(ctx context.Context, req resource.ReadRequest, re
|
||||
resp.Diagnostics.Append(resp.State.Set(ctx, trToModel(tr))...)
|
||||
}
|
||||
|
||||
// Update — никогда не вызывается: все поля имеют RequiresReplace.
|
||||
// Метод обязателен интерфейсом resource.Resource.
|
||||
func (r *TriggerResource) Update(_ context.Context, _ resource.UpdateRequest, resp *resource.UpdateResponse) {
|
||||
resp.Diagnostics.AddError("update not supported", "all trigger fields require replacement")
|
||||
// Update — обновляет enabled через PATCH без пересоздания.
|
||||
// единственное поле без RequiresReplace, поэтому Update срабатывает только если enabled изменился.
|
||||
func (r *TriggerResource) Update(ctx context.Context, req resource.UpdateRequest, resp *resource.UpdateResponse) {
|
||||
var plan, state TriggerModel
|
||||
resp.Diagnostics.Append(req.Plan.Get(ctx, &plan)...)
|
||||
resp.Diagnostics.Append(req.State.Get(ctx, &state)...)
|
||||
if resp.Diagnostics.HasError() {
|
||||
return
|
||||
}
|
||||
|
||||
enabled := plan.Enabled.ValueBool()
|
||||
tr, err := r.client.UpdateTrigger(ctx, plan.Namespace.ValueString(), plan.Name.ValueString(), client.TriggerUpdateRequest{
|
||||
Enabled: &enabled,
|
||||
})
|
||||
if err != nil {
|
||||
resp.Diagnostics.AddError("update trigger", err.Error())
|
||||
return
|
||||
}
|
||||
|
||||
resp.Diagnostics.Append(resp.State.Set(ctx, trToModel(tr))...)
|
||||
}
|
||||
|
||||
func (r *TriggerResource) Delete(ctx context.Context, req resource.DeleteRequest, resp *resource.DeleteResponse) {
|
||||
@@ -185,7 +213,13 @@ func trToModel(tr *client.TriggerResponse) TriggerModel {
|
||||
Type: types.StringValue(tr.Type),
|
||||
FunctionRef: types.StringValue(tr.FunctionRef),
|
||||
Schedule: schedule,
|
||||
Enabled: types.BoolValue(tr.Enabled),
|
||||
Active: types.BoolValue(tr.Active),
|
||||
URL: types.StringValue(tr.URL),
|
||||
}
|
||||
}
|
||||
|
||||
// boolPtr — хелпер для получения указателя на bool (API требует *bool).
|
||||
func boolPtr(v bool) *bool {
|
||||
return &v
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user