internal

package
v0.2.0-beta Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 21, 2021 License: MIT Imports: 48 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	// FS is a Memory Map Filesystem.
	FS = afero.NewOsFs()
	// AFS is the implementation of Afero Filesystem.
	AFS = &afero.Afero{Fs: FS}
)
View Source 
var (
	// ErrEmptyDirName occurs when directory name is empty.
	ErrEmptyDirName = errors.New("empty directory name")
	// ErrFileWithThisDirNameExist occurs when file already exist.
	ErrFileWithThisDirNameExist = errors.New("file with the same name exists")
	// ErrFileNotFound occurs when file is not found.
	ErrFileNotFound = errors.New("file not found")
	// ErrUnknownEnvType occurs when an unknown environment type is specified.
	ErrUnknownEnvType = errors.New("unknown env type")
	// ErrUnknownAction occurs when an unknown actions is called.
	ErrUnknownAction = errors.New("unknown action error")
	// ErrDockerIsNotRunning occurs when Docker is not running or Docker version is too old and the application cannot
	// call Docker API.
	ErrDockerIsNotRunning = errors.New("docker is not running or docker version is too old")
	// ErrDockerVersionMismatch occurs when Docker version is too old.
	ErrDockerVersionMismatch = errors.New("docker version is too old")
	// ErrDockerComposeVersionMismatch occurs when docker-compose version is too old.
	ErrDockerComposeVersionMismatch = errors.New("docker-compose version is too old")
	// ErrEnvNameIsInvalid occurs when the environment name is invalid. It should be a valid hostname.
	ErrEnvNameIsInvalid = errors.New("environment name is invalid, it should match RFC1178")
	// ErrEnvIsEmpty occurs when environment name is empty.
	ErrEnvIsEmpty = fmt.Errorf("env name is empty. please run `%v env-init`", AppName)
	// ErrCaCertDoesNotExist occurs when the Signing CA Certificate is not yet created.
	ErrCaCertDoesNotExist = fmt.Errorf(
		"the root CA certificate is missing, please run '%v install' and try again",
		AppName)
	// ErrCannotFindContainer occurs when the application cannot find the requested container.
	ErrCannotFindContainer = errors.New("container cannot be found")
	// ErrArgumentRequired occurs when the function is called without a required argument.
	ErrArgumentRequired = errors.New("argument required")
	// ErrInvokedAsRootUser occurs when the Application was called by Root user.
	ErrInvokedAsRootUser = errors.New("In most cases, you should not run " +
		AppName + " as root user except for `self-update`. " + "If you are sure you want to do this, use " +
		strings.ToUpper(AppName) + "_ALLOW_SUPERUSER=1.")
)
View Source 
var (

	// ShellCommand is the command which is called in the ShellContainer.
	ShellCommand []string
	// ShellContainer is the container used for shell command.
	ShellContainer string
)
View Source 
var (
	// AppName is the lowercase Application Name, used globally.
	AppName = strings.ToLower(appname)
)

Functions

func AppendEnvironmentTemplates 

func AppendEnvironmentTemplates(t *template.Template, templateList *list.List, partialName string) error

AppendEnvironmentTemplates tries to look up all the templates dedicated for an environment type.

func AppendMutagenTemplates 

func AppendMutagenTemplates(t *template.Template, templateList *list.List, partialName string) error

AppendMutagenTemplates is going to add mutagen configuration templates.

func AppendTemplatesFromPaths 

func AppendTemplatesFromPaths(t *template.Template, templateList *list.List, paths []string) error

AppendTemplatesFromPaths appends templates to t from templateList list searching them in paths path list. If it cannot find templates it's not going to fail. If a template with the same name already exists, it's going to skip that template.

func AppendTemplatesFromPathsStatic 

func AppendTemplatesFromPathsStatic(t *template.Template, templateList *list.List, paths []string) error

AppendTemplatesFromPathsStatic appends templates to t from templateList list searching them in paths path list. This function looks up templates built to the application's binary (static files). If it cannot find templates it's not going to fail. If a template with the same name already exists, it's going to skip that template.

func ArgumentRequiredError 

func ArgumentRequiredError(op string) error

ArgumentRequiredError is a wrapper function for ErrArgumentRequired error.

func AskForConfirmation 

func AskForConfirmation(msg string, suppressMessage ...bool) bool

AskForConfirmation ask msg from the user and returns the answer.

func BlackfireCmd 

func BlackfireCmd(cmd *cobra.Command, args []string) error

BlackfireCmd represents the blackfire command.

func BootstrapCmd 

func BootstrapCmd() error

BootstrapCmd represents the bootstrap command.

func CannotFindContainerError 

func CannotFindContainerError(op string) error

CannotFindContainerError is a wrapper function for ErrCannotFindContainer error.

func CheckAndInstallMutagen 

func CheckAndInstallMutagen() error

CheckAndInstallMutagen checks if mutagen is available. If not, it's going to install mutagen.

func CheckCaCertificateExistInDir 

func CheckCaCertificateExistInDir(caDir string, dontAskRecreate ...bool) bool

CheckCaCertificateExistInDir checks if the CA Certificate PEM file already exists in Dir.

func CheckDocker 

func CheckDocker() error

CheckDocker checks if docker-engine is running or not.

func CheckDockerNetworkExist 

func CheckDockerNetworkExist(networkName string) (bool, error)

CheckDockerNetworkExist returns true if the docker network exists.

func CheckExitCodeOfCommand 

func CheckExitCodeOfCommand(command string) int

CheckExitCodeOfCommand runs a command and returns its exit code.

func CheckFileExists 

func CheckFileExists(file string) bool

CheckFileExists checks if the file already exists and ask the user if he'd like to recreate it.

func CheckFileExistsAndRecreate 

func CheckFileExistsAndRecreate(file string) bool

CheckFileExistsAndRecreate checks if the file already exists and ask the user if he'd like to recreate it. 

If user input is yes - return false (as if the file does not existing).

func CheckIfInstalled 

func CheckIfInstalled() error

CheckIfInstalled returns an error if the application is not yet installed.

func CheckRegexInFile 

func CheckRegexInFile(regex, filePath string) (bool, error)

CheckRegexInFile checks if the file contains content.

func CheckRegexInString 

func CheckRegexInString(regex, str string) bool

CheckRegexInString checks if the string contains content.

func Cleanup 

func Cleanup() error

Cleanup removes all the temporary template files.

func ContainsString 

func ContainsString(slice []string, val string) bool

ContainsString checks if a slice of string contains a string.

func ConvertTemplateToComposeConfig 

func ConvertTemplateToComposeConfig(t *template.Template, templateList *list.List) (compose.ConfigDetails, error)

ConvertTemplateToComposeConfig iterates through all the templates and converts them to docker-compose configurations.

func CreateCaCertificate 

func CreateCaCertificate(caDir string) error

CreateCaCertificate creates a Private Key and a Signed CA Certificate in PEM format and writes to file.

func CreateDir 

func CreateDir(dir string, perms ...int) error

CreateDir creates the directory if not exist.

func CreateDirAndWriteBytesToFile 

func CreateDirAndWriteBytesToFile(bytes []byte, file string, perms ...int) error

CreateDirAndWriteBytesToFile creates the base directory and writes bytes to a file in it.

func CreatePrivKeyAndCertificate 

func CreatePrivKeyAndCertificate(certDir string, certName string,
	dnsNames []string, caCertFilePath, caPrivKeyFilePath string) error

CreatePrivKeyAndCertificate creates a Private Key and a Certificate signed by caCertificate and writes to file in PEM format.

func CreateSignedCertificate 

func CreateSignedCertificate(c certificateComponents) ([]byte, error)

func DBBuildDockerComposeCommand 

func DBBuildDockerComposeCommand(args []string, suppressOsStdOut ...bool) (string, error)

DBBuildDockerComposeCommand builds up the docker-compose command's templates.

func DBConnectCmd 

func DBConnectCmd(cmd *cobra.Command, args []string) error

DBConnectCmd connects to the environment's database container.

func DBDumpCmd 

func DBDumpCmd(cmd *cobra.Command, args []string) error

DBDumpCmd dumps the database from the environment's database container.

func DBImportCmd 

func DBImportCmd(cmd *cobra.Command, args []string) error

DBImportCmd imports a database from stdin to the environment's database container.

func DBRunDockerCompose 

func DBRunDockerCompose(args []string, suppressOsStdOut ...bool) error

DBRunDockerCompose function is a wrapper around the docker-compose command. 

It appends the current directory and current project name to the args.
It also changes the output if the OS StdOut is suppressed.

func DBRunDockerComposeCommandModifyStdin 

func DBRunDockerComposeCommandModifyStdin(args []string, suppressOsStdOut ...bool) (string, error)

DBRunDockerComposeCommandModifyStdin runs the passed parameters with docker-compose and returns the output.

func DBRunDockerComposeWithConfig 

func DBRunDockerComposeWithConfig(
	args []string, details compose.ConfigDetails, suppressOsStdOut ...bool) (string, error)

DBRunDockerComposeWithConfig calls docker-compose with the previously built docker-compose configuration.

func DebugCmd 

func DebugCmd(cmd *cobra.Command, args []string) error

DebugCmd opens a shell in the debug container.

func DockerComposeCompleter 

func DockerComposeCompleter() func(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)

DockerComposeCompleter returns a completer function for docker-compose.

func DockerComposeVersionMismatchError 

func DockerComposeVersionMismatchError(op string) error

DockerComposeVersionMismatchError is a wrapper function for ErrDockerComposeVersionMismatch error.

func DockerPeeredServices 

func DockerPeeredServices(action, networkName string) error

DockerPeeredServices attaches/detaches the common services to the current environment's docker network.

func DockerVersionMismatchError 

func DockerVersionMismatchError(op string) error

DockerVersionMismatchError is a wrapper function for ErrDockerVersionMismatch error.

func EncodeRSAPrivateKeyToPEM 

func EncodeRSAPrivateKeyToPEM(privateKey *rsa.PrivateKey) ([]byte, error)

EncodeRSAPrivateKeyToPEM encodes Private Key from RSA to PEM format.

func EnvBuildDockerComposeCommand 

func EnvBuildDockerComposeCommand(args []string, suppressOsStdOut ...bool) (string, error)

EnvBuildDockerComposeCommand builds up the docker-compose command by passing it the previously built templates.

func EnvBuildDockerComposeTemplate 

func EnvBuildDockerComposeTemplate(t *template.Template, templateList *list.List) error

EnvBuildDockerComposeTemplate builds the templates which are used to invoke docker-compose.

func EnvCheck 

func EnvCheck() error

EnvCheck returns an error if the env name is empty (.env file does not contain an env name).

func EnvCmd 

func EnvCmd(args []string) error

EnvCmd build up the contents for the env command.

func EnvInitCmd 

func EnvInitCmd(cmd *cobra.Command, args []string) error

EnvInitCmd creates a .env file for envType based on envName.

func EnvRunDockerCompose 

func EnvRunDockerCompose(args []string, suppressOsStdOut ...bool) error

EnvRunDockerCompose function is a wrapper around the docker-compose command. 

It appends the current directory and current project name to the args.
It also changes the output if the OS StdOut is suppressed.

func EvalSymlinkPath 

func EvalSymlinkPath(file string) (string, error)

EvalSymlinkPath checks if file exists and returns the resolved path if a symlink if file is a symlink, 

else it returns the filepath.

func ExecuteTemplate 

func ExecuteTemplate(t *template.Template, buffer io.Writer) error

ExecuteTemplate executes the templates, appending some specific template functions to the execution.

func ExtractUnknownArgs 

func ExtractUnknownArgs(flags *pflag.FlagSet, args []string) []string

ExtractUnknownArgs returns []string arguments which are not used by pflags.

func FileNotFoundError 

func FileNotFoundError(op string) error

FileNotFoundError is a wrapper function for ErrFileNotFound error.

func GenerateAndSaveSSHKeys 

func GenerateAndSaveSSHKeys(bitSize int, pathToSave string) error

GenerateAndSaveSSHKeys generates and writes SSH keys with bitSize and saves them to pathToSave.

func GenerateMutagenTemplateFileIfNotExist 

func GenerateMutagenTemplateFileIfNotExist() error

GenerateMutagenTemplateFileIfNotExist generates mutagen configuration from template if it doesn't exists.

func GenerateRSAPrivateKey 

func GenerateRSAPrivateKey(bitSize int) (*rsa.PrivateKey, error)

GenerateRSAPrivateKey creates a RSA Private Key of specified byte size.

func GenerateSSHPublicKey 

func GenerateSSHPublicKey(publicKey *rsa.PublicKey) ([]byte, error)

GenerateSSHPublicKey takes a rsa.PublicKey and return bytes suitable for writing to .pub file returns in the format "ssh-rsa ...".

func GetAppHomeDir 

func GetAppHomeDir() string

GetAppHomeDir returns the application's home directory.

func GetAppVersion 

func GetAppVersion() *version.Version

GetAppVersion returns a version.Version object contains the application version.

func GetBlackfireCommand 

func GetBlackfireCommand() string

GetBlackfireCommand returns the command which is called when the application manipulates blackfire.

func GetBlackfireContainer 

func GetBlackfireContainer() string

GetBlackfireContainer returns the container name of the Blackfire debug container.

func GetCaCertificateFilePath 

func GetCaCertificateFilePath(caDir string) (string, error)

GetCaCertificateFilePath returns the CA certificate path based on caDir.

func GetCaPrivKeyFilePath 

func GetCaPrivKeyFilePath(caDir string) (string, error)

GetCaPrivKeyFilePath returns the CA privkey path based on caDir.

func GetContainerIDByName 

func GetContainerIDByName(containerName string) (string, error)

GetContainerIDByName returns a container ID of the containerName running in 

the current environment.

func GetContainerStateByName 

func GetContainerStateByName(containerName string) (string, error)

GetContainerStateByName returns the container state of the containerName running in 

the current environment.

func GetCwd 

func GetCwd() string

GetCwd returns the current working directory.

func GetDBCommand 

func GetDBCommand() string

GetDBCommand returns the command which is called when the application manipulates the database.

func GetDBContainer 

func GetDBContainer() string

GetDBContainer returns the name of the database container.

func GetDBDumpCommand 

func GetDBDumpCommand() string

GetDBDumpCommand returns the command which is called when the application dumps a database.

func GetEnvName 

func GetEnvName() string

GetEnvName returns the environment name in lowercase format.

func GetEnvNetworkName 

func GetEnvNetworkName() string

GetEnvNetworkName returns the environments docker network name in lowercase format.

func GetEnvType 

func GetEnvType() string

GetEnvType returns the environment type in lowercase format.

func GetHomeDir 

func GetHomeDir() string

GetHomeDir returns the invoking user's home directory.

func GetMagentoBackendFrontname 

func GetMagentoBackendFrontname() string

GetMagentoBackendFrontname returns Magento admin path from Viper settings.

func GetMagentoVersion 

func GetMagentoVersion() *version.Version

GetMagentoVersion returns a *version.Version object which contains the Magento version.

func GetMagentoVersionFromViper 

func GetMagentoVersionFromViper() *version.Version

GetMagentoVersionFromViper returns a *version.Version object from Viper settings. Note: If it's unset, it will return a dedicated latest version.

func GetMutagenSyncFile 

func GetMutagenSyncFile() string

GetMutagenSyncFile returns the file path of the mutagen sync file.

func GetMutagenSyncIgnore 

func GetMutagenSyncIgnore() string

GetMutagenSyncIgnore returns the additional mutagen ignored files from Viper settings.

func GetOSDistro 

func GetOSDistro() string

GetOSDistro returns the linux distro name if GOOS is linux, else "darwin" or "windows".

func GetServiceDomain 

func GetServiceDomain() string

GetServiceDomain returns the application's service domain.

func GetSyncedContainer 

func GetSyncedContainer() string

GetSyncedContainer returns the name of the container which is used for syncing.

func GetSyncedDir 

func GetSyncedDir() string

GetSyncedDir returns the directory which is synchronized with mutagen.

func GetTraefikDomain 

func GetTraefikDomain() string

GetTraefikDomain returns traefik domain from Viper settings.

func GetTraefikFullDomain 

func GetTraefikFullDomain() string

GetTraefikFullDomain returns traefik full domain (subdomain + domain merged).

func GetTraefikSubdomain 

func GetTraefikSubdomain() string

GetTraefikSubdomain returns traefik subdomain from Viper settings.

func GetValidEnvTypes 

func GetValidEnvTypes() []string

GetValidEnvTypes return a list of valid environment types based on the predefined EnvTypes.

func GetWebRoot 

func GetWebRoot() string

GetWebRoot returns the content of the WEB_ROOT variable from Viper settings.

func InsertStringAfterOccurrence 

func InsertStringAfterOccurrence(args []string, insertStr, searchStr string) []string

InsertStringAfterOccurrence inserts insertStr after the occurrence of searchStr to args and returns args. 

If searchStr is not exists it will append to the end of args.

func InsertStringBeforeOccurrence 

func InsertStringBeforeOccurrence(args []string, insertStr, searchStr string) []string

InsertStringBeforeOccurrence inserts insertStr before occurrence of searchStr (if exist) to args and returns args. 

If searchStr is not exists it will append to the end of args.

func InstallCmd 

func InstallCmd() error

InstallCmd represents the install command.

func InstallMutagen 

func InstallMutagen() error

InstallMutagen installs mutagen.

func InstallMutagenForWindows 

func InstallMutagenForWindows() error

InstallMutagenForWindows installs mutagen for Windows.

func IsAdmin 

func IsAdmin() bool

IsAdmin returns true if the user who runs the command is root.

func IsAllowedSuperuser 

func IsAllowedSuperuser() bool

IsAllowedSuperuser returns true if the application is allowed to be invoked by root.

func IsBlackfireEnabled 

func IsBlackfireEnabled() bool

IsBlackfireEnabled returns true if the blackfire container is enabled.

func IsCommandAvailable 

func IsCommandAvailable(name string) bool

IsCommandAvailable returns if the parameter can be find in $PATH.

func IsContainerChanged 

func IsContainerChanged(container string) bool

IsContainerChanged returns true if the container's state is not "running" or the container's ID is changed since 

the last sync session.

func IsContainerRunning 

func IsContainerRunning(container string) bool

IsContainerRunning returns true if container is running.

func IsDBEnabled 

func IsDBEnabled() bool

IsDBEnabled returns true if the database service is enabled for the current environment.

func IsDebug 

func IsDebug() bool

IsDebug returns true if debug mode is set.

func IsMutagenSyncEnabled 

func IsMutagenSyncEnabled() bool

IsMutagenSyncEnabled returns true for macOS and Windows (if the WSL2 Direct Mount option is disabled).

func IsServiceEnabled 

func IsServiceEnabled(service string) bool

IsServiceEnabled returns true if service is enabled in Viper settings.

func IsSingleWebContainer 

func IsSingleWebContainer() bool

IsSingleWebContainer returns true if Single Web Container setting is enabled in Viper settings.

func IsWSL2DirectMount 

func IsWSL2DirectMount() bool

IsWSL2DirectMount returns true if WSL2 Direct Mount setting is enabled in Viper settings.

func LookupContainerAddressInNetwork 

func LookupContainerAddressInNetwork(containerName, networkName string) (string, error)

LookupContainerAddressInNetwork returns the container IP address in the specific network.

func LookupContainerGatewayInNetwork 

func LookupContainerGatewayInNetwork(containerName, networkName string) (string, error)

LookupContainerGatewayInNetwork returns the container IP address in the specific network.

func NewDockerClient 

func NewDockerClient() (*client.Client, error)

NewDockerClient creates a docker client and return with it.

func Pipeline 

func Pipeline(cmds ...*exec.Cmd) (pipeLineOutput, collectedStandardError []byte, pipeLineError error)

Pipeline runs cmds piped after each other.

func ResolveDomainToTraefik 

func ResolveDomainToTraefik() bool

ResolveDomainToTraefik returns true if an environment's service containers should resolve their "main" domains to the Traefik container's address. If this is enabled, the nginx/php containers will be able to reach themselves through the traefik proxy.

func RunDockerComposeCommand 

func RunDockerComposeCommand(args []string, suppressOsStdOut ...bool) (string, error)

RunDockerComposeCommand runs the passed parameters with docker-compose and returns the output.

func RunDockerComposeWithConfig 

func RunDockerComposeWithConfig(
	args []string, details compose.ConfigDetails, suppressOsStdOut ...bool) (string, error)

RunDockerComposeWithConfig calls docker-compose with the converted configuration settings (from templates).

func RunMeElevated 

func RunMeElevated()

RunMeElevated do nothing on unix systems.

func RunOsCommand 

func RunOsCommand(args string, suppressOsStdOut ...bool) (string, error)

RunOsCommand is going to run a command depending on the caller's operating system.

func SelfUpdateCmd 

func SelfUpdateCmd(cmd *cobra.Command) error

SelfUpdateCmd represents the self-update command.

func SetDefaultShellCommand 

func SetDefaultShellCommand(s string)

SetDefaultShellCommand changes the command invoked by reward shell command.

func SetShellContainer 

func SetShellContainer(s string)

SetShellContainer changes the container used for the reward shell command.

func SetSyncSettingsByEnvType 

func SetSyncSettingsByEnvType()

SetSyncSettingsByEnvType sets the settings for synchronization.

func SetSyncedContainer 

func SetSyncedContainer(s string)

SetSyncedContainer sets the synced container.

func SetSyncedDir 

func SetSyncedDir(s string)

SetSyncedDir sets the directory to be synchronized with mutagen.

func ShellCmd 

func ShellCmd(cmd *cobra.Command, args []string) error

ShellCmd opens a shell in the environment's default application container.

func SignCertificateCmd 

func SignCertificateCmd(args []string, dontAskRecreate ...bool) error

SignCertificateCmd represents the sign-certificate command.

func SvcBuildDockerComposeCommand 

func SvcBuildDockerComposeCommand(args []string, suppressOsStdOut ...bool) (string, error)

SvcBuildDockerComposeCommand builds up the docker-compose command by passing it the previously built templates for the common services..

func SvcBuildDockerComposeTemplate 

func SvcBuildDockerComposeTemplate(t *template.Template, templateList *list.List) error

SvcBuildDockerComposeTemplate builds the templates which are used to invoke docker-compose for the common services.

func SvcCmd 

func SvcCmd(args []string) error

SvcCmd builds up the contents for the svc command.

func SvcEnabledPermissive 

func SvcEnabledPermissive(s string) bool

SvcEnabledPermissive returns true if the s service is enabled in Viper settings. This function is also going to return true if the service is not mentioned in Viper settings (defaults to true).

func SvcEnabledStrict 

func SvcEnabledStrict(name string) bool

SvcEnabledStrict returns true if the s service is enabled in Viper settings. This function is going to return false if the service is not mentioned in Viper settings (defaults to false).

func SvcGenerateTraefikConfig 

func SvcGenerateTraefikConfig() error

SvcGenerateTraefikConfig generates the default traefik configuration.

func SvcGenerateTraefikDynamicConfig 

func SvcGenerateTraefikDynamicConfig() error

SvcGenerateTraefikDynamicConfig generates the dynamic traefik configuration.

func SvcRunDockerCompose 

func SvcRunDockerCompose(args []string, suppressOsStdOut ...bool) error

SvcRunDockerCompose function is a wrapper around the docker-compose command. 

It appends the current directory and current project name to the args.
It also changes the output if the OS StdOut is suppressed.

func SyncCheck 

func SyncCheck() error

SyncCheck checks if mutagen configuration is ok. If it doesn't exists, this function is going to generate one.

func SyncFlushCmd 

func SyncFlushCmd() error

SyncFlushCmd represents the sync flush command.

func SyncListCmd 

func SyncListCmd(suppressOsStdOut ...bool) (string, error)

SyncListCmd represents the sync list command.

func SyncMonitorCmd 

func SyncMonitorCmd() error

SyncMonitorCmd represents the sync monitor command.

func SyncPauseCmd 

func SyncPauseCmd() error

SyncPauseCmd represents the sync pause command.

func SyncResetCmd 

func SyncResetCmd() error

SyncResetCmd represents the sync reset command.

func SyncResumeCmd 

func SyncResumeCmd() error

SyncResumeCmd represents the sync resume command.

func SyncStartCmd 

func SyncStartCmd() error

SyncStartCmd represents the sync start command.

func SyncStopCmd 

func SyncStopCmd() error

SyncStopCmd represents the sync stop command.

Types

This section is empty.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.