1
0
mirror of https://github.com/openshift/installer.git synced 2026-02-07 03:47:13 +01:00
Commit Graph

93 Commits

Author SHA1 Message Date
Abhinav Dahiya
46a5f49709 bump the minimum version for building installer to go 1.14
With Go 1.14 the handling of modules has improved in the sense that all the subcommands `go {test, generate}` now use the vendor when available by default. This makes it easier for us to run generate using the vendored tools like controller-tools etc. as it now uses the checked in vendor.
2020-07-06 12:19:20 -07:00
Timothée Ravier
5d7e32fa76 docs/dev/libvirt: update libvirt TCP socket setup instructions 2020-06-15 11:20:16 +02:00
Timothée Ravier
64260733c5 docs/dev/libvirt: update firewalld setup instructions 2020-06-15 11:20:16 +02:00
Timothée Ravier
c91e2b1002 docs/dev/libvirt: minor Markdown styling fixes 2020-06-15 11:20:16 +02:00
Daniel P. Berrangé
5253966181 docs: the --listen arg to libvirtd is obsolete with socket activation
In newer libvirtd that ships the "libvirt-tcp.socket" unit files for
socket activation, the --listen argument to libvirtd should not be
used. Enabling both socket activation and the --listen argument will
cause libvirtd to exit with an error about mutually exclusive
configuration options.

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2020-05-22 10:08:45 +01:00
Daniel P. Berrangé
b671ce60b5 docs: add stronger warning about impact of disabling auth in libvirtd
A connection to libvirtd gives the client application privileges that
are equivalent to those of a root shell. IOW, disabling authentication
and encryption in libvirtd is akin to running a telnet server with no
root password. This implication is not obvious to users following the
guide, so should be spelt out explicitly, so they understand it is
critical to correctly apply the firewall rules listed later in the
install guide.

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2020-05-22 10:08:45 +01:00
Daniel P. Berrangé
3170204e00 docs: simplify libvirt install package set
The "libvirt" RPM is a meta package which depends on every single other
libvirt RPM. It is undesirable to install this because it pulls in a
huge chain of dependencies, which are irrelevant for accomplishing the
steps described in this document. The main interesting thing it was
likely needed for is the "virsh" client, and can thus be replaced by
the "libvirt-client" RPM

The "libvirt-daemon-kvm" RPM pulls in everything needed for a typical
libvirt installation that will be used for running KVM guests, and is
the recommended option for scenarios that don't need to go to extreme
to minimize features installed.

The "qemu-kvm" RPM does not need to be listed explicitly, since it is
already a dependancy of "libvirt-daemon-kvm".

Further information to help understand the libvirt RPM choices is
present at https://libvirt.org/kbase/rpm-deployment.html

Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
2020-05-22 10:08:39 +01:00
OpenShift Merge Robot
a1a6300d58 Merge pull request #3537 from tkashem/kube-apiserver-health-check
load balancer health check for kube-apiserver
2020-05-12 10:24:54 -07:00
Abu Kashem
dcd415c573 load balancer health check for kube-apiserver 2020-05-11 15:36:26 -04:00
Abhinav Dahiya
165653297b docs/dev: add guidelines for maintaining explain 2020-05-07 09:22:31 -07:00
Stephen Cuppett
affba545d7 RFE-592: Tightening IAM roles for master/worker nodes to match cloud-provider-aws requirements
https://github.com/kubernetes/cloud-provider-aws#readme
2020-04-14 15:45:46 -04:00
Mike Fedosin
26a522adfa OpenStack: Update documentation for custom os image urls 2020-03-26 22:26:26 +01:00
Christian Glombek
947795d5f3 docs: Update dependencies.md 2020-02-14 00:08:39 +01:00
Mike Fedosin
2f6af2544a Document RHCOS image customizations for developers 2020-01-27 21:31:49 +01:00
Robert Krawitz
ae80a11d01 Update instructions for Fedora 31 for libvirt 2019-11-21 10:47:27 -05:00
Chris Suszyński
64b61348b5 Adding docs on running via libvirt on Dobian/Ubuntu
Issue: https://github.com/code-ready/snc/issues/112 have been raised. It
is for permission denied errors that was caused by selinux. Selinux
isn't available on Debian/Ubuntu, and should be disabled in `qemu.conf`.
2019-10-21 15:46:19 +02:00
W. Trevor King
a947609d66 docs/user: Standardize install-config property documentation
This is a bit more accessible than pointing folks at Godocs, since it
allows us to focus on the YAML property names (while Godocs
understandably focus on Go property names) and YAML renderings.  Also
break up our old "one big example" install-config.yaml into a minimal
per-platform example and a series of small extentions excercising
groups of properties.

The vSphere docs are based heavily on [1].

Also drop proxy.md.  It was added in e7edbf71fd (Add proxy
configuration to bootstrap node, 2019-06-24, #1832), but:

* Proxy testing and Squid configuration information belongs in
  openshift/release, not in the installer repository.
* docs/user/customization.md now contains a more complete proxy-config
  fragment.

OpenStack computeFlavor precedence is based on [2].

[1]: https://github.com/openshift/openshift-docs/blob/enterprise-4.2/modules/installation-vsphere-config-yaml.adoc
     Last touched by commit openshift/openshift-docs@25afc7626d , 2019-08-19
[2]: https://github.com/openshift/installer/pull/2162#discussion_r322410878
2019-09-09 12:37:28 -07:00
Robert Fairley
b150e435ec docs/dev/libvirt: update links in customizing install note
Fix relative links for the new directory layout.
2019-09-04 14:43:06 -04:00
Eduardo Minguez Perez
540e768e93 Started customization libvirt doc wit tt0
Fixes #708
2019-07-23 16:17:30 +02:00
Abhinav Dahiya
615ab8d658 docs: update the imagecontentsource policy to match new icsp
ImageContentSourcePolicy object was updated 7076b89b19
2019-07-18 12:43:10 -07:00
Patrick Dillon
a7ebcc4fb4 Update docs for release mirrors.
Minor corrections to comments and developer reference docs related to the oc adm release mirrors.
2019-07-16 20:37:18 -04:00
OpenShift Merge Robot
1679af70d7 Merge pull request #1910 from abhinavdahiya/release_image_sources
Add capabiltity to specify sources for release image content
2019-07-17 00:57:36 +02:00
Abhinav Dahiya
17f2f25f36 docs/dev: add details for the sources for release-image
The documents outlines the proposal and details for using alternate source/repositories for release-image.
The proposal is driven by the fact that, only flows using the `oc adm release mirror` to create the alternate sources for release-image will be supported.
2019-07-16 09:04:37 -07:00
Zeeshan Ali
cfcd2f4eab docs,libvirt: Drop storage pool related info
Installer now manages and uses its own storage pool so this info is now
redundant.
2019-07-10 16:23:36 +02:00
Joseph Callen
e7edbf71fd Add proxy configuration to bootstrap node
Modification of `bootstrapTemplateData` struct to include proxy requirements.
Modification of `getTemplateData` and `addStorageFiles` to support proxy
Modification of proxy manifests

Added:
- /etc/profile.d/proxy.sh.template
- /etc/systemd/system.conf.d/10-default-env.conf.template
2019-06-24 15:49:29 -04:00
Zeeshan Ali
b785c6ece8 libvirt,docs: Make console workaround a bit easier
Instead of telling what the content of a manifest should be like, provide
a command to modify it as needed.
2019-06-11 16:55:04 +02:00
OpenShift Merge Robot
85323d6d23 Merge pull request #1776 from cfergeau/docs
Doc changes for libvirt backend
2019-05-23 15:27:13 +02:00
Christophe Fergeau
be4e24a122 docs/libvirt: Rework firewalld section
There are some significant firewalld zone differences between Fedora
Workstation and RHEL8. This commit takes this into account, and adjusts
the Fedora instructions so that the libvirt port does not get exposed
externally.
2019-05-22 09:27:21 +02:00
Christophe Fergeau
869f9e9248 docs/libvirt: Remove policykit configuration
Since by default the installer uses qemu+tcp://192.168.122.1 and we
document to disable auth on tcp connections, the policykit step is not
required for the installer.

Signed-off-by: Christophe Fergeau <cfergeau@redhat.com>
2019-05-22 09:27:13 +02:00
Christophe Fergeau
5dc17caee4 docs/libvirt: Use 192.168.122.0 as default subnet
Commit 30b1ae8e4 changed the subnet the cluster will use from
192.168.124.0 to 192.168.126.0. However, it also changed mentions of the default
libvirt from 192.168.122.0 to 192.168.124.0.
This commit revert the last part of the change as 192.168.122.0 is more
likely to be used as it's the upstream libvirt default.

Signed-off-by: Christophe Fergeau <cfergeau@redhat.com>
2019-05-22 09:27:04 +02:00
Praveen Kumar
90b0d4558e docs/dev/libvirt/README.md: Add troubleshooting docs for libvirt console issue.
Currently cluster created by libvirt not able to resolve the auth route
and because of that console doesn't comeup. This troubleshooting doc entry
direct users to make some modification before running the cluster so that
auth route can be resolved by the cluster. Fix #1007
2019-05-06 15:37:20 +05:30
Patrick Dillon
12ec7e0c6f Fix broken link in libvirt doc. 2019-05-02 16:42:38 -04:00
OpenShift Merge Robot
f55b4f259b Merge pull request #1675 from vbatts/broken_links
libvirt/README: fix broken links due to doc move
2019-04-26 23:46:39 -07:00
Vincent Batts
dfcd3ac5ad libvirt/README: fix broken links due to doc move
Signed-off-by: Vincent Batts <vbatts@hashbangbash.com>
2019-04-25 08:43:35 -04:00
Zeeshan Ali
360b5781b6 OWNERS: Setup ownership of libvirt code
This is to give ownership of libvirt backend of Installer to CRC team. For
now I've only added two members from CRC team (myself and Praveen). I also
added two members of Installer team who seem to have been the most active
devs developing the relevant code.

We don't add `libvirt-approvers` for `pkg/types/libvirt`. For reasons:

https://github.com/openshift/installer/pull/1662#issuecomment-485895942
2019-04-24 12:19:18 +02:00
W. Trevor King
5ec2433025 docs: Stronger per-platform isolation
Punt per-platform docs down into platform-specific subdirectories so
we can apply platform-specific OWNERS files.
2019-04-10 12:41:01 -07:00
Martin André
c9f5931bcb openstack: update URL for ocp-doit
The ocp-doit repository is now maintained in the shiftstack-dev-tools
github organization.
2019-03-28 21:11:25 +01:00
Zeeshan Ali
71cb6482d2 libvirt-howto: Less intrusive NetworkManager setup
Instead of modifying the main NetworkManager configuration, let's add a
separate configuration file for our purposes.

Based on a patch from Colin Walters <walters@verbum.org>
2019-02-14 15:56:13 +01:00
Russell Bryant
63589e8d94 libvirt-howto: Add note about CentOS kvm-common repo.
Add a note to the dev libvirt-howto about the kvm-common repository
that's required to get a new enough version of qemu-kvm.
2019-01-25 16:49:00 -05:00
liangxia
4861d3903f Fix several typo 2019-01-17 17:29:22 +08:00
OpenShift Merge Robot
3bba60febc Merge pull request #952 from dcbw/nm-dns-hup
libvirt-howto: reload NetworkManager for dns configuration changes
2019-01-04 12:22:27 -08:00
Dan Williams
a04ca813f8 libvirt-howto: reload NetworkManager for dns configuration changes
NM has been able to switch DNS plugins on the fly for years.
2019-01-03 12:06:31 -06:00
W. Trevor King
432f28355a *: Make libvirt support completely conditional (behind TAGS=libvirt)
Previously, destroy support was behind TAGS=libvirt_destroy and create
support was always built in.  But since 3fb4400c (terraform/plugins:
add `libvirt`, `aws`, `ignition`, `openstack` to KnownPlugins,
2018-12-14, #919), the bundled libvirt Terraform provider has also
been behind libvirt_destroy.  That leads to cluster creation failing
with:

  $ openshift-install create cluster
  ...
  ERROR Missing required providers.
  ERROR
  ERROR The following provider constraints are not met by the currently-installed
  ERROR provider plugins:
  ERROR
  ERROR * libvirt (any version)
  ERROR
  ERROR Terraform can automatically download and install plugins to meet the given
  ERROR constraints, but this step was skipped due to the use of -get-plugins=false
  ERROR and/or -plugin-dir on the command line.
  ...

With this commit, folks trying to 'create cluster' without libvirt
compiled in will get:

  FATAL failed to fetch Common Manifests: failed to load asset "Install Config": invalid "install-config.yaml" file: platform: Invalid value: types.Platform{AWS:(*aws.Platform)(nil), Libvirt:(*libvirt.Platform)(0xc4209511f0), OpenStack:(*openstack.Platform)(nil)}: platform must be one of: aws, openstack

before we get to Terraform.

Now that the build tag guards both creation and deletion, I've renamed
it from 'libvirt_destroy' to the unqualified 'libvirt'.

I've also adjusted the install-config validation testing to use
regular expressions so we can distinguish between failures because
libvirt was not compiled in as a valid platform and failures because
some portion of the libvirt configuration was broken.  In order to get
stable error messages for comparison, I've added some strings.Sort
calls for various allowed-value string-slice computations.
2018-12-21 13:09:29 -08:00
Abhinav Dahiya
cef24b69eb docs: remove sections that ask to install libvirt plugins 2018-12-18 11:23:24 -08:00
OpenShift Merge Robot
e86e78b855 Merge pull request #913 from ivuk/fix-typo
Fix a typo in libvirt-howto.md
2018-12-14 14:13:34 -08:00
Abhinav Dahiya
a93818e9a9 docs: include dep version command in Go section 2018-12-14 09:59:38 -08:00
Igor Vuk
d9c7560b24 Fix a typo in libvirt-howto.md 2018-12-14 18:51:18 +01:00
Russell Bryant
8f282a4a44 openstack: Add OpenStack docs.
Document current requirements and expected behavior of OpenStack support.  Also
create a dev doc that points to how to set up a dev env.
2018-12-14 13:55:45 +00:00
W. Trevor King
6e08cdcaa0 docs: Drop 'OPENSHIFT_INSTALL_' prefix
The long forms are less likely to exist in the user's environment
since 6be4c253 (*: remove support for environment variables,
2018-12-10, #861), and we no longer need the context to distinguish
from all the other environment variables on a user's system.
2018-12-12 20:50:20 -08:00
Alex Crawford
6be4c253e4 *: remove support for environment variables
The environment variables were originally added to make CI testing a
little easier, since the installer didn't support consumption of
provided assets (e.g. the install config). Now that the installer
supports consumption, there is no need for most of the environment
variables anymore. The variables have actually been confusing to users,
so their removal should simplify the mental model.
2018-12-11 15:00:43 -08:00