1
0
mirror of https://github.com/openshift/installer.git synced 2026-02-06 00:48:45 +01:00
Commit Graph

82 Commits

Author SHA1 Message Date
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
Abhinav Dahiya
3d3649f414 docs: dns is required for libvirt clusters 2018-12-11 12:55:58 -08:00
staebler
31bd83fb4d docs: remove tectonic references from docs
Changes for https://jira.coreos.com/browse/CORS-878
2018-12-05 12:09:21 -05:00
OpenShift Merge Robot
8c504c011e Merge pull request #690 from xsgordon/install-qemu-kvm
Install qemu-kvm as part of Libvirt flow
2018-12-05 00:17:55 -08:00
OpenShift Merge Robot
71956aafde Merge pull request #663 from wking/openshift-pull-secret
*: Point at try.openshift.com for pull secrets
2018-12-01 08:25:00 -08:00
W. Trevor King
5051e46889 docs/dev/operators: Drop docs for the CVO approach
That approach should be documented in the CVO itself, since it's not
installer-specific and moving it gets the docs and implementation for
that approach into the same repository.  I've filed [1] to land
dynamic-object docs in the CVO repo (based on some of the content I'm
removing here).  Naming files, etc. are already covered by the
existing CVO documentation.

[1]: https://github.com/openshift/cluster-version-operator/pull/59
2018-11-26 22:27:49 -08:00
Stephen Gordon
23b3682c59 Install qemu-kvm as part of Libvirt flow
On RHEL (and IIRC Fedora as well) installing Libvirt doesn't actually
automatically mean you pulled in a hypervisor to actually run VMs on. As
a result you can encounter this error because qemu-kvm or equivalent is
not present:

    Could not find any guests for architecure type hvm/x86_64

To avoid this, explicitly install qemu-kvm (if qemu-kvm-rhev or
qemu-kvm-ev are available in the machine's yum/dnf configuration they
will automatically get pulled in instead). The other package needed is
libvirt-daemon-kvm.
2018-11-16 08:45:06 -05:00
W. Trevor King
ac11b74cc5 *: Drop tectonic-system namespace
The kube-addon operator was the last remaining component in that
namespace, and it was just controlling a metrics server.  Metrics
aren't critical to cluster functions, and dropping kube-addon means we
don't need the old pull secret anymore (although we will shortly need
new pull secrets for pulling private release images [1]).

Also drop the admin and user roles [2], although I'm less clear on
their connection.

[1]: https://github.com/openshift/installer/pull/663
[2]: https://github.com/openshift/installer/pull/682#issuecomment-439145907
2018-11-15 11:10:31 -08:00
W. Trevor King
7ad6d9ddd1 docs/dev/dependencies: Nest "Go" under "Build Dependencies"
This should have happened when "Build Dependencies" landed in 4278ba3f
(docs/libvirt-howto: Add dependency installation, 2018-09-24, #315).
2018-11-14 15:53:38 -08:00
W. Trevor King
393aeaf9ce docs/dev/libvirt: Update to {cluster-name}-master-0
Catching up with 18ca9128 (pkg/destroy/libvirt: Use prefix-based
deletion, 2018-11-12, #660).
2018-11-14 12:48:30 -08:00
Paul Morie
b6f9192658 Fix typo in libvirt instructions 2018-11-14 11:04:14 -05:00
W. Trevor King
449326d6d1 *: Point at try.openshift.com for pull secrets
The account.coreos.com reference was stale, and pull-secrets aren't
libvirt-specific, so I've dropped them from the libvirt docs entirely.

From Clayton, the flow for getting a pull secret will be:

1. Log in to try.openshift.com.
2. Accept the terms.
3. Get a pull secret you can download or copy/paste back into a local
   file.

Podman doesn't really come into it.  Currently the secret you get
there looks like:

  $ cat ~/.personal/pull-secret.json
  {
    "auths": {
      "cloud.openshift.com": {"auth": "...", "email": "..."},
      "quay.io": {"auth": "...", "email": "..."}
    }
  }

Besides pulling images, the secret may also be used to authenticate to
other services (e.g. telemetry) on hosts that do not contain image
registries, which is more reason to decouple this from Podman.
2018-11-13 10:17:14 -08:00