scheduler: add rpcs for actions on job and invocation.

scheduler/appengine/presentation/state.go

 // Copyright 2017 The LUCI Authors. All rights reserved.
 // Use of this source code is governed under the Apache License, Version 2.0
 // that can be found in the LICENSE file.
 
 package presentation
 
 import (
         "fmt"
 
         "golang.org/x/net/context"
 
         "github.com/luci/luci-go/common/logging"
         "github.com/luci/luci-go/scheduler/appengine/catalog"
         "github.com/luci/luci-go/scheduler/appengine/engine"
         "github.com/luci/luci-go/scheduler/appengine/task"
 )
 
 // PublicStateKind defines state of the job which is exposed in UI and API
 // instead of internal engine.StateKind which is kept as an implementation
 // detail.
 type PublicStateKind string
 
+// When a PublicStateKind is added/removed/updated, update scheduler api proto
+// doc for `JobState`.
 const (
         PublicStateDisabled  PublicStateKind = "DISABLED"
         PublicStateOverrun   PublicStateKind = "OVERRUN"
         PublicStatePaused    PublicStateKind = "PAUSED"
         PublicStateRetrying  PublicStateKind = "RETRYING"
         PublicStateRunning   PublicStateKind = "RUNNING"
         PublicStateScheduled PublicStateKind = "SCHEDULED"
         PublicStateStarting  PublicStateKind = "STARTING"
         PublicStateSuspended PublicStateKind = "SUSPENDED"
         PublicStateWaiting   PublicStateKind = "WAITING"
@@ skipping 55 matching lines @@
         taskDef, err := cat.UnmarshalTask(j.Task)
         if err != nil {
                 logging.WithError(err).Warningf(ctx, "Failed to unmarshal task proto for %s", j.JobID)
                 return task.Traits{}, err
         }
         if manager := cat.GetTaskManager(taskDef); manager != nil {
                 return manager.Traits(), nil
         }
         return task.Traits{}, nil
 }