cloudfoundry/cloud_controller_ng

View on GitHub
app/jobs/runtime/buildpack_installer_factory.rb

Summary

Maintainability
A
25 mins
Test Coverage
module VCAP::CloudController
  module Jobs
    module Runtime
      class BuildpackInstallerFactory
        ##
        # Raised when attempting to install two buildpacks with the same name and stack
        class DuplicateInstallError < StandardError
        end

        ##
        # Raised when attempting to install a buildpack without a stack,
        # but there is already an existing buildpack with a matching name
        # and has a non-nil stack.
        #
        # As an operator, you cannot regress to an older style buildpack
        # that has a nil stack.
        class StacklessBuildpackIncompatibilityError < StandardError
        end

        ##
        # Raised when attempting to install a buildpack,
        # but there are already existing buildpacks with matching names
        # and one has a nil `stack` and another has a non-nil `stack`.
        #
        # As an operator, you can resolve this by deleting the existing buildpack
        # that has a `stack` of nil.
        class StacklessAndStackfulMatchingBuildpacksExistError < StandardError
        end

        class LockedStacklessBuildpackUpgradeError < StandardError
        end

        def plan(buildpack_name, manifest_fields)
          ensure_no_duplicate_buildpack_stacks!(manifest_fields)

          ensure_no_mix_of_stackless_and_stackful_buildpacks!(manifest_fields)

          planned_jobs = []

          found_buildpacks = Buildpack.where(name: buildpack_name).all

          ensure_no_attempt_to_upgrade_a_stackless_locked_buildpack(buildpack_name, found_buildpacks, manifest_fields)

          manifest_fields.each do |buildpack_fields|
            guid_of_buildpack_to_update = find_buildpack_to_update(found_buildpacks, buildpack_fields[:stack], planned_jobs)

            planned_jobs << if guid_of_buildpack_to_update
                              VCAP::CloudController::Jobs::Runtime::UpdateBuildpackInstaller.new({
                                                                                                   name: buildpack_name,
                                                                                                   stack: buildpack_fields[:stack],
                                                                                                   file: buildpack_fields[:file],
                                                                                                   options: buildpack_fields[:options],
                                                                                                   upgrade_buildpack_guid: guid_of_buildpack_to_update
                                                                                                 })
                            else
                              VCAP::CloudController::Jobs::Runtime::CreateBuildpackInstaller.new({
                                                                                                   name: buildpack_name,
                                                                                                   stack: buildpack_fields[:stack],
                                                                                                   file: buildpack_fields[:file],
                                                                                                   options: buildpack_fields[:options]
                                                                                                 })
                            end
          end

          planned_jobs
        end

        def find_buildpack_with_matching_stack(buildpacks, stack)
          buildpacks.find { |candidate| candidate.stack == stack }
        end

        def find_buildpack_with_nil_stack(buildpacks)
          buildpacks.find { |candidate| candidate.stack.nil? }
        end

        def buildpack_not_yet_updated_from_nil_stack(planned_jobs, buildpack_guid)
          planned_jobs.none? { |job| job.guid_to_upgrade == buildpack_guid }
        end

        def ensure_no_buildpack_downgraded_to_nil_stack!(buildpacks)
          return unless buildpacks.size > 1 && buildpacks.any? { |b| b.stack.nil? }

          msg = "Attempt to install '#{buildpacks.first.name}' failed. Ensure that all buildpacks have a stack associated with them before upgrading."
          raise StacklessAndStackfulMatchingBuildpacksExistError.new(msg)
        end

        def ensure_no_mix_of_stackless_and_stackful_buildpacks!(manifest_fields)
          return unless manifest_fields.size > 1 && manifest_fields.any? { |buildpack_fields| buildpack_fields[:stack].nil? }

          raise StacklessBuildpackIncompatibilityError
        end

        def ensure_no_duplicate_buildpack_stacks!(manifest_fields)
          return unless manifest_fields.uniq { |buildpack_fields| buildpack_fields[:stack] }.length < manifest_fields.length

          raise DuplicateInstallError
        end

        def find_buildpack_to_update(found_buildpacks, detected_stack, planned_jobs)
          return if found_buildpacks.empty?

          ensure_no_buildpack_downgraded_to_nil_stack!(found_buildpacks)

          buildpack_to_update = find_buildpack_with_matching_stack(found_buildpacks, detected_stack)
          return buildpack_to_update.guid unless buildpack_to_update.nil?

          # prevent creation of a new buildpack with the same name, but a nil stack
          raise StacklessBuildpackIncompatibilityError if detected_stack.nil?

          buildpack_to_update = find_buildpack_with_nil_stack(found_buildpacks)
          return buildpack_to_update.guid if buildpack_to_update && buildpack_not_yet_updated_from_nil_stack(planned_jobs, buildpack_to_update.guid)

          nil
        end

        private

        # prevent creation of multiple buildpacks with the same name
        # if the old buildpack is locked and stackless
        #
        def ensure_no_attempt_to_upgrade_a_stackless_locked_buildpack(buildpack_name, found_buildpacks, manifest_fields)
          nil_locked_buildpack = found_buildpacks.find { |bp| bp.locked && bp.stack.nil? }
          return unless manifest_fields.size > 1 && nil_locked_buildpack

          msg = "Attempt to install '#{buildpack_name}' for multiple stacks failed. Buildpack '#{buildpack_name}' cannot be locked during upgrade."
          raise LockedStacklessBuildpackUpgradeError.new(msg)
        end
      end
    end
  end
end