Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2341 commits
Select commit Hold shift + click to select a range
a9fd1ec
Merge pull request #1197 from kargakis/stream-logs
Mar 5, 2015
9e1ec1e
Merge pull request #1238 from deads2k/deads-add-redirect-to-viewers
Mar 5, 2015
0298616
Merge pull request #1186 from deads2k/deads-personal-subject-access-r…
Mar 5, 2015
42547b4
Only build images during build-cross
ironcladlou Mar 5, 2015
e22dc5a
Merge pull request #1241 from ironcladlou/build-optimization
Mar 6, 2015
11f85cf
create the buildconfig before creating the first imagerepo
bparees Mar 6, 2015
dc08e0a
Merge pull request #1248 from bparees/repo_race
Mar 6, 2015
4b96a22
Remove fake docker autogen package
smarterclayton Mar 8, 2015
1d00584
UPSTREAM: docker/utils does not need to access autogen
smarterclayton Mar 8, 2015
2a2d318
Merge pull request #1251 from smarterclayton/remove_autogen
Mar 8, 2015
778015d
Remove dockerutils
smarterclayton Mar 8, 2015
975eb59
Remove use of Docker registry code
smarterclayton Mar 8, 2015
f18bd62
Merge pull request #1252 from smarterclayton/remove_docker_utils
Mar 8, 2015
0c5b819
Address some cli usage msg inconsistencies
Kargakis Mar 8, 2015
9ae944a
Merge pull request #968 from sdodson/alpha-beta
Mar 9, 2015
9b68065
Merge pull request #1159 from kargakis/build-logs
Mar 9, 2015
3f262bd
Merge pull request #1048 from derekwaynecarr/enable_quota_on_admission
Mar 9, 2015
86b5e46
Merge pull request #1253 from kargakis/cli-usage
Mar 9, 2015
3ec5d92
Make it easy to export certs to curl
smarterclayton Mar 9, 2015
26b535a
bump(github.com/skynetservices/skydns):f18bd625a71b5d013b6e6288d1c7ec…
smarterclayton Mar 8, 2015
55b2cae
UPSTREAM: Disable systemd activation for DNS
smarterclayton Mar 9, 2015
dc16de5
Add DNS support to OpenShift
smarterclayton Mar 8, 2015
b2ba6a5
Fixed URLs for webhooks presented in osc describe
soltysh Mar 5, 2015
a9b7796
remove test-integration.sh from make test. Resolves #1255
Mar 9, 2015
7a905ab
Merge pull request #1240 from soltysh/issue941
Mar 9, 2015
ff795d7
Management Console - Create from template
csrwng Feb 19, 2015
9ec70f7
Merge pull request #1129 from csrwng/creation_flow
Mar 9, 2015
8807269
Merge pull request #1254 from smarterclayton/dns
Mar 9, 2015
82ee14b
Merge pull request #1219 from sdodson/bump-sti-image-builder
Mar 9, 2015
479dbbd
Merge pull request #1258 from pweil-/make-integration
Mar 9, 2015
c6168a2
Bug 119409 - fix source URI generated by new-app
csrwng Mar 10, 2015
f99a7b1
Make sure we don't swallow errors from inner Convert calls
soltysh Mar 10, 2015
b26ffa3
Add cert validation options to requestheader
liggitt Mar 6, 2015
dcf2797
Move glog.Fatal to error propagation
liggitt Mar 10, 2015
3befb47
DNS default check should not be in server.Config
smarterclayton Mar 9, 2015
5277a86
Merge pull request #1246 from liggitt/request_header_cert
Mar 10, 2015
053bb3e
Allow stored templates to be referenced from osc process
mfojtik Mar 10, 2015
8d31614
Merge pull request #1267 from soltysh/conversion_fix
Mar 10, 2015
51fd38a
added notes for Vagrant users in sample-app README doc
sallyom Mar 6, 2015
86186b1
Merge pull request #1269 from mfojtik/process_stored_template
Mar 10, 2015
f15d07e
Remove self closing tags
liggitt Mar 10, 2015
72d2a0f
Merge pull request #1270 from liggitt/ui_fix
Mar 10, 2015
e3cdf0e
Merge pull request #1259 from sallyom/sample_app_doc_update
Mar 10, 2015
fd897fb
UPSTREAM: Handle missing resolv.conf
smarterclayton Mar 10, 2015
ee818f2
Allow OpenShift to start on an airplane
smarterclayton Mar 10, 2015
d875797
Adds reaping capability to openshift.
mrunalp Mar 10, 2015
e3a5baf
Rework page structure to use flexbox so that sidebar columns extend w…
sg00dwin Mar 10, 2015
13a2add
add detail to forbidden message
deads2k Mar 11, 2015
3079088
Bug 1200684: Retrieve logs from failed builds
Kargakis Mar 11, 2015
7741f67
add role and rolebinding gets and lists
deads2k Feb 27, 2015
c25b5f2
role and rolebinding printers and describers
deads2k Feb 27, 2015
ed44739
Bug 1200346 - need to convert quota values including SI prefixes for …
jwforres Mar 11, 2015
6916934
Fix bindata for rework page structure to use flexbox so that sidebar …
jwforres Mar 11, 2015
3b044d9
Merge pull request #4 from jwforres/flexbox_dev_bindata_fix
sg00dwin Mar 11, 2015
1751024
Merge pull request #1274 from sg00dwin/flexbox-dev
Mar 11, 2015
817be5f
Merge pull request #1187 from deads2k/deads-add-gets-lists
Mar 11, 2015
84159e6
Merge pull request #1278 from deads2k/deads-make-forbidden-more-useful
Mar 11, 2015
bd16bec
Merge pull request #1277 from jwforres/bug_1200346_include_multiplier…
Mar 11, 2015
51449eb
allow bootstrap policy to span namespaces
deads2k Mar 11, 2015
dd2bfc2
comments 1
deads2k Mar 11, 2015
0b417e5
Merge pull request #1264 from mrunalp/reaper
Mar 11, 2015
603e632
Fix temporary platform builder image names for generation tools
csrwng Mar 11, 2015
80cdd4a
check if template exists
bparees Mar 12, 2015
e800d94
comments 2
deads2k Mar 12, 2015
b837a77
integration test
deads2k Mar 12, 2015
8f0c933
Add more visual separation between builds, add copy to clipboard for …
jwforres Mar 12, 2015
490e289
Merge pull request #1293 from jwforres/build_page_changes_round2
Mar 12, 2015
70b8e2b
Merge pull request #1281 from deads2k/deads-add-openshift-image-role
Mar 12, 2015
d5881df
Merge pull request #1276 from kargakis/minor-fix
Mar 12, 2015
acbb6ff
Need more detail for contributing to v3 web console, started an archi…
jwforres Mar 12, 2015
7fbb866
Merge pull request #1297 from jwforres/doc_console_arch
Mar 12, 2015
ed9859e
fix start-build follow to stop following eventually
deads2k Mar 12, 2015
8dc7a6e
Merge pull request #1299 from deads2k/deads-fix-build-follow
Mar 12, 2015
9f217aa
Various image updates
Feb 20, 2015
7b53272
Merge pull request #1292 from bparees/check_template
Mar 12, 2015
1b40b67
Merge pull request #1223 from ncdc/image-repo-tag-history
Mar 12, 2015
ce53783
Merge pull request #1290 from csrwng/fix_newapp_nodejs_builder
Mar 13, 2015
38cdd38
Add simple shard allocator plugin to autogenerate host names for routes
ramr Mar 11, 2015
b985b82
Fixes to route allocator plugin PR as per @smarterclayton comments.
ramr Mar 12, 2015
d0d6feb
Switch default route dns suffix to "router.default.local"
ramr Mar 12, 2015
93fb19b
Add additional items to vm-provision-full
smarterclayton Mar 9, 2015
6493776
Merge pull request #1266 from csrwng/bug_119409
Mar 13, 2015
2bba7ef
Merge pull request #1291 from ramr/hostgen
Mar 13, 2015
c941bc7
Merge pull request #1256 from smarterclayton/extra_provision
Mar 13, 2015
a7b4855
path based ACLs
Mar 11, 2015
f0393ea
Consolidate image reference generation/lookup
Mar 10, 2015
ed88c0e
Removed extra tools imports
soltysh Mar 13, 2015
b702cab
cancel-build: Use BuildLogs client method
Kargakis Mar 13, 2015
8ac5c4d
Add DockerImageReference type
Mar 13, 2015
03b5237
Merge pull request #1295 from smarterclayton/run_without_address
Mar 13, 2015
bdbcf5e
Merge pull request #1263 from smarterclayton/fix_location_of_dns_default
Mar 13, 2015
e43fe6b
Merge pull request #1304 from soltysh/import_cleaning
Mar 13, 2015
47c2e29
Merge pull request #1306 from kargakis/add-client-method
Mar 13, 2015
34f7d1d
Merge pull request #1294 from ncdc/use-image-repo-image-refs
Mar 13, 2015
84d9030
Merge pull request #1235 from pweil-/router-paths
Mar 13, 2015
da2e46a
Always use port 8053 in integration tests
smarterclayton Mar 13, 2015
2066c7a
Merge pull request #1308 from smarterclayton/fix_dns_integration_test
Mar 14, 2015
f3d797f
UPSTREAM: Temporarily relax annotations further
smarterclayton Mar 13, 2015
1b57307
UPSTREAM: Don't hang when registering zero nodes
smarterclayton Mar 14, 2015
8ec1918
Tease apart separate concerns in RetryController
smarterclayton Mar 13, 2015
37f13d1
Remove excessive logging
smarterclayton Mar 14, 2015
1d6bea0
Allow test of only master to start successfully
smarterclayton Mar 14, 2015
ab1d409
Merge pull request #1310 from smarterclayton/fixes_to_controllers_and…
Mar 14, 2015
126db65
Make tests for the Docker parser more robust
Kargakis Mar 15, 2015
f25a154
Merge pull request #1311 from kargakis/better-tests
Mar 15, 2015
4652ad3
Remove commented imports
Kargakis Mar 16, 2015
c634114
Handle wildcard resolution of services
smarterclayton Mar 13, 2015
8d7737d
Merge pull request #1313 from kargakis/remove-import-comment
Mar 16, 2015
4cd2b80
Merge pull request #1307 from smarterclayton/resolve_wildcard
Mar 16, 2015
3e9ee19
Speed up installation of etcd
mfojtik Mar 16, 2015
e6d1da1
Merge pull request #1316 from mfojtik/etcd_install
Mar 16, 2015
1b34d64
Temporary fix to bump timeout to 300s
sdodson Mar 16, 2015
69b7f76
Merge pull request #1319 from sdodson/bump-timeoutstartsec-300s
Mar 16, 2015
80bab11
UPSTREAM: loader allows multiple sets of loading rules
fabianofranz Feb 13, 2015
9a34d66
Introducing client projects switching - 'osc project'
fabianofranz Feb 27, 2015
2de77d1
Introducing client login and setup - 'osc login'
fabianofranz Feb 11, 2015
aa0ba81
Project is not required for a successful login
fabianofranz Mar 16, 2015
0ac00c6
Merge pull request #992 from fabianofranz/osc_login_further
Mar 16, 2015
e33628f
Generation command tests
csrwng Mar 10, 2015
2de5dfc
Merge pull request #1305 from csrwng/generation_tests
Mar 17, 2015
52f16be
Minor message improvement
fabianofranz Mar 17, 2015
d1f45db
Remove unwanted ng-if check from template catalog
jwforres Mar 17, 2015
375006a
Error handling for web console, adds notification service and limits …
jwforres Mar 16, 2015
3038033
add serializeable start config
deads2k Mar 4, 2015
1d21d59
Merge pull request #1331 from fabianofranz/master
Mar 17, 2015
a773709
Bug 1202686 - fixes forbidden error detection
fabianofranz Mar 17, 2015
4548ebb
Merge pull request #1325 from jwforres/error_handling
Mar 17, 2015
baa1569
Merge pull request #1332 from jwforres/temp_fix_catalog
Mar 17, 2015
4a3fe56
Merge pull request #1334 from fabianofranz/bugs_1202686
Mar 17, 2015
eaf15b4
Merge pull request #1247 from deads2k/deads-intermediate-config
Mar 17, 2015
6594ffd
Issue1317 - Added error logging to webhook controller
soltysh Mar 17, 2015
87d9e2a
Add osc exec and port-forward commands
Mar 11, 2015
ae1dca3
Add an initial importer for Image Repositories
smarterclayton Mar 12, 2015
8573934
Use the dockerImageReference tag when pushed
smarterclayton Mar 13, 2015
3c028a5
Change how tags and status events are recorded
smarterclayton Mar 14, 2015
ebbf8a6
Preserve tag when v1 pull by id is possible
Mar 17, 2015
2926dd5
Merge pull request #1333 from soltysh/issue1317
Mar 17, 2015
86e9e5c
Make file references in config relative to config files
liggitt Mar 17, 2015
e136040
Call sdNotify as soon as we've started OpenShift API server or node
sdodson Mar 12, 2015
f4dd296
Merge pull request #1280 from ncdc/exec-port-forward
Mar 17, 2015
12b5008
UPSTREAM: remove exec ARGS log message
Mar 17, 2015
83a7f0a
Merge pull request #1303 from smarterclayton/add_docker_controller
Mar 17, 2015
5d73167
Bug 1202672 - handle osc project without argument and no namespace set
fabianofranz Mar 17, 2015
a8ab902
Merge pull request #1346 from ncdc/master
Mar 17, 2015
69a3203
Merge pull request #1347 from fabianofranz/bugs_1202672
Mar 17, 2015
a611e13
Initial config validation
liggitt Mar 17, 2015
972d88b
Group node certs under a single directory
liggitt Mar 17, 2015
b5ed22f
Merge pull request #1340 from liggitt/config
Mar 18, 2015
41dae4d
Restore ability to run in http
liggitt Mar 18, 2015
6c84541
Fix grammar in README
csrwng Mar 18, 2015
620cbcf
Change BindAddrArg to ListenArg
liggitt Mar 18, 2015
936d25b
Merge pull request #1345 from liggitt/run_http
Mar 18, 2015
c827524
Use new openshift/mysql-55-centos7 image for sample-app
mnagy Mar 5, 2015
8015ebc
Fix create-server-cert --signer-signer-{cert,key,serial} stutter
sdodson Mar 18, 2015
066cb50
add completion time field to builds
bparees Mar 13, 2015
a46042a
Issue 1356 - setup should either save cert file or data
fabianofranz Mar 18, 2015
337ebdb
Merge pull request #1359 from sdodson/issue1357
Mar 18, 2015
d1326a1
Remove docker IP from certs
liggitt Mar 13, 2015
08e9b33
Merge pull request #1360 from fabianofranz/issues_1356
Mar 18, 2015
984fc5a
Merge pull request #1265 from liggitt/remove_docker_ip
Mar 18, 2015
ad916a8
separate out bootstrap policy
deads2k Mar 17, 2015
9021dbc
examples, docs: describe user creation thoroughly
TomasTomecek Mar 18, 2015
e6887e2
added test case for empty name argument
sallyom Mar 16, 2015
f21cce2
Merge pull request #1355 from deads2k/deads-write-bootstrap-config
Mar 18, 2015
bf518dd
Set master IP correctly when starting kubernetes
liggitt Mar 18, 2015
d1bc1b8
use bootstrap policy constants for namespace and role default
deads2k Mar 18, 2015
7e2943c
Merge pull request #1368 from TomasTomecek/docs-describe-user-creation
Mar 18, 2015
09154ef
Make console logging be enabled/disabled with log levels and scoped l…
jwforres Mar 18, 2015
3b6e0ff
Merge pull request #1322 from sallyom/addtesting
Mar 18, 2015
e48cdba
Merge pull request #1354 from csrwng/fix_readme
Mar 18, 2015
c4c8c23
Query the sample app during e2e to make sure MySQL responds
mnagy Mar 17, 2015
e6526d9
Merge pull request #1367 from liggitt/master_ip
Mar 18, 2015
dd24e1a
Merge pull request #1329 from mnagy/sample_app_mysql
Mar 18, 2015
e477b07
Merge pull request #1362 from deads2k/deads-use-master-constant
Mar 18, 2015
ed9bc19
Merge pull request #1365 from jwforres/logger
Mar 18, 2015
958245c
Merge pull request #1328 from mnagy/e2e_database_test
Mar 18, 2015
a3484a0
Issue 1348 - add support to expose persistent flags in help
fabianofranz Mar 19, 2015
d1b9ed5
Merge pull request #1372 from fabianofranz/issues_1348
Mar 19, 2015
69665fc
Merge pull request #1326 from bparees/build_completion_time
Mar 19, 2015
db78909
properly handle missing policy document
deads2k Mar 19, 2015
7e9e081
auto-provision policy bindings for bootstrapping
deads2k Mar 19, 2015
ec1011a
Merge pull request #1375 from deads2k/deads-policy-bugs
Mar 19, 2015
1a25027
Add ./hack/test-extended.sh
mfojtik Mar 16, 2015
47caf77
Reworked integration tests and added extended tests
mfojtik Mar 16, 2015
cfd75d0
UPSTREAM: allow any number of kubeconfig files
fabianofranz Mar 18, 2015
c087f95
Rebasing upstream to allow any number of kubeconfig files
fabianofranz Mar 18, 2015
814026a
Merge pull request #1230 from mfojtik/ext_int_test_poc
Mar 19, 2015
e2913a3
Fix panic during timeout
ironcladlou Mar 19, 2015
aba3463
Removed copies of util.DefaultClientConfig
fabianofranz Mar 18, 2015
f476dfa
Add dockerImageRepository to sample custom builder image repo
csrwng Mar 19, 2015
29fe8da
Merge pull request #1380 from ironcladlou/recreate-panic-fix
Mar 19, 2015
8090f25
Fix typo in extended docker test
mfojtik Mar 19, 2015
dc54dd1
Merge pull request #1298 from sdodson/increase-master-startup
Mar 19, 2015
3927896
Merge pull request #1382 from csrwng/custombuild_imagerepo
Mar 19, 2015
49963b3
Merge pull request #1366 from fabianofranz/rebase_kube_loader_with_mu…
Mar 19, 2015
96e4e16
make login test avoid default kubeconfig chain
deads2k Mar 19, 2015
ddf48a2
Merge pull request #1381 from mfojtik/fix_extended
Mar 19, 2015
f225488
Merge pull request #1378 from deads2k/deads-fix-login-test
Mar 19, 2015
50eb1bb
add identities for router and registry
deads2k Mar 18, 2015
f19409d
add create-client command
deads2k Mar 18, 2015
dbdf98f
Merge pull request #1369 from deads2k/deads-create-more-certs
Mar 19, 2015
d9138cb
describe canceled build duration
bparees Mar 19, 2015
2a811d8
handle trailing slashes
deads2k Mar 19, 2015
5006f64
Pre-push ruby image for extended tests
mfojtik Mar 19, 2015
ec54d4b
Merge pull request #1387 from bparees/canceled_duration
Mar 19, 2015
ad1d664
Merge pull request #1391 from mfojtik/prepush_extended_image
Mar 19, 2015
8df8f55
bump(Sirupsen/logrus):2cea0f0d141f56fae06df5b813ec4119d1c8ccbd
Mar 12, 2015
4766eb5
bump(docker/distribution):70560cceaf3ca9f99bfb2d6e84312e05c323df8b
Mar 12, 2015
4132309
bump(docker/docker):c1639a7e4e4667e25dd8c39eeccb30b8c8fc6357
Mar 17, 2015
621909f
UPSTREAM: use docker's ParseRepositoryTag when pulling images
Mar 18, 2015
400c366
Add v2 registry
Mar 19, 2015
9c1a108
Merge pull request #1389 from deads2k/deads-allow-leading-slash
Mar 20, 2015
37f7068
Merge pull request #1344 from ncdc/v2-registry
Mar 20, 2015
06a2e6d
Unset KUBECONFIG prior to hack/test-cmd.sh
smarterclayton Mar 19, 2015
31bb663
WIP 1
smarterclayton Mar 18, 2015
09b7b42
WIP 2
smarterclayton Mar 18, 2015
de4fdb6
WIP 3
smarterclayton Mar 19, 2015
8a33840
WIP 4
smarterclayton Mar 19, 2015
244cb98
WIP 5
smarterclayton Mar 19, 2015
2dcfeb9
WIP 6
smarterclayton Mar 19, 2015
8081320
WIP 7
smarterclayton Mar 19, 2015
c4ea869
WIP 8
smarterclayton Mar 19, 2015
eae65b8
UPSTREAM: Remove cadvisor_mock.go
smarterclayton Mar 19, 2015
c645d86
WIP 9
smarterclayton Mar 20, 2015
05e9709
WIP 10
smarterclayton Mar 20, 2015
e4f4e43
UPSTREAM: Handle missing resolv.conf
smarterclayton Mar 10, 2015
da2a0ba
UPSTREAM: Disable systemd activation for DNS
smarterclayton Mar 9, 2015
2b6f94e
UPSTREAM: Disable UIs for Kubernetes and etcd
smarterclayton Dec 24, 2014
70fda9c
UPSTREAM: need to make sure --help flags is registered before calling…
fabianofranz Feb 3, 2015
a12ada9
UPSTREAM: Make setSelfLink not bail out
smarterclayton Feb 25, 2015
94ca20d
UPSTREAM: Lazily init systemd for code that includes cadvisor but doe…
smarterclayton Mar 19, 2015
c3eb763
UPSTREAM: Remove global map from healthz
smarterclayton Mar 19, 2015
e1b26ce
UPSTREAM: Tone down pod probe logging
smarterclayton Mar 20, 2015
3bfc5e9
Refactor 1
smarterclayton Mar 19, 2015
568388e
Refactor 2
smarterclayton Mar 19, 2015
17e79e8
Refactor 3
smarterclayton Mar 19, 2015
4548332
Refactor 4
smarterclayton Mar 19, 2015
beb5bdd
Refactor 5
smarterclayton Mar 19, 2015
8dbf6fc
Refactor 6
smarterclayton Mar 19, 2015
27ad04a
Refactor 7
smarterclayton Mar 19, 2015
4dd75c3
Refactor 8
smarterclayton Mar 19, 2015
f6e7956
Refactor 9
smarterclayton Mar 20, 2015
47a754a
Refactor 10
smarterclayton Mar 20, 2015
9cac9db
Remove debug logging from image controller
smarterclayton Mar 19, 2015
c987e73
Add check-test in between check and test
smarterclayton Mar 19, 2015
677716f
Ensure integration tests run when Docker is not available
smarterclayton Mar 19, 2015
c583062
Kubelet health check fails when not sent to hostname
smarterclayton Mar 19, 2015
eeba91c
Refactor 11
smarterclayton Mar 20, 2015
c014540
Convert travis to make check-test
smarterclayton Mar 20, 2015
df7a79b
Fixed buildlogs
soltysh Mar 20, 2015
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
The diff you're trying to view is too large. We only load the first 3000 changed files.
18 changes: 14 additions & 4 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,14 @@
/output
/pkg/version/autogenerated.go
/third_party/pkg
/*.etcd
/_output
/openshift.local.*
/.project
/.vagrant
/examples/sample-app/openshift.local.*
/examples/sample-app/logs/openshift.log
*.swp
.vimrc
.kubeconfig
.vagrant-openshift.json*
.DS_Store
.idea
origin.iml
*.pyc
29 changes: 29 additions & 0 deletions .travis.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
language: go

go:
- 1.3
- 1.4

env:
- TEST_ASSETS=true
- TEST_ASSETS=false

matrix:
exclude:
- go: 1.4
env: TEST_ASSETS=true

install:
- ./hack/verify-jsonformat.sh
- ./hack/install-etcd.sh
- ./hack/install-std-race.sh
- ./hack/install-tools.sh
- ./hack/build-go.sh
- ./hack/install-assets.sh

script:
- PATH=$HOME/gopath/bin:./_output/etcd/bin:$PATH make check-test GOFLAGS="-p=4"
- ./hack/test-assets.sh

notifications:
irc: "chat.freenode.net#openshift-dev"
156 changes: 156 additions & 0 deletions CONTRIBUTING.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,156 @@
= Contributing to OpenShift 3
OpenShift Developers <dev@lists.openshift.redhat.com>
:data-uri:
:icons:
:toc2:
:sectanchors:

The OpenShift 3 architecture builds upon the flexibility and scalability of https://docker.com/[Docker] and https://github.com/GoogleCloudPlatform/kubernetes[Kubernetes] to deliver a powerful new Platform as a Service system. This article explains how to set up a development environment and get involved with this latest version of OpenShift.

There are multiple ways to start coding OpenShift.

* <<download-from-github>>
* <<develop-locally-on-your-host>>
* <<develop-on-virtual-machine-using-vagrant>>

== Download from GitHub

The OpenShift team periodically publishes binaries to Github on https://github.com/openshift/origin/releases[the Releases page]. These are Linux, Windows, or Mac OS X 64bit binaries (note that Mac and Windows are client only). You'll need Docker installed on your local system (see https://docs.docker.com/installation/#installation[the installation page] if you've never installed Docker before).

The tar file for each platform contains a single binary `openshift` which is the all-in-one OpenShift installation.

* Use `sudo openshift start` to launch the server. Root access is required to create services due to the need to modify IPTables. See issue: https://github.com/GoogleCloudPlatform/kubernetes/issues/1859.
* Use `osc -h <server> ...` to connect to an OpenShift server
* Use `openshift help` to see more about the commands in the binary

== Develop locally on your host

You can develop OpenShift 3 on Windows, Mac, or Linux, but you'll need Docker installed on Linux to actually launch containers.

* For OpenShift 3 development, install the http://golang.org/[Go] programming language
* To launch containers, install the https://docker.com/[Docker] platform

Here's how to get set up:

1. For Go, Git and optionally also Docker, follow the links below to get to installation information for these tools: +
** http://golang.org/doc/install[Installing Go]
** http://git-scm.com/book/en/v2/Getting-Started-Installing-Git[Installing Git]
** https://docs.docker.com/installation/#installation[Installing Docker]
2. Next, create a Go workspace directory: +
+
----
$ mkdir $HOME/go
----
3. In your `.bashrc` file or `.bash_profile` file, set a GOPATH and update your PATH: +
+
----
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
----
4. Open up a new terminal or source the changes in your current terminal, and you're ready to code.

== Develop on virtual machine using Vagrant

To facilitate rapid development we've put together a Vagrantfile you can use to stand up a development environment.

1. http://www.vagrantup.com/downloads[Install Vagrant]

2. https://www.virtualbox.org/wiki/Downloads[Install VirtualBox] (Ex: `yum install VirtualBox`)

3. Clone the project and change into the directory:

$ mkdir -p $GOPATH/src/github.com/openshift
$ cd $GOPATH/src/github.com/openshift
$ git clone git://github.com/openshift/origin
$ cd origin

4. Bring up the VM:

$ vagrant up

5. SSH in:

$ vagrant ssh

6. Run a build (ssh puts you into the correct origin directory):

$ cd /data/src/github.com/openshift/origin
$ hack/build-go.sh

7. Start an OpenShift all-in-one server (includes everything you need to try OpenShift)

$ sudo systemctl start openshift

8. On your host system, try browsing to: https://localhost:8444

TIP: See https://github.com/openshift/vagrant-openshift for more advanced options

TIP: In some cases (eg. after git pull), you might run `make clean` in the `origin` directory to clean up outdated compiled files.

== Ensure virtual box interfaces are not managed by Network Manager

If you are developing on a Linux host, then you need to ensure that Network Manager is ignoring the
virtual box interfaces, otherwise they cause issues with multi-vm networking.

Follow these steps to ensure that virtual box interfaces are unmanaged:

1. Check the status of Network Manager devices:

$ nmcli d

2. If any devices whose name start with vboxnet* are not unmanaged, then they need to be added to
NetworkManager configuration to be ignored.

$ cat /etc/NetworkManager/NetworkManager.conf

[keyfile]
unmanaged-devices=mac:0a:00:27:00:00:00;mac:0a:00:27:00:00:01;mac:0a:00:27:00:00:02

3. One can use the following command to help generate the configuration:

$ ip link list | grep vboxnet -A 1 | grep link/ether | awk '{print "mac:" $2}' | paste -sd ";" -

== Development: What's on the Menu?
Right now you can see what's happening with OpenShift development at:

https://github.com/openshift/origin[github.com/openshift/origin]

Here's a quick summary of what we're doing there:

=== The OpenShift Origin Repo
This repo contains the OpenShift 3 https://www.youtube.com/watch?v=aZ40GobvA1c[Platform-as-a-Service], built on Kubernetes, along with some script-based examples of the +openshift+ utility in action. Kubernetes is included in this repo for ease of development, and the version we include is periodically updated. In the future it will be possible to run OpenShift on top of an existing system.

*Hacking OpenShift Origin:* +
To get started, https://help.github.com/articles/fork-a-repo[fork] the https://help.github.com/articles/fork-a-repo[origin repo] and then set up a local copy:

----
$ go get github.com/openshift/origin
$ cd $GOPATH/src/github.com/openshift/origin
$ git remote add <YOUR_GITHUB_USERNAME> git@github.com:<YOUR_GITHUB_USERNAME>/origin
----

From here, you can follow the https://github.com/openshift/origin/#getting-started[Getting Started section] of the README for a brief tour of OpenShift 3 functionality, which includes single and multi-container pod examples.

Ready to play with some code? Hop down and read up on our link:#_the_roadmap[roadmap] for ideas on where you can contribute.

*If you are interested in contributing to Kubernetes directly:* +
https://github.com/GoogleCloudPlatform/kubernetes#community-discussion-and-support[Join the Kubernetes community] and check out the https://github.com/GoogleCloudPlatform/kubernetes/blob/master/CONTRIBUTING.md[contributing guide].

=== Troubleshooting

If you run into difficulties running OpenShift, start by reading through the https://github.com/openshift/origin/blob/master/docs/debugging-openshift.md[troubleshooting guide].

=== The Roadmap
The OpenShift project roadmap lives https://trello.com/b/nlLwlKoz/openshift-origin-roadmap[on Trello]. Of particular interest to those who want to get involved with the OpenShift 3 architecture are the following topics:

* https://trello.com/c/uqNIamJi[Orchestration]
* https://trello.com/c/ja8bbQwy[Networking]
* https://trello.com/c/3zHeVSla[Routing and Load Balancing]

These link to active and backlog tasks that the OpenShift team is planning or working on for Kubernetes development.

== Stay in Touch
Reach out to the OpenShift team and other community contributors through IRC and our mailing list:

* IRC: Hop onto the http://webchat.freenode.net/?randomnick=1&channels=openshift-dev&uio=d4[#openshift-dev] channel on http://www.freenode.net/[FreeNode].
* E-mail: Join the OpenShift developers' http://lists.openshift.redhat.com/openshiftmm/listinfo/dev[mailing list].
25 changes: 25 additions & 0 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
#
# This is the unofficial OpenShift Origin image for the DockerHub. It has as its
# entrypoint the OpenShift all-in-one binary.
#
# See images/origin for the official release version of this image
#
# The standard name for this image is openshift/origin
#
FROM openshift/origin-base

RUN yum install -y golang && yum clean all

WORKDIR /go/src/github.com/openshift/origin
ADD . /go/src/github.com/openshift/origin
ENV GOPATH /go
ENV PATH $PATH:$GOROOT/bin:$GOPATH/bin

RUN go get github.com/openshift/origin && \
hack/build-go.sh && \
cp _output/local/go/bin/* /usr/bin/ && \
mkdir -p /var/lib/openshift

EXPOSE 8080 8443
WORKDIR /var/lib/openshift
ENTRYPOINT ["/usr/bin/openshift"]
Loading