migration_details.md

vagrant-openshift Feature Migration Details

vagrant-openshift Features By Command

build-atomic-host

• AtomicHostUpgrade:
  • atomic host upgrade: TODO

build-origin

• BuildOrigin:
  • make release{,-binaries}: TODO
  • install etcd: TODO

build-origin-base

• CreateYumRepositories:
  • yum install deltarpm augeas: install_dependencies.yml
  • update openshift-deps.repo with the pub mirror link: TODO, should be in Origin install step
  • install EPEL if not Fedora: register_repositories.yml
  • BZ 707364 workaround: this was for RHEL 6, we can drop it
• YumUpdate:
  • remove previous Origin repository: TODO, should be in Origin install step
  • yum clean all: install_dependencies.yml
  • yum update --exclude=kernel*: install_dependencies.yml
  • add configuation to yum: configure_yum.yml
  • update metadata_expire to never: won't implement unless convinced
• SetHostName:
  • update /etc/sysconfig/network and /etc/hostname: @sdodson says this is not needed
• InstallOriginBaseDependencies:
  • vagrant and Fedora/systemd eth* naming workaround: even RHEL is on sytemd219, this fix was for systemd197, we can drop it
  • yum install: install_dependencies.yml
  • install of facter but not on Fedora: install_dependencies.yml
  • install Chrome and Chromedriver: install_dependencies.yml
  • install openshift-rhel7-dependencies.repo: register_repositories.yml
  • install Go: golang/tasks/main.yml
  • install Docker: docker/tasks/main.yml
  • install rhaos3{1,2}.repo: register_repositories.yml
  • configure system: post_install.yml
  • configure Docker daemon: configure_docker_daemon.yml, configure_docker_daemon_storage.yml, configure_openshift_storage.yml

build-origin-base-images

• BuildOriginBaseImages:
  • shell out to a make task to build base images: TODO

build-origin-images

• BuildOriginImages:
  • shell out to docker build: ????

build-origin-rpm-test

• BuildOriginRPMTest:
  • shell out to tito: TODO

build-sti

• BuildSTI:
  • shell out to a make task or tasks to build STI binary: TODO

checkout-repositories

• CheckoutRepositories:
  • given a repo name, remote location and branch, clone it and check it out: TODO

clone-upstream-repositories

• CloneUpstreamRepositories:
  • turn off StrictHostKeyChecking so we don't get interactive prompts from GitHub: TODO
  • for each repo, git clone --bare: TODO
  • make sure the user calling this owns the repo: TODO

create-ami

• CleanNetworkSetup:
  • overwrite /etc/udev/rules.d/70-persistent-net.rules: ???? (maybe, see if ansible AMI stuff can do it for us)
  • remove the mlocate database: ????
• ConfigValidate:
  • vagrant builtin: ????
• VagrantPlugins::AWS::Action::ConnectAWS:
  • vagrant builtin: ????
• CreateAMI:
  • use AWS EC2 API to create an AMI: TODO

create-local-yum-repo

• CreateLocalYumRepo:
  • install createrepo: TODO
  • create local repo pointing to RPMs: TODO

download-artifacts-origin

• DownloadArtifactsOrigin:
  • get logs from Docker and stuff using journalctl
  • build list of sources & targets, then rsync: TODO

download-artifacts-origin-aggregated-logging

• DownloadArtifactsOriginAggregatedLogging:
  • see above

download-artifacts-origin-console

• DownloadArtifactsOriginConsole:
  • see above

download-artifacts-origin-metrics

• DownloadArtifactsOriginMetrics:
  • see above

download-artifacts-sti

• DownloadArtifactsOriginSTI:
  • see above

install-origin

• YumUpdate:
  • see above
• SetHostName:
  • see above
• InstallOrigin:
  • set up the OpenShift systemd service and start it, etc: TODO (use openshift-ansible)
• InstallOriginRHEL7:
  • build a rhel7.2 Docker image to base everything else off of: TODO
• InstallOriginAssetDependencies:
  • install & update npm: install_dependencies.yml
  • shell out to a make task to install and configure the console: TODO

install-origin-assets-base

• InstallOriginAssetDependencies:
  • see above

local-origin-checkout

• LocalOriginCheckout:
  • looking for repositories in $GOPATH: TODO (???? - many repos don't use Go)
  • if repo is cloned, check out the given branch: TODO
  • clone repo if necessary: ????

modify-ami

• ConfigValidate:
  • vagrant builtin: ????
• VagrantPlugins::AWS::Action::ConnectAWS:
  • vagrant builtin: ????
• ModifyAMI:
  • use AWS EC2 API to add a tag to an AMI: TODO

modify-instance

• ConfigValidate:
  • vagrant builtin: ????
• VagrantPlugins::AWS::Action::ConnectAWS:
  • vagrant builtin: ????
• ModifyInstance:
  • allow a user to rename, stop or terminate AWS instances: TODO

origin-init

• GenerateTemplate:
  • generate a template for AWS (??) to define the instance that will be spawned: TODO

push-openshift-images

• PushOpenshiftImages:
  • ensure Docker daemon has registry as insecure: ????
  • tag and push Docker images: TODO (using make from Origin?)

push-openshift-release

• PushOpenshiftRelease:
  • shell out to a make target in Origin to push the release: TODO

sync-origin

• PrepareSSHConfig:
  • update ssh configuration: TODO
  • sync user's .openshiftdev/home.d files: ????
• Clean:
  • remove bare directories from prior clones: ????
• CloneUpstreamRepositories:
  • use git clone --bare on each repo: TODO, but not on sync?
• SyncLocalRepository:
  • make some temp commits locally, push from local to VM to update VM code, then remove tmp commmits locally: TODO
  • also allow a re-sync from a given branch or otherwise internet-accessible repo: TODO
• CheckoutRepositories:
  • see above
• BuildOriginBaseImages:
  • see above
• BuildOrigin:
  • see above
• RunSystemctl:
  • shell out to systemctl to restart the daemon: TODO

sync-origin-aggregated-logging

• PrepareSSHConfig:
  • see above
• Clean:
  • see above
• CloneUpstreamRepositories:
  • see above
• SyncLocalRepository:
  • see above
• CheckoutRepositories:
  • see above

sync-origin-console

• PrepareSSHConfig:
  • see above
• Clean:
  • see above
• CloneUpstreamRepositories:
  • see above
• SyncLocalRepository:
  • see above
• CheckoutRepositories:
  • see above
• InstallOriginAssetDependencies:
  • see above

sync-origin-metrics

• PrepareSSHConfig:
  • see above
• Clean:
  • see above
• CloneUpstreamRepositories:
  • see above
• SyncLocalRepository:
  • see above
• CheckoutRepositories:
  • see above

sync-sti

• PrepareSSHConfig:
  • see above
• Clean:
  • see above
• CloneUpstreamRepositories:
  • see above
• SyncLocalRepository:
  • see above
• CheckoutRepositories:
  • see above
• BuildSTI:
  • see above

test-origin

• RunOriginTests:
  • interpret input from the robot to invoke the correct make targets: TODO
  • shell out to the correct make target from user input: TODO
• DownloadArtifactsOrigin:
  • see above

test-origin-aggregated-logging

• RunOriginAggregatedLoggingTests:
  • see above
• DownloadArtifactsOriginAggregatedLogging:
  • see above

test-origin-console

• RunOriginConsoleTests:
  • see above
• DownloadArtifactsOriginConsole:
  • see above

test-origin-image

• TestOriginImage:
  • pull down latest openshift/base images and run make targets on them: ????
• DownloadArtifactsOrigin:
  • see above

test-origin-metrics

• RunOriginMetricsTests:
  • see above
• DownloadArtifactsOriginMetrics:
  • see above

test-origin-sti

• RunSTITests:
  • see above
• DownloadArtifactsSTI:
  • see above

try-restart-origin

• RunSystemctl:
  • see above