awx 0.5.1 → 0.6.0

data/lib/routes/{aws_deploy.rb → deploy_deprecated.rb}

@@ -2,7 +2,7 @@ require 'digest'
 
 module AppCommand
 
-    class AWSDeploy < ::Convoy::ActionCommand::Base
+    class DeployDeprecated < ::Convoy::ActionCommand::Base
 
         VALID_STACK_STATUSES = %w(CREATE_COMPLETE UPDATE_COMPLETE UPDATE_COMPLETE_CLEANUP_IN_PROGRESS)
         MATCHERS_KEY_MAP = {
@@ -23,7 +23,7 @@ module AppCommand
                 @project = nil
                 @profile = App::AWSProfile::get_profile
 
-                Blufin::Projects::init(@profile, App::CONFIG_FILE)
+                Blufin::Projects::init(@profile['Projects'])
 
                 opts_validate
                 opts_routing
@@ -38,6 +38,9 @@ module AppCommand
 
         def opts_validate
 
+            # TODO - Remove this route once new deploy script is working.
+            raise RuntimeError, 'This route is deprecated and broken!'
+
             @projects = Blufin::Projects::get_projects
 
             # Throw Exception if there are no deployments. The script should never get this far.
@@ -100,7 +103,7 @@ module AppCommand
         # # @return void
         def deploy_lambda(project_name, project, profile)
 
-            project_id = project[Blufin::Projects::DEPLOYMENT_ID]
+            project_id = project[Blufin::Projects::PROJECT_ID]
 
             deployment_options = []
             project[Blufin::Projects::TARGETS].each do |environment, data|
@@ -126,14 +129,14 @@ module AppCommand
             targets.each do |target|
                 converted_commands = convert_commands(deploy_commands, target, profile, target[:region], Blufin::Projects::TYPE_LAMBDA)
                 dcmd_final[Digest::SHA2.hexdigest(converted_commands.inspect.to_s)] = {
-                    :description => project[Blufin::Projects::DEPLOYMENT_ID],
+                    :description => project[Blufin::Projects::PROJECT_ID],
                     :commands => converted_commands
                 }
             end
 
             # Build deploy-descriptions array (after targets are selected).
             deploy_descriptions = []
-            targets.each { |x| deploy_descriptions << "#{project[Blufin::Projects::DEPLOYMENT_ID]} \xe2\x80\x94 #{Blufin::Terminal::format_highlight(x[:environment])}" }
+            targets.each { |x| deploy_descriptions << "#{project[Blufin::Projects::PROJECT_ID]} \xe2\x80\x94 #{Blufin::Terminal::format_highlight(x[:environment])}" }
 
             # Show prompt and perform deployment.
             perform_deployment({}, nil, dcmd_final, deploy_descriptions, deploy_script['Path'], project, project_id, project_name, verbose: true, async: false, pbl: false)
@@ -144,11 +147,11 @@ module AppCommand
         # # @return void
         def deploy_ui(project_name, project, profile)
 
-            project_id = project[Blufin::Projects::DEPLOYMENT_ID]
+            project_id = project[Blufin::Projects::PROJECT_ID]
             has_valid_option = false
 
             # Make call to AWS to get available stacks.
-            deployments = AppCommand::AWSDeploy::get_deployments(project, profile, silent: false)
+            deployments = get_deployments(project, profile, silent: false)
 
             # Build deployment option(s).
             deployment_options = []
@@ -337,7 +340,7 @@ module AppCommand
         def self.get_deployments(project, profile, silent: false)
             calls = {}
             deployments = {}
-            project_id = project[Blufin::Projects::DEPLOYMENT_ID]
+            project_id = project[Blufin::Projects::PROJECT_ID]
             project_name = project[Blufin::Projects::PROJECT]
             project[Blufin::Projects::TARGETS].each do |environment, data|
                 region = data[:region]

data/lib/routes/{aws_dynamo_db.rb → dynamo_db.rb}

@@ -1,6 +1,6 @@
 module AppCommand
 
-    class AWSDynamoDB < ::Convoy::ActionCommand::Base
+    class DynamoDB < ::Convoy::ActionCommand::Base
 
         JAR_FILE = 'DynamoDBLocal.jar'
 

data/lib/routes/infrastructure.rb

@@ -0,0 +1,45 @@
+module AppCommand
+
+    class Infrastructure < ::Convoy::ActionCommand::Base
+
+        def execute
+
+            begin
+
+                @opts = command_options
+                @args = arguments
+
+                @profile = App::AWSProfile::get_profile
+
+                Blufin::Projects::init(@profile['Projects'])
+                App::Deployments::init(@profile['Deployments'])
+
+                opts_validate
+                opts_routing
+
+            rescue => e
+
+                Blufin::Terminal::print_exception(e)
+
+            end
+
+        end
+
+        def opts_validate
+
+            @projects = Blufin::Projects::get_projects
+
+            # TODO - REMOVE
+            puts @projects.to_yaml
+
+        end
+
+        def opts_routing
+
+            raise RuntimeError, 'Not yet implemented!'
+
+        end
+
+    end
+
+end

data/lib/routes/{aws_list.rb → list.rb}

@@ -1,6 +1,6 @@
 module AppCommand
 
-    class AWSList < ::Convoy::ActionCommand::Base
+    class List < ::Convoy::ActionCommand::Base
 
         def execute
 
@@ -44,10 +44,25 @@ module AppCommand
             # Throw error if -m is set with any other flas.
             Blufin::Terminal::error("When #{Blufin::Terminal::format_flag('m')} is set, no other flags can be set.", "Found: #{Blufin::Routes::flags_set(@opts).to_i - 1} other flag(s).", true) if @opts[:metadata] && Blufin::Routes::flags_set(@opts).to_i > 1
 
-            # For resources with exports, this enables you to pass the -r flag as both AcmCertificates or AcmCertificateArn (and it will resolve to the same API call).
-            if @export_map.has_key?(@opts[:resource])
-                @export_id       = @opts[:resource]
-                @opts[:resource] = @export_map[@opts[:resource]]
+            if @opts[:json_prompt]
+                # For resources with exports, this enables you to pass the -r flag as both AcmCertificates or AcmCertificateArn (and it will resolve to the same API call).
+                if @export_map.has_key?(@opts[:resource])
+                    if @export_map[@opts[:resource]].is_a?(Array) && @export_map[@opts[:resource]].length > 1
+                        @export_id = Blufin::Terminal::prompt_select('Which resource would you like to export?', @export_map[@opts[:resource]])
+                    else
+                        @export_id = @export_map[@opts[:resource]][0]
+                    end
+                else
+                    @export_id = @opts[:resource]
+                    @export_map.each do |k, v|
+                        v.each do |resource|
+                            if resource == @opts[:resource]
+                                @opts[:resource] = k
+                                break
+                            end
+                        end
+                    end
+                end
             end
 
             # Validate that resource exists (if passed from command-line).

data/lib/routes/ssh.rb

@@ -0,0 +1,70 @@
+require 'json'
+
+module AppCommand
+
+    class SSH < ::Convoy::ActionCommand::Base
+
+        def execute
+
+            begin
+
+                @opts = command_options
+                @args = arguments
+
+                opts_validate
+                opts_routing
+
+            rescue => e
+
+                Blufin::Terminal::print_exception(e)
+
+            end
+
+        end
+
+        def opts_validate
+
+        end
+
+        def opts_routing
+
+            puts
+            result = Blufin::Terminal::execute('awx l -r EC2Instances -j', capture: true, text: 'Getting EC2 instance data...')
+            puts
+
+            begin
+                instances = JSON.parse(result)
+            rescue => e
+                puts
+                puts result
+                Blufin::Terminal::error('Failed to parse AWS response JSON.', e.message)
+            end
+
+            accessible_instances = []
+
+            instances.each do |instance|
+                if instance.has_key?('State') && instance['State']['Name'] == 'running'
+                    accessible_instances << {
+                        :instance_id       => instance['InstanceId'],
+                        :public_ip         => instance['PublicIpAddress'],
+                        :public_dns        => instance['PublicDnsName'],
+                        :key               => instance.has_key?('KeyName') ? instance['KeyName'] : "\xe2\x80\x94",
+                        :tags              => instance['Tags'],
+                        :region            => instance['region'],
+                        :availability_zone => instance['Placement']['AvailabilityZone']
+                    }
+                end
+            end
+
+            # TODO - REMOVE
+            puts
+            puts "\x1B[38;5;198m#{accessible_instances.to_yaml}\x1B[0m"
+
+            # TODO - Need to take Hash and create a Select list to A) select instance and B) select SSH (public) Key.
+            # TODO - A pre-requisite for this is that EC2 available Keys need to be in the Tags somehow.
+
+        end
+
+    end
+
+end

data/lib/routes/{aws_switch.rb → switch.rb}

@@ -1,6 +1,6 @@
 module AppCommand
 
-    class AWSSwitch < ::Convoy::ActionCommand::Base
+    class Switch < ::Convoy::ActionCommand::Base
 
         def execute
 

data/lib/routes/upload.rb

@@ -0,0 +1,49 @@
+module AppCommand
+
+    class Upload < ::Convoy::ActionCommand::Base
+
+        PROJECTS  = 'Projects'
+        TEMPLATES = 'Templates'
+
+        def execute
+
+            begin
+
+                @opts   = command_options
+                @args   = arguments
+                @action = determine_action
+
+                opts_validate
+                opts_routing
+
+            rescue => e
+
+                Blufin::Terminal::print_exception(e)
+
+            end
+
+        end
+
+        def opts_validate
+
+        end
+
+        def opts_routing
+
+            raise RuntimeError, "Not yet implemented! -> #{@action}"
+
+        end
+
+        private
+
+        # PROJECTS, TEMPLATES will be hard-coded from the route file (my.rb) and user has not control over this value.
+        # @return void
+        def determine_action
+            action = @args.shift
+            raise RuntimeError, "Invalid action: #{action}. This is an error with your code not your input." unless [PROJECTS, TEMPLATES].include?(action)
+            action
+        end
+
+    end
+
+end

data/lib/version.rb

@@ -1 +1 @@
-AWX_VERSION = '0.5.1'
+AWX_VERSION = '0.6.0'

data/opt/awx/deployment-schema.yml

@@ -0,0 +1,57 @@
+type: map
+mapping:
+  Scripts:
+    type: seq
+    required: yes
+    sequence:
+      - type: map
+        mapping:
+          Id:
+            required: yes
+          Commands:
+            type: seq
+            required: yes
+            sequence:
+              - type: str
+  Projects:
+    type: seq
+    required: yes
+    sequence:
+      - type: map
+        mapping:
+          Id:
+            required: yes
+          S3Bucket:
+            type: map
+            required: yes
+            mapping:
+              Name:
+                required: yes
+              Region:
+                required: yes
+                pattern: /^[a-z]{2}-[a-z]{2,20}-\d$/
+          Deployments:
+            type: seq
+            required: yes
+            sequence:
+              - type: map
+                mapping:
+                  Environment:
+                    required: yes
+                  Region:
+                    type: seq
+                    required: yes
+                    sequence:
+                      - type: str
+                  Script:
+                    required: yes
+                  Stack:
+                    required: yes
+                  StackParameters:
+                    type: seq
+                    required: yes
+                    sequence:
+                      - type: seq
+                        required: yes
+                        sequence:
+                          - type: str

data/opt/awx/reports.yml

@@ -1,4 +1,4 @@
-# Try to order these with most frequently accessed at the top.
+# TODO - Strategy when re-factoring this to look neat, have a few pre-defined column layouts (loose, detailed, etc.) and copy/paste them with the same width values.
 AcmCertificates:
   regions: [ us-east-1, us-east-2, us-west-1, us-west-2 ]
   regionsPreferred: [ us-east-1 ]
@@ -10,8 +10,8 @@ AcmCertificates:
       value: CertificateArn
       description: DomainName
   columns:
-    - [ title: CertificateARN, key: CertificateArn, width: 90 ]
-    - [ title: DomainName, key: DomainName, width: "*" ]
+    - { title: CertificateARN, key: CertificateArn, width: 90 }
+    - { title: DomainName, key: DomainName, width: "*" }
 APIs:
   regions: [ us-east-1, us-east-2, us-west-1, us-west-2 ]
   regionsPreferred: [ us-west-2 ]
@@ -23,9 +23,9 @@ APIs:
       value: id
       description: name
   columns:
-    - [ title: Name, key: name, width: 90 ]
-    - [ title: Id, key: id, width: 29 ]
-    - [ title: Type(s), key: endpointConfiguration.types, width: "*" ]
+    - { title: Name, key: name, width: 90 }
+    - { title: Id, key: id, width: 29 }
+    - { title: Type(s), key: endpointConfiguration.types, width: "*" }
 CloudFormationStacks:
   regions: [ us-east-1, us-east-2, us-west-1, us-west-2 ]
   regionsPreferred: [ us-west-2 ]
@@ -33,9 +33,9 @@ CloudFormationStacks:
     command: cloudformation list-stacks --stack-status-filter CREATE_IN_PROGRESS CREATE_FAILED CREATE_COMPLETE ROLLBACK_IN_PROGRESS ROLLBACK_FAILED ROLLBACK_COMPLETE DELETE_IN_PROGRESS DELETE_FAILED UPDATE_IN_PROGRESS UPDATE_COMPLETE_CLEANUP_IN_PROGRESS UPDATE_COMPLETE UPDATE_ROLLBACK_IN_PROGRESS UPDATE_ROLLBACK_FAILED UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS UPDATE_ROLLBACK_COMPLETE REVIEW_IN_PROGRESS
     root: StackSummaries
   columns:
-    - [ title: StackId, key: StackId, width: 169, formatter: cloudformation-stack ]
-    - [ title: DriftStatus, key: DriftInformation.StackDriftStatus, width: 15 ]
-    - [ title: Status, key: StackStatus, width: "*" ]
+    - { title: StackId, key: StackId, width: 169, formatter: cloudformation-stack }
+    - { title: DriftStatus, key: DriftInformation.StackDriftStatus, width: 15 }
+    - { title: Status, key: StackStatus, width: "*" }
 CloudFrontDistributions:
   regions: [ Global ]
   regionsPreferred: [ Global ]
@@ -43,11 +43,11 @@ CloudFrontDistributions:
     command: cloudfront list-distributions
     root: DistributionList.Items
   columns:
-    - [ title: Origin, key: DefaultCacheBehavior.TargetOriginId, width: 90 ]
-    - [ title: Id, key: Id, width: 29 ]
-    - [ title: Public DNS, key: DomainName, width: 40 ]
-    - [ title: ProtocolPolicy, key: DefaultCacheBehavior.ViewerProtocolPolicy, width: 30 ]
-    - [ title: Status, key: Status, width: "*", formatter: cloudfront-status ]
+    - { title: Origin, key: DefaultCacheBehavior.TargetOriginId, width: 90 }
+    - { title: Id, key: Id, width: 29 }
+    - { title: Public DNS, key: DomainName, width: 40 }
+    - { title: ProtocolPolicy, key: DefaultCacheBehavior.ViewerProtocolPolicy, width: 30 }
+    - { title: Status, key: Status, width: "*", formatter: cloudfront-status }
 CognitoUserPools:
   regions: [ us-east-1, us-east-2, us-west-2 ]
   regionsPreferred: [ us-west-2 ]
@@ -55,10 +55,10 @@ CognitoUserPools:
     command: cognito-idp list-user-pools --max-results 60
     root: UserPools
   columns:
-    - [ title: Id, key: Id, width: 90 ]
-    - [ title: Name, key: Name, width: 46 ]
-    - [ title: CreationDate, key: CreationDate, width: 31, formatter: epoch-date ]
-    - [ title: LastModifiedDate, key: LastModifiedDate, width: "*", formatter: epoch-date ]
+    - { title: Id, key: Id, width: 90 }
+    - { title: Name, key: Name, width: 46 }
+    - { title: CreationDate, key: CreationDate, width: 31, formatter: epoch-date }
+    - { title: LastModifiedDate, key: LastModifiedDate, width: "*", formatter: epoch-date }
 EC2Instances:
   regions: [ us-east-1, us-east-2, us-west-1, us-west-2 ]
   regionsPreferred: [ us-west-2 ]
@@ -66,16 +66,33 @@ EC2Instances:
     command: ec2 describe-instances
     root: Reservations[].Instances
   columns:
-    - [ title: InstanceID, key: InstanceId, width: 30 ]
-    - [ title: PrivateIP, key: PrivateIpAddress, width: 29, color: light-grey ]
-    - [ title: PublicIP, key: PublicIpAddress, width: 29, color: light-grey ]
-    - [ title: ImageId, key: ImageId, width: 30 ]
-    - [ title: Av/Zone, key: Placement.AvailabilityZone, width: 15 ]
-    - [ title: SecurityGroup, key: SecurityGroups, width: 15, formatter: ec2-security-groups ]
-    - [ title: VpcId, key: VpcId, width: 15 ]
-    - [ title: KeyName, key: KeyName, width: 15 ]
-    - [ title: Type, key: InstanceType, width: 15 ]
-    - [ title: Status, key: State.Name, width: "*", formatter: ec2-status ]
+    - { title: InstanceID, key: InstanceId, width: 30 }
+    - { title: PrivateIP, key: PrivateIpAddress, width: 29, color: light-grey }
+    - { title: PublicIP, key: PublicIpAddress, width: 29, color: light-grey }
+    - { title: ImageId, key: ImageId, width: 30 }
+    - { title: Av/Zone, key: Placement.AvailabilityZone, width: 15 }
+    - { title: SecurityGroup, key: SecurityGroups, width: 15, formatter: ec2-security-groups }
+    - { title: VpcId, key: VpcId, width: 15 }
+    - { title: KeyName, key: KeyName, width: 15 }
+    - { title: Type, key: InstanceType, width: 15 }
+    - { title: Status, key: State.Name, width: "*", formatter: ec2-status }
+EfsVolumes:
+  regions: [ us-east-1, us-east-2, us-west-1, us-west-2 ]
+  regionsPreferred: [ us-west-2 ]
+  cli:
+    command: efs describe-file-systems
+    root: FileSystems
+  export:
+    - id: EfsVolume
+      value: FileSystemId
+      description: Name
+  columns:
+    - { title: Name, key: Name, width: 90 }
+    - { title: FileSystemId, key: FileSystemId, width: 15 }
+    - { title: SizeInBytes, key: SizeInBytes.Value, width: 15 }
+    - { title: NumberOfMountTargets, key: NumberOfMountTargets, width: 20 }
+    - { title: CreationTime, key: CreationTime, width: 30, formatter: epoch-date }
+    - { title: PerformanceMode, key: PerformanceMode, width: "*" }
 Lambdas:
   regions: [ us-east-1, us-east-2, us-west-1, us-west-2 ]
   regionsPreferred: [ us-west-2 ]
@@ -83,10 +100,10 @@ Lambdas:
     command: lambda list-functions
     root: Functions
   columns:
-    - [ title: FunctionArn, key: FunctionArn, width: 90 ]
-    - [ title: FunctionName, key: FunctionName, width: 46 ]
-    - [ title: Handler, key: Handler, width: 31 ]
-    - [ title: LastModified, key: LastModified, width: "*" ]
+    - { title: FunctionArn, key: FunctionArn, width: 90 }
+    - { title: FunctionName, key: FunctionName, width: 46 }
+    - { title: Handler, key: Handler, width: 31 }
+    - { title: LastModified, key: LastModified, width: "*" }
 Route53HostedZones:
   regions: [ Global ]
   regionsPreferred: [ Global ]
@@ -102,8 +119,59 @@ Route53HostedZones:
       value: Name
       valueFormatter: route-53-domain-name
   columns:
-    - [ title: HostedZoneId, key: Id, width: 90, formatter: route-53-hosted-zone-id ]
-    - [ title: DomainName, key: Name, width: "*", formatter: route-53-domain-name ]
+    - { title: HostedZoneId, key: Id, width: 90, formatter: route-53-hosted-zone-id }
+    - { title: DomainName, key: Name, width: "*", formatter: route-53-domain-name }
+SecurityGroups:
+  regions: [ us-west-2 ]
+  regionsPreferred: [ us-west-2 ]
+  cli:
+    command: ec2 describe-security-groups
+    root: SecurityGroups
+  export:
+    - id: SecurityGroup
+      value: GroupId
+      description: Description
+  columns:
+    - { title: Description, key: Description, width: 90 }
+    - { title: GroupId, key: GroupId, width: 30 }
+    - { title: VpcId, key: VpcId, width: 30 }
+    - { title: GroupName, key: GroupName, width: "*" }
+Subnets:
+  regions: [ us-west-2 ]
+  regionsPreferred: [ us-west-2 ]
+  cli:
+    command: ec2 describe-subnets
+    root: Subnets
+  export:
+    - id: Subnet
+      value: SubnetId
+      description: Tags.Name
+  columns:
+    - { title: Name, key: Tags.Name, width: 30 }
+    - { title: SubnetId, key: SubnetId, width: 30 }
+    - { title: VpcId, key: VpcId, width: 22 }
+    - { title: AvailabilityZoneId, key: AvailabilityZoneId, width: 22 }
+    - { title: AvailabilityZone, key: AvailabilityZone, width: 22 }
+    - { title: CidrBlock, key: CidrBlock, width: 30 }
+    - { title: MapPublicIpOnLaunch, key: MapPublicIpOnLaunch, width: 19 }
+    - { title: DefaultForAz, key: DefaultForAz, width: 15 }
+    - { title: State, key: State, width: "*" }
+Vpcs:
+  regions: [ us-west-2 ]
+  regionsPreferred: [ us-west-2 ]
+  cli:
+    command: ec2 describe-vpcs
+    root: Vpcs
+  export:
+    - id: Vpc
+      value: VpcId
+      description: Tags.Name
+  columns:
+    - { title: VpcId, key: VpcId, width: 90 }
+    - { title: CidrBlock, key: CidrBlock, width: 29 }
+    - { title: InstanceTenancy, key: InstanceTenancy, width: 29 }
+    - { title: State, key: State, width: 29 }
+    - { title: IsDefault, key: IsDefault, width: "*" }
 WorkMailOrganizations:
   regions: [ us-east-1, us-west-2 ]
   regionsPreferred: [ us-east-1 ]
@@ -111,6 +179,6 @@ WorkMailOrganizations:
     command: workmail list-organizations
     root: OrganizationSummaries
   columns:
-    - [ title: OrganizationId, key: OrganizationId, width: 90 ]
-    - [ title: Alias, key: Alias, width: 29 ]
-    - [ title: State, key: State, width: "*" ]
+    - { title: OrganizationId, key: OrganizationId, width: 90 }
+    - { title: Alias, key: Alias, width: 29 }
+    - { title: State, key: State, width: "*" }

data/opt/config/schema.yml

@@ -9,6 +9,8 @@ mapping:
         required: true
   DefaultProfile:
     required: yes
+  DeveloperName:
+    required: yes
   DynamoDBPath:
   Profiles:
     type: seq
@@ -33,6 +35,7 @@ mapping:
                         required: yes
                   S3Bucket:
                     type: map
+                    required: yes
                     mapping:
                       Name:
                         required: yes
@@ -89,6 +92,25 @@ mapping:
                     required: yes
               S3Bucket:
                 type: map
+                required: yes
+                mapping:
+                  Name:
+                    required: yes
+                  File:
+                    required: yes
+                  Region:
+                    required: yes
+          Deployments:
+            type: map
+            mapping:
+              Local:
+                type: map
+                mapping:
+                  File:
+                    required: yes
+              S3Bucket:
+                type: map
+                required: yes
                 mapping:
                   Name:
                     required: yes

data/opt/config/template.yml

@@ -1,4 +1,5 @@
 DefaultProfile: default
+DeveloperName: <<-john-doe->>
 DynamoDBPath: <<-path/to/folder->>
 Profiles:
   - Profile: default
@@ -16,7 +17,7 @@ Profiles:
           Path: <<-S3-bucket-path->>
           Region: <<-S3-bucket-region->>
       Defaults:
-        StackName: "{{CATEGORY}}-{{TEMPLATE}}-{{PROJECT}}-{{ENVIRONMENT}}-{{REGION}}-{{UUID}}"
+        StackName: "${{Parameters:Category}}-${{Parameters:Template}}-${{Parameters:Project}}-${{Parameters:Environment}}-${{Parameters:Region}}-${{System:UUID-AWX}}"
         Timeout: 60
         Regions:
           - us-west-2
@@ -26,6 +27,13 @@ Profiles:
         Path: <<-S3-bucket-path->>
         Region: <<-S3-bucket-region->>
     Projects:
+      Local:
+        File: <<-path/to/file->>
+      S3Bucket:
+        Name: <<-S3-bucket-name->>
+        File: <<-S3-bucket-path/to/file->>
+        Region: <<-S3-bucket-region->>
+    Deployments:
       Local:
         File: <<-path/to/file->>
       S3Bucket: