vagrant-openshift 1.0.9

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 37cbead9fef9d999bd787d5c5235398207ecf3fb
+  data.tar.gz: d55a4db0100f1aca956fbaaff81828cb922f8110
+SHA512:
+  metadata.gz: 4a9234f05f04cba7415dd7ef94457ae166609c0b747a571875f938e4ff3a984b3eb8cb28176fbc2d1d2accaa153432e419b2fa780c7526469b7e9c1faa511679
+  data.tar.gz: 7e514acfc0c3d39cdebfcbc0a76ac6632820ed643415bc82ce65958d1379d276e07eeb52dbf4eac606523472338245f5dba0c585945bea6976d6a56f86ad6ddc

data/.gitattributes

@@ -0,0 +1 @@
+* autocrlf=input eol=lf

data/.gitignore

@@ -0,0 +1,24 @@
+*.gem
+*.rbc
+*.swp
+.bundle
+.config
+.yardoc
+.project
+.idea/*
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+test/Vagrantfile
+test/origin-server
+test/puppet-openshift_origin
+test/rhc
+tmp

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in vagrant-openshift.gemspec
+gemspec
+
+group :development do
+  # We depend on Vagrant for development, but we don't add it as a
+  # gem dependency because we expect to be installed within the
+  # Vagrant environment itself using `vagrant plugin`.
+  gem "vagrant", :git => "git://github.com/mitchellh/vagrant.git"
+end

data/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2013 Red Hat, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.asciidoc

@@ -0,0 +1,379 @@
+== OpenShift Origin Build Tools
+
+This is a link:http://www.vagrantup.com[Vagrant] 1.2+ plugin that adds command and provisioner to
+build and test link:http://openshift.github.io[OpenShift Origin].
+
+NOTE: This plugin requires Vagrant 1.2+
+
+=== Features
+
+* Compatible with VMs run via link:https://www.virtualbox.org[VirtualBox], link:https://github.com/mitchellh/vagrant-aws[AWS]
+  or link:https://github.com/tknerr/vagrant-managed-servers[managed] providers.
+* Provides commands to install build dependencies, sync repositories, and run tests
+
+=== Installing
+
+To work on the *vagrant-openshift* plugin, clone this repository out, and use
+link:http://gembundler.com[Bundler] to get the dependencies:
+
+[source, sh]
+----
+$ bundle
+----
+
+Install prereq plugins to Vagrant
+----
+$ vagrant plugin install vagrant-aws
+----
+
+Compile an install the plugin using Rake
+
+[source, sh]
+----
+$ rake vagrant:install
+----
+
+=== Getting started
+
+==== Clone the OpenShift Origin repositories
+
+===== OpenShift 3
+
+[source, sh]
+----
+$ echo "export GOPATH=~/code" >> ~/.bash_profile   # ~/code can be any dir
+$ source ~/.bash_profile
+$ cd $GOPATH
+$ vagrant geard-local-checkout -u <github username>
+----
+
+===== OpenShift 2.x
+
+[source, sh]
+----
+$ vagrant origin-local-checkout -u <github username>
+----
+
+This will clone several repositories from link:http://www.github.com[GitHub] and link them against the upstream repositories.
+
+NOTE: Skip this step if building upstream code
+
+==== Initialize the Vagrantfile
+
+Create a Vagrantfile and customize it to match your requirements:
+
+[source, sh]
+----
+$ vagrant origin-init <instance name>
+----
+
+.Command options:
+
+* Specify which OS to build with:
+** --os fedora		- Launch a Fedora 20 image (used for OpenShift 3 development)
+** --os rhel6		- Launch a RHEL 6 image (where available)
+** --os centos6		- Launch a CentOS 6 image (where available, used for OpenShift 2.x development)
+
+* Specify the stage of image to launch:
+** --stage os    - Launch the base operating system with no OpenShift dependencies
+** --stage deps  - Launch the image with OpenShift dependencies already installed
+** --stage inst  - Launch the image with OpenShift fully installed
+
+.So to launch the latest OpenShift instance:
+
+[source, sh]
+----
+$ vagrant origin-init --stage inst --os fedora <instance name>
+----
+
+==== Start the machine
+
+===== VirtualBox
+
+Running with the default VirtualBox provider
+
+[source, sh]
+----
+vagrant up
+----
+
+Note: See Other Environments below for launching against other options.
+
+
+==== Making Subsequent Changes
+
+* Syncing and building code from local repository clones
+
+===== OpenShift 3
+
+[source, sh]
+----
+$ vagrant sync-geard
+----
+
+
+===== OpenShift 2.x
+
+[source, sh]
+----
+$ vagrant sync
+----
+
+
+==== Running OpenShift Origin Tests
+
+===== OpenShift 3
+
+[source, sh]
+----
+$ vagrant test-geard --all
+----
+
+
+===== OpenShift 2.x
+
+[source, sh]
+----
+$ vagrant test --all
+----
+
+== Other Notes
+
+==== Install OpenShift and its Dependencies
+
+If starting from --stage os, install the build and package dependencies.
+
+===== OpenShift 3
+
+[source, sh]
+----
+$ vagrant build-geard-base
+$ vagrant install-geard
+$ vagrant build-geard-broker
+$ vagrant install-geard-broker
+----
+
+===== OpenShift 2.x
+
+[source, sh]
+----
+$ vagrant origin-build-base
+$ vagrant sync --clean
+----
+
+==== Other Environments
+
+===== AWS/EC2
+
+* Install the latest vagrant-aws plugin. Follow the link:https://github.com/mitchellh/vagrant-aws/blob/master/README.md#development[build steps].
+
+* Edit the Vagrantfile and update your EC2 credentials.
+
+----
+aws.access_key_id = "<API KEY>"
+aws.secret_access_key = "<API SECRET>"
+aws.keypair_name = "<SSH KEY NAME>"
+override.ssh.private_key_path = "<PRIVATE KEY FILE>"
+----
+
+* Start the AWS machine
+
+[source, sh]
+----
+vagrant up --provider=aws
+----
+
+NOTE: Requires latest link:https://github.com/mitchellh/vagrant-aws[AWS] provider.
+
+NOTE: You can use the link:https://github.com/mikery/vagrant-ami[Vagrant-AMI] plugin to create an AMI from a running AWS machine.
+
+
+===== OpenStack
+
+* Install the latest vagrant-openstack-plugin. See: https://github.com/cloudbau/vagrant-openstack-plugin.
+
+* Edit the Vagrantfile and update your OpenStack credentials, endpoint and tenant (They can be read automatically from ~/.openstackcred).
+
+----
+os.endpoint                   = "<OPENSTACK ENDPOINT URL>"
+os.tenant                     = "<OPENSTACK TENANT>"
+os.username                   = "<OPENSTACK USERNAME>"
+os.api_key                    = "<OPENSTACK PASSWORD>"
+os.keypair_name               = "<OPENSTACK KEYPAIR NAME>"
+override.ssh.private_key_path = "<PRIVATE KEY FILE>"
+----
+
+* Start the OpenStack machine
+
+[source, sh]
+----
+vagrant up --provider=openstack
+----
+
+NOTE: Requires latest link:https://github.com/cloudbau/vagrant-openstack-plugin[OpenStack] provider.
+
+
+===== LibVirt
+
+* Install the vagrant-libvirt plugin dependencies
+
+[source, sh]
+----
+yum install libxslt-devel libxml2-devel libvirt-devel
+----
+
+* Install the vagrant-libvirt plugin
+
+[source, sh]
+----
+vagrant plugin install vagrant-libvirt
+----
+
+* Configure LibVirt to allow remote TLS connections
+** Create TLS certificates and key pairs. Follow the guide at http://libvirt.org/remote.html#Remote_certificates
+Example commands for creating a self signed certificate are provided below.
+
+.Example self-signed certificates
+[source, sh]
+----
+mkdir -p /etc/pki/libvirt/private
+
+#CA Cert
+certtool --generate-privkey > cakey.pem
+
+cat <<EOF> ca.info
+cn = MyOrg
+ca
+cert_signing_key
+EOF
+
+certtool --generate-self-signed --load-privkey cakey.pem --template ca.info --outfile cacert.pem
+/bin/cp -f cacert.pem /etc/pki/CA/cacert.pem
+
+#Server cert
+certtool --generate-privkey > serverkey.pem
+
+cat <<EOF> server.info
+organization = MyOrg
+cn = oirase
+tls_www_server
+encryption_key
+signing_key
+EOF
+
+certtool --generate-certificate --load-privkey serverkey.pem \
+  --load-ca-certificate cacert.pem --load-ca-privkey cakey.pem \
+  --template server.info --outfile servercert.pem
+/bin/cp -f serverkey.pem /etc/pki/libvirt/private/serverkey.pem
+/bin/cp -f servercert.pem /etc/pki/libvirt/servercert.pem
+
+#Client cert
+certtool --generate-privkey > clientkey.pem
+
+cat <<EOF> client.info
+country = US
+state = California
+locality = Mountain View
+organization = MyOrg
+cn = client1
+tls_www_client
+encryption_key
+signing_key
+EOF
+
+certtool --generate-certificate --load-privkey clientkey.pem \
+  --load-ca-certificate cacert.pem --load-ca-privkey cakey.pem \
+  --template client.info --outfile clientcert.pem
+
+/bin/cp -f clientkey.pem /etc/pki/libvirt/private/clientkey.pem
+/bin/cp -f clientcert.pem /etc/pki/libvirt/clientcert.pem
+----
+
+** Modify /etc/sysconfig/libvirtd and enable listening to connections
+
+----
+LIBVIRTD_ARGS="--listen"
+---- 
+
+** Restart libvirtd
+
+* Start the LibVirt machine
+
+[source, sh]
+----
+vagrant up --provider=libvirt
+----
+
+NOTE: Requires latest link:https://github.com/pradels/vagrant-libvirt[LibVirt] provider
+
+===== Managed
+
+Running on other environments which are not managed by Vagrant directly.
+
+* Install the vagrant-managed-servers plugin
+
+[source, sh]
+----
+vagrant plugin install vagrant-managed-servers
+----
+
+* Edit the Vagrantfile and update the managed section to update the IP address, User name and SSH key.
+
+----
+managed.server = "HOST or IP of machine"
+override.ssh.username = "root"
+override.ssh.private_key_path = "~/.ssh/id_rsa"
+----
+
+* Connect to the manually managed machine
+
+[source, sh]
+----
+vagrant up --provider=managed
+----
+
+NOTE: Requires latest link:https://github.com/tknerr/vagrant-managed-servers[Managed] provider
+
+=== Developer environment
+
+To enable easy customization of the build environment, any files placed under '\~/.openshiftdev/home.d' will be copied to
+the vagrant user home directory. For example: '~/.openshiftdev/home.d/.bash_profile' will be copied to '.bash_profile'
+on the vagrant VM.
+
+=== AWS Credentials
+
+Rather than have to add AWS credentials every time the Vagrantfile is created using origin-init command, you can
+specify your credentials in the '~/.awscreds' file and it will be automatically added to the Vagrantfile.
+
+Example:
+
+.'~/.awscreds'
+----
+AWSAccessKeyId=<AWS API Key>
+AWSSecretKey=<AWS API Secret>
+AWSKeyPairName=<Keypair name>
+AWSPrivateKeyPath=<SSH Private key>
+----
+
+
+=== OpenStack Credentials
+
+Rather than have to add OpenStack credentials every time the Vagrantfile is created using origin-init command, you can
+specify your credentials in the '~/.openstackcred' file and it will be automatically added to the Vagrantfile.
+
+Example:
+
+.'~/.openstackcred'
+----
+OSEndpoint=<OpenStack Endpoint URL>
+OSUsername=<OpenStack Username>
+OSAPIKey=<OpenStack Password>
+OSKeyPairName=<Keypair name >
+OSPrivateKeyPath=<SSH Private key path>
+OSTenant=<OpenStack Tenant Name>
+----
+
+
+== Notice of Export Control Law
+
+This software distribution includes cryptographic software that is subject to the U.S. Export Administration Regulations (the "*EAR*") and other U.S. and foreign laws and may not be exported, re-exported or transferred (a) to any country listed in Country Group E:1 in Supplement No. 1 to part 740 of the EAR (currently, Cuba, Iran, North Korea, Sudan & Syria); (b) to any prohibited destination or to any end user who has been prohibited from participating in U.S. export transactions by any federal agency of the U.S. government; or (c) for use in connection with the design, development or production of nuclear, chemical or biological weapons, or rocket systems, space launch vehicles, or sounding rockets, or unmanned air vehicle systems.You may not download this software or technical information if you are located in one of these countries or otherwise subject to these restrictions. You may not provide this software or technical information to individuals or entities located in one of these countries or otherwise subject to these restrictions. You are also responsible for compliance with foreign law requirements applicable to the import, export and use of this software and technical information.

data/Rakefile

@@ -0,0 +1,53 @@
+#--
+# Copyright 2013 Red Hat, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+require 'rubygems'
+require 'bundler/setup'
+require 'pry'
+$stdout.sync = true
+$stderr.sync = true
+
+namespace :vagrant do
+
+  desc "Install plugin into Vagrant"
+  task :install do
+    # We want to install our plugin on the system vagrant. Pull gem paths out of
+    # $PATH so that we get the correct vagrant binary.
+    dirty_path = `echo $PATH`
+    clean_path = dirty_path.split(':').select{ |p| not p.include?('gem') }.join(':')
+    sys_cmd = `PATH=#{clean_path} which vagrant`.chomp
+    if not $?.exitstatus == 0
+      sys_cmd = `which vagrant`.chomp
+      if not $?.exitstatus == 0
+        puts "ERROR: Could not find a Vagrant binary in your PATH.\nEnsure that Vagrant has been installed on this system."
+        exit
+      else
+        puts "WARNING: Could not find a Vagrant binary outside of your gem environments.\nEnsure that the Vagrant package has been installed from the official Vagrant packages and not a gem."
+      end
+    end
+
+    system("rm -rf pkg")
+
+    Rake::Task['build'].invoke
+    name = Bundler::GemHelper.instance.send(:name)
+    version = Bundler::GemHelper.instance.send(:version).to_s
+
+    system "#{sys_cmd} plugin uninstall vagrant-openshift; #{sys_cmd} plugin install pkg/#{name}-#{version}.gem"
+  end
+end
+
+Bundler::GemHelper.install_tasks
+task :default => "vagrant:install"

data/lib/vagrant-openshift/action/build_geard.rb

@@ -0,0 +1,41 @@
+#--
+# Copyright 2013 Red Hat, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Vagrant
+  module Openshift
+    module Action
+      class BuildGeard
+        include CommandHelper
+
+        def initialize(app, env)
+          @app = app
+          @env = env
+        end
+
+        def call(env)
+          do_execute(env[:machine], sync_bash_command('geard', %{
+echo "Performing geard build..."
+set -e
+contrib/build -s
+          }))
+
+          @app.call(env)
+        end
+
+      end
+    end
+  end
+end

data/lib/vagrant-openshift/action/build_geard_broker.rb

@@ -0,0 +1,59 @@
+#--
+# Copyright 2013 Red Hat, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Vagrant
+  module Openshift
+    module Action
+      class BuildGeardBroker
+        include CommandHelper
+
+        def initialize(app, env, options = {})
+          @app = app
+          @env = env
+          @options = options
+        end
+
+        def call(env)
+          docker_file_path = "broker/docker/origin-broker-builder"
+          build_builder_cmd = %{
+echo "Performing origin-broker-builder build..."
+set -e
+pushd #{Constants.build_dir}origin-server/#{docker_file_path}
+  docker build --rm #{@options[:force] ? "--no-cache" : ""} -t origin-broker-builder .
+popd
+          }
+          build_broker_cmd = %{
+echo "Copy generated plugin configuration to broker source for use in build"
+PLUGINS_CONF="#{Vagrant::Openshift::Constants.plugins_conf_dir}"
+cp -f --parents $(find $PLUGINS_CONF \\( -name "*.conf" \\)) /data/src/github.com/openshift/origin-server
+echo "Performing broker build..."
+set -e
+gear build #{Constants.build_dir}origin-server/ origin-broker-builder origin-broker --verbose
+          }
+
+          if @options[:force]
+            sudo(env[:machine], build_builder_cmd + build_broker_cmd, {:timeout => 60*40})
+          else
+            sudo(env[:machine], sync_bash_command_on_dockerfile('origin-server', docker_file_path, build_builder_cmd), {:timeout => 60*20})
+
+            sudo(env[:machine], sync_bash_command('origin-server', build_broker_cmd), {:timeout => 60*20})
+            @app.call(env)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-openshift/action/build_geard_console.rb

@@ -0,0 +1,55 @@
+#--
+# Copyright 2013 Red Hat, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Vagrant
+  module Openshift
+    module Action
+      class BuildGeardConsole
+        include CommandHelper
+
+        def initialize(app, env, options = {})
+          @app = app
+          @env = env
+          @options = options
+        end
+
+        def call(env)
+          docker_file_path = "console/docker/origin-console-builder"
+          build_builder_cmd = %{
+echo "Performing origin-console-builder build..."
+set -e
+pushd #{Constants.build_dir}origin-server/#{docker_file_path}
+  docker build --rm #{@options[:force] ? "--no-cache" : ""} -t origin-console-builder .
+popd
+          }
+          build_console_cmd = %{
+echo "Performing console build..."
+set -e
+gear build #{Constants.build_dir}origin-server/ origin-console-builder origin-console --verbose
+          }
+          if @options[:force]
+            sudo(env[:machine], build_builder_cmd + build_console_cmd, {:timeout => 60*40})
+          else
+            sudo(env[:machine], sync_bash_command_on_dockerfile('origin-server', docker_file_path, build_builder_cmd), {:timeout => 60*20})
+
+            sudo(env[:machine], sync_bash_command('origin-server', build_console_cmd), {:timeout => 60*20})
+            @app.call(env)
+          end
+        end
+      end
+    end
+  end
+end