package stacks import ( "fmt" "net/http" portainer "github.com/portainer/portainer/api" "github.com/portainer/portainer/api/git/update" "github.com/portainer/portainer/api/gitops/sources" "github.com/portainer/portainer/api/internal/endpointutils" "github.com/portainer/portainer/api/internal/registryutils" "github.com/portainer/portainer/api/stacks/stackbuilders" "github.com/portainer/portainer/api/stacks/stackutils" httperror "github.com/portainer/portainer/pkg/libhttp/error" "github.com/portainer/portainer/pkg/libhttp/request" "github.com/portainer/portainer/pkg/libhttp/response" "github.com/portainer/portainer/pkg/validate" "github.com/pkg/errors" ) type kubernetesStringDeploymentPayload struct { StackName string ComposeFormat bool Namespace string StackFileContent string // Whether the stack is from a app template FromAppTemplate bool `example:"false"` } func createStackPayloadFromK8sFileContentPayload(name, namespace, fileContent string, composeFormat, fromAppTemplate bool) stackbuilders.StackPayload { return stackbuilders.StackPayload{ StackName: name, Namespace: namespace, StackFileContent: []byte(fileContent), FromAppTemplate: fromAppTemplate, } } type kubernetesGitDeploymentPayload struct { StackName string ComposeFormat bool Namespace string // SourceID references an existing Source for git credentials/URL. // When set, the inline URL and authentication fields are ignored. SourceID portainer.SourceID `example:"1"` // Deprecated: use SourceID instead. URL of a Git repository hosting the Stack file. RepositoryURL string // Deprecated: use SourceID instead. Reference name of a Git repository hosting the Stack file. RepositoryReferenceName string // Deprecated: use SourceID instead. Use basic authentication to clone the Git repository. RepositoryAuthentication bool // Deprecated: use SourceID instead. Username used in basic authentication. RepositoryUsername string // Deprecated: use SourceID instead. Password used in basic authentication. RepositoryPassword string ManifestFile string AdditionalFiles []string AutoUpdate *portainer.AutoUpdateSettings // Deprecated: use SourceID instead. TLSSkipVerify skips SSL verification when cloning the Git repository. TLSSkipVerify bool `example:"false"` } func createStackPayloadFromK8sGitPayload(name, repoUrl, repoReference, repoUsername, repoPassword string, repoAuthentication, composeFormat bool, namespace, manifest string, additionalFiles []string, autoUpdate *portainer.AutoUpdateSettings, repoSkipSSLVerify bool, sourceID portainer.SourceID) stackbuilders.StackPayload { return stackbuilders.StackPayload{ StackName: name, RepositoryConfigPayload: stackbuilders.RepositoryConfigPayload{ SourceID: sourceID, URL: repoUrl, ReferenceName: repoReference, Authentication: repoAuthentication, Username: repoUsername, Password: repoPassword, TLSSkipVerify: repoSkipSSLVerify, }, Namespace: namespace, ManifestFile: manifest, AdditionalFiles: additionalFiles, AutoUpdate: autoUpdate, } } type kubernetesManifestURLDeploymentPayload struct { StackName string Namespace string ComposeFormat bool ManifestURL string } func createStackPayloadFromK8sUrlPayload(name, namespace, manifestUrl string, composeFormat bool) stackbuilders.StackPayload { return stackbuilders.StackPayload{ StackName: name, Namespace: namespace, ManifestURL: manifestUrl, } } func (payload *kubernetesStringDeploymentPayload) Validate(r *http.Request) error { if len(payload.StackFileContent) == 0 { return errors.New("Invalid stack file content") } return nil } func (payload *kubernetesGitDeploymentPayload) Validate(r *http.Request) error { if payload.SourceID == 0 { if len(payload.RepositoryURL) == 0 || !validate.IsURL(payload.RepositoryURL) { return errors.New("Invalid repository URL. Must correspond to a valid URL format") } if payload.RepositoryAuthentication && len(payload.RepositoryPassword) == 0 { return errors.New("Invalid repository credentials. Password must be specified when authentication is enabled") } } if len(payload.ManifestFile) == 0 { return errors.New("Invalid manifest file in repository") } return update.ValidateAutoUpdateSettings(payload.AutoUpdate) } func (payload *kubernetesManifestURLDeploymentPayload) Validate(r *http.Request) error { if len(payload.ManifestURL) == 0 || !validate.IsURL(payload.ManifestURL) { return errors.New("Invalid manifest URL") } return nil } type createKubernetesStackResponse struct { Output string `json:"Output"` } // @id StackCreateKubernetesFile // @summary Deploy a new kubernetes stack from a file // @description Deploy a new stack into a Docker environment specified via the environment identifier. // @description **Access policy**: authenticated // @tags stacks // @security ApiKeyAuth // @security jwt // @produce json // @param body body kubernetesStringDeploymentPayload true "stack config" // @param endpointId query int true "Identifier of the environment that will be used to deploy the stack" // @success 200 {object} portainer.Stack // @failure 400 "Invalid request" // @failure 500 "Server error" // @router /stacks/create/kubernetes/string [post] func (handler *Handler) createKubernetesStackFromFileContent(w http.ResponseWriter, r *http.Request, endpoint *portainer.Endpoint, userID portainer.UserID) *httperror.HandlerError { if !endpointutils.IsKubernetesEndpoint(endpoint) { return httperror.BadRequest("Environment type does not match", errors.New("Environment type does not match")) } var payload kubernetesStringDeploymentPayload if err := request.DecodeAndValidateJSONPayload(r, &payload); err != nil { return httperror.BadRequest("Invalid request payload", err) } user, err := handler.DataStore.User().Read(userID) if err != nil { return httperror.InternalServerError("Unable to load user information from the database", err) } stackPayload := createStackPayloadFromK8sFileContentPayload(payload.StackName, payload.Namespace, payload.StackFileContent, payload.ComposeFormat, payload.FromAppTemplate) k8sStackBuilder := stackbuilders.CreateK8sStackFileContentBuilder(handler.DataStore, handler.FileService, handler.StackDeployer, handler.KubernetesDeployer, user) // Refresh ECR registry secret if needed // RefreshEcrSecret method checks if the namespace has any ECR registry // otherwise return nil cli, err := handler.KubernetesClientFactory.GetPrivilegedKubeClient(endpoint) if err == nil { if err := registryutils.RefreshEcrSecret(cli, endpoint, handler.DataStore, payload.Namespace); err != nil { return httperror.InternalServerError("Unable to refresh ECR registry secret", err) } } if _, err := stackbuilders.Build(r.Context(), handler.DataStore, k8sStackBuilder, &stackPayload, endpoint, userID); err != nil { return err } resp := &createKubernetesStackResponse{ Output: k8sStackBuilder.GetResponse(), } return response.JSON(w, resp) } // @id StackCreateKubernetesGit // @summary Deploy a new kubernetes stack from a git repository // @description Deploy a new stack into a Docker environment specified via the environment identifier. // @description **Access policy**: authenticated // @tags stacks // @security ApiKeyAuth // @security jwt // @produce json // @param body body kubernetesGitDeploymentPayload true "stack config" // @param endpointId query int true "Identifier of the environment that will be used to deploy the stack" // @success 200 {object} portainer.Stack // @failure 400 "Invalid request" // @failure 409 "Stack name or webhook ID already exists" // @failure 500 "Server error" // @router /stacks/create/kubernetes/repository [post] func (handler *Handler) createKubernetesStackFromGitRepository(w http.ResponseWriter, r *http.Request, endpoint *portainer.Endpoint, userID portainer.UserID) *httperror.HandlerError { if !endpointutils.IsKubernetesEndpoint(endpoint) { return httperror.BadRequest("Environment type does not match", errors.New("Environment type does not match")) } var payload kubernetesGitDeploymentPayload if err := request.DecodeAndValidateJSONPayload(r, &payload); err != nil { return httperror.BadRequest("Invalid request payload", err) } user, err := handler.DataStore.User().Read(userID) if err != nil { return httperror.InternalServerError("Unable to load user information from the database", err) } // Make sure the webhook ID is unique if payload.AutoUpdate != nil && payload.AutoUpdate.Webhook != "" { if isUnique, err := handler.checkUniqueWebhookID(handler.DataStore, payload.AutoUpdate.Webhook); err != nil { return httperror.InternalServerError("Unable to check for webhook ID collision", err) } else if !isUnique { return httperror.Conflict(fmt.Sprintf("Webhook ID: %s already exists", payload.AutoUpdate.Webhook), stackutils.ErrWebhookIDAlreadyExists) } } if payload.SourceID != 0 { if _, httpErr := sources.ValidateGitSourceAccess(handler.DataStore, payload.SourceID); httpErr != nil { return httpErr } } stackPayload := createStackPayloadFromK8sGitPayload(payload.StackName, payload.RepositoryURL, payload.RepositoryReferenceName, payload.RepositoryUsername, payload.RepositoryPassword, payload.RepositoryAuthentication, payload.ComposeFormat, payload.Namespace, payload.ManifestFile, payload.AdditionalFiles, payload.AutoUpdate, payload.TLSSkipVerify, payload.SourceID, ) k8sStackBuilder := stackbuilders.CreateKubernetesStackGitBuilder(handler.DataStore, handler.FileService, handler.GitService, handler.Scheduler, handler.StackDeployer, handler.KubernetesDeployer, user) if _, err := stackbuilders.Build(r.Context(), handler.DataStore, k8sStackBuilder, &stackPayload, endpoint, userID); err != nil { return err } return response.JSON(w, &createKubernetesStackResponse{ Output: k8sStackBuilder.GetResponse(), }) } // @id StackCreateKubernetesUrl // @summary Deploy a new kubernetes stack from a url // @description Deploy a new stack into a Docker environment specified via the environment identifier. // @description **Access policy**: authenticated // @tags stacks // @security ApiKeyAuth // @security jwt // @produce json // @param body body kubernetesManifestURLDeploymentPayload true "stack config" // @param endpointId query int true "Identifier of the environment that will be used to deploy the stack" // @success 200 {object} portainer.Stack // @failure 400 "Invalid request" // @failure 500 "Server error" // @router /stacks/create/kubernetes/url [post] func (handler *Handler) createKubernetesStackFromManifestURL(w http.ResponseWriter, r *http.Request, endpoint *portainer.Endpoint, userID portainer.UserID) *httperror.HandlerError { var payload kubernetesManifestURLDeploymentPayload if err := request.DecodeAndValidateJSONPayload(r, &payload); err != nil { return httperror.BadRequest("Invalid request payload", err) } user, err := handler.DataStore.User().Read(userID) if err != nil { return httperror.InternalServerError("Unable to load user information from the database", err) } stackPayload := createStackPayloadFromK8sUrlPayload(payload.StackName, payload.Namespace, payload.ManifestURL, payload.ComposeFormat) k8sStackBuilder := stackbuilders.CreateKubernetesStackUrlBuilder(handler.DataStore, handler.FileService, handler.StackDeployer, handler.KubernetesDeployer, user) if _, err := stackbuilders.Build(r.Context(), handler.DataStore, k8sStackBuilder, &stackPayload, endpoint, userID); err != nil { return err } return response.JSON(w, &createKubernetesStackResponse{ Output: k8sStackBuilder.GetResponse(), }) }