1
0
mirror of https://github.com/openshift/installer.git synced 2026-02-05 15:47:14 +01:00
Commit Graph

119 Commits

Author SHA1 Message Date
OpenShift Merge Robot
edfc1a6da5 Merge pull request #5384 from flopotok/patch-1
Use neutral pronoun in doc.
2022-05-04 20:24:19 -04:00
staebler
0c85ff2a07 docs: update docs for maintaining embedded terraform binaries 2022-03-18 09:42:34 -04:00
staebler
bfa3cd984b doc: terraform maintenance document
Add a dev document for describing how to maintain the terraform
binaries embedded in the installer.
2022-03-02 21:10:29 -05:00
Saqib Ali
8bf1f6345b docs/dev/pinned-coreos.md: update rhcos-stream.json example
The file data/data/rhcos-stream.json was deleted in
d773ee5573
and the corresponding data now lives in data/data/coreos/rhcos.json. Let's update
the documentation to reflect this change.
2021-12-06 13:42:36 -05:00
OpenShift Merge Robot
3b7e9f4911 Merge pull request #4930 from timhansendev/feature/libvirt-add-load-balancer-docs
libvirt: add doc on a default load balancer configuration for libvirt
2021-12-02 18:14:49 +01:00
Flo
3080beed63 Use neutral pronoun. 2021-11-14 20:27:05 -05:00
Vladimir Belousov
51a40345a7 docs: correct spelling in docs
Correct spelling to improve the readability of the documentation
2021-11-01 09:54:42 +03:00
Colin Walters
d773ee5573 Remove old RHCOS and FCOS metadata (not stream metadata)
In https://github.com/openshift/enhancements/pull/679
we landed support for a stream metadata format already used
by FCOS and now by RHCOS/OCP consumers to find the bootimages.

We kept the old metadata because the UPI CI jobs used it.
In https://github.com/openshift/release/pull/17482 I tried
to port the UPI CI jobs, but ran into huge levels of technical debt.

As best I can tell, the UPI CI jobs are not running on this repo
now and are likely broken for other reasons.

Let's remove the old data and avoid the confusing duplication.
Anyone who goes to work on the UPI CI jobs and sanitizes things
should be able to pick up the work to port to stream metadata
relatively easily.
2021-10-21 17:09:06 -04:00
Benjamin Gilbert
256774ef01 docs/dev/pinned-coreos: pass --no-signatures to plume cosa2stream
Since we don't ship detached signatures, we're currently populating the
artifact signature fields with dead links.
2021-10-05 22:40:14 -04:00
Julian Wiedmann
bc3dee714a docs: libvirt: fix typo
s/resovectl/resolvectl

Signed-off-by: Julian Wiedmann <jwi@linux.ibm.com>
2021-09-27 15:53:05 +02:00
Rick
4399956ede Typo fixing from Github to GitHub 2021-09-11 00:03:59 +08:00
OpenShift Merge Robot
e7ac15d44e Merge pull request #5141 from rohantmp/brokenLink
docs: fix broken link to CVO/operators.md in operators.md
2021-09-06 12:12:46 +02:00
OpenShift Merge Robot
a80b1ff94c Merge pull request #5132 from cfergeau/libvirt-resolved
libvirt docs update when systemd-resolved is in use
2021-09-06 12:12:39 +02:00
Evgeny Slutsky
f821cbe00a Bump golang to version 1.16
Signed-off-by: Evgeny Slutsky <eslutsky@redhat.com>
2021-08-31 14:59:23 +03:00
Rohan CJ
4e491e392f docs: fix broken link to CVO/operators.md in operators.md
The link moved from the cluster-version-operator to the enhancements repo.

Signed-off-by: Rohan CJ <rohantmp@gmail.com>
2021-08-10 08:59:14 +05:30
Tim Hansen
529c8a78ae libvirt: add doc on a default load balancer configuration for libvirt
The installer for the development libvirt target does not launch a load balancer by default.
A default configuration of a basic HAProxy config is given here as a guideline for developers.

Signed-off-by: Tim Hansen <tihansen@redhat.com>
2021-08-09 09:18:35 -04:00
Tim Hansen
13d95bec67 docs: libvirt: Mention that resolvectl changes are not persistent 2021-08-04 11:21:26 +02:00
Kevin Wiesmueller
45db840972 docs: libvirt: Add systemd-resolved section
Signed-off-by: Kevin Wiesmueller <kwiesmul@redhat.com>
2021-08-04 11:19:08 +02:00
Jonathan Lebon
f9f3f67a4d hack/update-rhcos-bootimage.py: update RHCOS_RELEASES_APP
I think this was supposed to be part of #4928.

(cherry picked from commit f9165307f9)
2021-07-20 19:40:27 -04:00
Christy Norman
5b7d213390 fixing a link
Signed-off-by: Christy Norman <christy@linux.vnet.ibm.com>
2021-05-03 14:49:35 -05:00
Colin Walters
7a7b055d32 Add docs/dev/pinned-coreos.md
Briefly describe the history and future of the pinned {RHEL, Fedora} CoreOS
metadata in the installer.

Co-authored-by: Matthew Staebler <staebler@redhat.com>
2021-03-24 18:21:29 +00:00
staebler
d63debee34 * changed "start" and "end" phases to "service start" and "service end"
* add "pre-command start", "pre-command end", "post-command start" and "post-command end" phases
* fixed issue where the kubelet was not notifying systemd that it had started since it had been moved to a script
2021-03-12 18:19:38 -05:00
staebler
a35c8dda95 bootstrap: record progress of services
Each OpenShift service running on the bootstrap machine will now
create a json file in /var/log/openshift/ that contains an array
of entries detailing the progress that the service has made.

The entries included in the json file are the following.
* Service start
* Service end, with result and error details
* Service stage start
* Service stage end, with result and error details

The json files in /var/log/openshift will be collected by the
bootstrap gather in /bootstrap/services/ for evaluation by the
installer for improved failure reporting to the user. The evaluation
is left for follow-on work.

https://issues.redhat.com/browse/CORS-1542
https://issues.redhat.com/browse/CORS-1543
2021-03-11 21:00:46 -05:00
OpenShift Merge Robot
c6915a3337 Merge pull request #4623 from sallyom/libvirt-update-md
update iptables call with sudo
2021-02-16 14:45:28 -05:00
Sally O'Malley
8c4bc18be3 update iptables call with sudo 2021-02-06 08:45:36 -05:00
Prashanth Sundararaman
a6ef6c7d04 libvirt: support setting network dnsmasq options through the install config
Since libvirt 5.6.0, there is an option to pass in dnsmasq options through the libvirt network [1]. This addresses the following problems:

- eliminate the need for hacking routes in the cluster (the workaround mentioned in [3]) so that libvirt's dnsmasq does not manage the domain (and so the requests from inside the cluster will go up the chain to the host itself).
- eliminate the hacky workaround used in the multi-arch CI automation to inject `*.apps` entries in the libvirt network that point to a single worker node [2]. Instead of waiting for the libvirt networks to come up and update entries, we can set this before the installation itself through the install config.
- another issue this solves - with the above mentioned workaround, having multiple worker nodes becomes problematic when running upgrade tests. Having the route to just one worker node would fail the upgrade when that worker node is down. With this change, we could now point to the .1 address and have a load balancer forward traffic to any worker node.

With this change, the option can be specified through the install config yaml in the network section as pairs of option name and values. An example:
```
platform:
  libvirt:
    network:
      dnsmasqOptions:
      - name: "address"
        value: "/.apps.tt.testing/192.168.126.51"
      if: tt0
```
The terraform provider supports rendering these options through a datasource and injecting them into the network xml.
Since this config is optional, not specifying it will continue to work as before without issues.

[1] https://libvirt.org/formatnetwork.html#elementsNamespaces
[2] https://github.com/openshift/release/blob/master/ci-operator/templates/openshift/installer/cluster-launch-installer-remote-libvirt-e2e.yaml#L532-L554
[2] https://github.com/openshift/installer/issues/1007
2021-01-11 16:18:20 -05:00
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