Merge pull request #144 from carapace-sh/fix-deploy

fix deploy

Author: rsteube

cmd/carapace-aws/cmd/botocore/aws.deploy.yaml

@@ -103,11 +103,13 @@ commands:
         --description=: A comment about the deployment.
         --file-exists-behavior=: Information about how CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.
         --generate-cli-skeleton: Prints a JSON skeleton to standard output without sending an API request.
+        --github-location=: Information about the location of the application revision in GitHub
         --ignore-application-stop-failures: If true, then if an `ApplicationStop`, `BeforeBlockTraffic`, or `AfterBlockTraffic` deployment lifecycle event to an instance fails, then the deployment continues to the next deployment lifecycle event.
         --no-ignore-application-stop-failures: If true, then if an `ApplicationStop`, `BeforeBlockTraffic`, or `AfterBlockTraffic` deployment lifecycle event to an instance fails, then the deployment continues to the next deployment lifecycle event.
         --no-update-outdated-instances-only: Indicates whether to deploy to all instances or only to instances that are not running the latest application revision.
         --override-alarm-configuration=: Allows you to specify information about alarms associated with a deployment.
         --revision=: The type and location of the revision to deploy.
+        --s3-location=: Information about the location of the application revision in Amazon S3
         --target-instances=: Information about the instances that belong to the replacement environment in a blue/green deployment.
         --update-outdated-instances-only: Indicates whether to deploy to all instances or only to instances that are not running the latest application revision.
       completion:
@@ -200,6 +202,11 @@ commands:
         --cli-input-yaml=: Read arguments from the YAML string provided.
         --external-id=: The unique ID of an external resource (for example, a CloudFormation stack ID) that is linked to one or more CodeDeploy resources.
         --generate-cli-skeleton: Prints a JSON skeleton to standard output without sending an API request.
+    - name: deregister
+      description: Removes any tags from the on-premises instance
+      flags:
+        --instance-name=!: The name of the on-premises instance
+        --no-delete-iam-user: Do not delete the IAM user for the registered on-premises instance
     - name: deregister-on-premises-instance
       description: Deregisters an on-premises instance.
       flags:
@@ -221,7 +228,9 @@ commands:
         --cli-input-json=: Read arguments from the JSON string provided.
         --cli-input-yaml=: Read arguments from the YAML string provided.
         --generate-cli-skeleton: Prints a JSON skeleton to standard output without sending an API request.
+        --github-location=: Information about the location of the application revision in GitHub
         --revision=!: Information about the application revision to get, including type and location.
+        --s3-location=: Information about the location of the application revision in Amazon S3
     - name: get-deployment
       description: Gets information about a deployment.
       flags:
@@ -267,6 +276,18 @@ commands:
         --cli-input-yaml=: Read arguments from the YAML string provided.
         --generate-cli-skeleton: Prints a JSON skeleton to standard output without sending an API request.
         --instance-name=!: The name of the on-premises instance about which to get information.
+    - name: install
+      description: Configures and installs the AWS CodeDeploy Agent on the on-premises instance
+      flags:
+        --agent-installer=: The AWS CodeDeploy Agent installer file
+        --config-file=!: The path to the on-premises instance configuration file
+        --override-config: Overrides the on-premises instance configuration file
+      completion:
+        flag:
+            agent-installer:
+                - $files
+            config-file:
+                - $files
     - name: list-application-revisions
       description: Lists information about revisions for an application.
       flags:
@@ -393,6 +414,15 @@ commands:
         --generate-cli-skeleton: Prints a JSON skeleton to standard output without sending an API request.
         --next-token=: An identifier returned from the previous `ListTagsForResource` call.
         --resource-arn=!: The ARN of a CodeDeploy resource.
+    - name: push
+      description: Bundles and uploads to Amazon Simple Storage Service (Amazon S3) an application revision
+      flags:
+        --application-name=!: The name of the AWS CodeDeploy application to be associated with the application revision
+        --description=: A comment that summarizes the application revision
+        --ignore-hidden-files: Set the –ignore-hidden-files flag to not bundle and upload hidden files to Amazon S3
+        --no-ignore-hidden-files: Set the –ignore-hidden-files flag to not bundle and upload hidden files to Amazon S3
+        --s3-location=!: Information about the location of the application revision to be uploaded to Amazon S3
+        --source=: The location of the deployable content and the accompanying AppSpec file
     - name: put-lifecycle-event-hook-execution-status
       description: Sets the result of a Lambda validation function.
       flags:
@@ -411,6 +441,14 @@ commands:
                 - Failed
                 - Skipped
                 - Unknown
+    - name: register
+      description: Creates an IAM user for the on-premises instance
+      flags:
+        --iam-user-arn=: The IAM user associated with the on-premises instance
+        --instance-name=!: The name of the on-premises instance
+        --tags=:
+            description: The list of key/value pairs to tag the on-premises instance
+            nargs: -1
     - name: register-application-revision
       description: Registers with CodeDeploy a revision for the specified application.
       flags:
@@ -419,7 +457,9 @@ commands:
         --cli-input-yaml=: Read arguments from the YAML string provided.
         --description=: A comment about the revision.
         --generate-cli-skeleton: Prints a JSON skeleton to standard output without sending an API request.
+        --github-location=: Information about the location of the application revision in GitHub
         --revision=!: Information about the application revision to register, including type and location.
+        --s3-location=: Information about the location of the application revision in Amazon S3
     - name: register-on-premises-instance
       description: Registers an on-premises instance.
       flags:
@@ -461,6 +501,8 @@ commands:
         --generate-cli-skeleton: Prints a JSON skeleton to standard output without sending an API request.
         --resource-arn=!: The ARN of a resource, such as a CodeDeploy application or deployment group.
         --tags=!: A list of tags that `TagResource` associates with a resource.
+    - name: uninstall
+      description: Uninstalls the AWS CodeDeploy Agent from the on-premises instance.
     - name: untag-resource
       description: Disassociates a resource from a list of tags.
       flags:

cmd/carapace-spec-botocore/cmd/customizations/codedeploy.go

@@ -1,10 +1,64 @@
 package customizations
 
-import "github.com/carapace-sh/carapace-spec/pkg/command"
+import (
+	_ "embed"
+
+	"github.com/carapace-sh/carapace-spec/pkg/command"
+	"gopkg.in/yaml.v3"
+)
+
+//go:embed deploy/aws.deploy.deregister.yaml
+var deploy_deregister []byte
+
+//go:embed deploy/aws.deploy.install.yaml
+var deploy_install []byte
+
+//go:embed deploy/aws.deploy.push.yaml
+var deploy_push []byte
+
+//go:embed deploy/aws.deploy.register.yaml
+var deploy_register []byte
+
+//go:embed deploy/aws.deploy.uninstall.yaml
+var deploy_uninstall []byte
 
 func init() {
 	customizations["codedeploy"] = func(cmd *command.Command) error {
 		cmd.Name = "deploy"
+
+		for _, spec := range [][]byte{
+			deploy_deregister,
+			deploy_install,
+			deploy_push,
+			deploy_register,
+			deploy_uninstall,
+		} {
+			var specCommand command.Command
+			if err := yaml.Unmarshal(spec, &specCommand); err != nil {
+				return err
+			}
+			cmd.Commands = append(cmd.Commands, specCommand)
+		}
 		return nil
 	}
+
+	for _, operation := range []string{
+		"codedeploy.create-deployment",
+		"codedeploy.get-application-revision",
+		"codedeploy.register-application-revision",
+	} {
+		customizations[operation] = func(cmd *command.Command) error {
+			cmd.AddFlag(command.Flag{
+				Longhand:    "s3-location",
+				Description: "Information about the location of the application revision in Amazon S3",
+				Value:       true,
+			})
+			cmd.AddFlag(command.Flag{
+				Longhand:    "github-location",
+				Description: "Information about the location of the application revision in GitHub",
+				Value:       true,
+			})
+			return nil
+		}
+	}
 }

cmd/carapace-spec-botocore/cmd/customizations/deploy/aws.deploy.deregister.yaml

@@ -0,0 +1,11 @@
+# yaml-language-server: $schema=https://carapace.sh/schemas/command.json
+name: deregister
+description: Removes any tags from the on-premises instance
+flags:
+  --instance-name=!: The name of the on-premises instance
+  --no-delete-iam-user: Do not delete the IAM user for the registered on-premises instance
+documentation:
+  command: |
+    Removes any tags from the on-premises instance;
+    deregisters the on-premises instance from AWS CodeDeploy;
+    and, unless requested otherwise, deletes the IAM user for the on-premises instance.

cmd/carapace-spec-botocore/cmd/customizations/deploy/aws.deploy.install.yaml

@@ -0,0 +1,11 @@
+# yaml-language-server: $schema=https://carapace.sh/schemas/command.json
+name: install
+description: Configures and installs the AWS CodeDeploy Agent on the on-premises instance
+flags:
+  --config-file=!: The path to the on-premises instance configuration file
+  --override-config: Overrides the on-premises instance configuration file
+  --agent-installer=: The AWS CodeDeploy Agent installer file
+completion:
+  flag:
+    config-file: ["$files"]
+    agent-installer: ["$files"]

cmd/carapace-spec-botocore/cmd/customizations/deploy/aws.deploy.push.yaml

@@ -0,0 +1,34 @@
+# yaml-language-server: $schema=https://carapace.sh/schemas/command.json
+name: push
+description: Bundles and uploads to Amazon Simple Storage Service (Amazon S3) an application revision
+flags:
+  --application-name=!: The name of the AWS CodeDeploy application to be associated with the application revision
+  --s3-location=!: Information about the location of the application revision to be uploaded to Amazon S3
+  --ignore-hidden-files: Set the –ignore-hidden-files flag to not bundle and upload hidden files to Amazon S3
+  --no-ignore-hidden-files: Set the –ignore-hidden-files flag to not bundle and upload hidden files to Amazon S3
+  --source=: The location of the deployable content and the accompanying AppSpec file
+  --description=: A comment that summarizes the application revision
+documentation:
+  command: |
+    Bundles and uploads to Amazon Simple Storage Service (Amazon S3) an application revision,
+    which is a zip archive file that contains deployable content
+    and an accompanying Application Specification file (AppSpec file).
+    If the upload is successful, a message is returned that describes how to call the create-deployment command
+    to deploy the application revision from Amazon S3 to target Amazon Elastic Compute Cloud (Amazon EC2) instances.
+  flag:
+    application-name: |
+      Required. The name of the AWS CodeDeploy application to be associated with the application revision.
+    s3-location: |
+      Required. Information about the location of the application revision to be uploaded to Amazon S3.
+      You must specify both a bucket and a key that represent the Amazon S3 bucket name and the object key name.
+      Content will be zipped before uploading. Use the format `s3:///`
+    ignore-hidden-files: |
+      Optional. Set the –ignore-hidden-files flag to not bundle and upload hidden files to Amazon S3;
+      otherwise, set the –no-ignore-hidden-files flag (the default) to bundle and upload hidden files to Amazon S3.
+    source: |
+      Optional. The location of the deployable content and the accompanying AppSpec file on the development machine
+      to be zipped and uploaded to Amazon S3. If not specified, the current directory is used.
+    description: |
+      Optional. A comment that summarizes the application revision.
+      If not specified, the default string “Uploaded by AWS CLI ‘time’ UTC” is used,
+      where ‘time’ is the current system time in Coordinated Universal Time (UTC).

cmd/carapace-spec-botocore/cmd/customizations/deploy/aws.deploy.register.yaml

@@ -0,0 +1,13 @@
+# yaml-language-server: $schema=https://carapace.sh/schemas/command.json
+name: register
+description: Creates an IAM user for the on-premises instance
+flags:
+  --instance-name=!: The name of the on-premises instance
+  --tags=: {description: "The list of key/value pairs to tag the on-premises instance", nargs: -1}
+  --iam-user-arn=: The IAM user associated with the on-premises instance
+documentation:
+  command: |
+    Creates an IAM user for the on-premises instance, if not provided,
+    and saves the user’s credentials to an on-premises instance configuration file;
+    registers the on-premises instance with AWS CodeDeploy; and optionally adds tags to the on-premises instance.
+

cmd/carapace-spec-botocore/cmd/customizations/deploy/aws.deploy.uninstall.yaml

@@ -0,0 +1,3 @@
+# yaml-language-server: $schema=https://carapace.sh/schemas/command.json
+name: uninstall
+description: Uninstalls the AWS CodeDeploy Agent from the on-premises instance.