A service for managing and provisioning Bare Metal servers.
Find a file
Steve Baker 28168c4168 Add a kubernetes provider for console container
A new ``ironic.console.container`` provider is added called
``kubernetes`` which allows Ironic conductor to manage console
containers as Kubernetes pods. The kubernetes resources are defined in
the template file configured by ``[vnc]kubernetes_container_template``
and the default template creates one secret to store the app info, and
one pod to run the console container.

It is expected that Ironic conductor is deployed inside the kubernetes
cluster. The associated service account will need roles and bindings
which allow it to manage the required resources (with the default
template this will be secrets and pods).

This provider holds the assumption that ironic-novnc will be deployed in
the same kubernetes cluster, and so can connect to the VNC servers via
the pod's ``status.hostIP``.

Assisted-By: gemini
Change-Id: Ib91f7d7c15be51d68ebf886e44efaf191a14437b
Signed-off-by: Steve Baker <sbaker@redhat.com>
2025-12-04 11:25:05 -08:00
api-ref Add a new 'category' field to the Portgroup object 2025-11-04 12:44:01 -08:00
devstack Switch graphical console image to ubuntu by default 2025-12-04 11:24:43 -08:00
doc Add a kubernetes provider for console container 2025-12-04 11:25:05 -08:00
etc/ironic Drop wsgi script, docs around mod_wsgi 2025-08-26 21:10:01 +00:00
ironic Add a kubernetes provider for console container 2025-12-04 11:25:05 -08:00
playbooks Run metal3 integration job using UEFI boot (default) 2025-10-24 10:45:41 +02:00
redfish-interop-profiles Update the redfish interoperability profile 2024-06-27 16:24:24 +02:00
releasenotes Add a kubernetes provider for console container 2025-12-04 11:25:05 -08:00
tools Switch graphical console image to ubuntu by default 2025-12-04 11:24:43 -08:00
zuul.d Merge "Fixes for console containers functional testing" 2025-11-04 11:28:41 +00:00
.coveragerc Use .coveragerc file 2024-02-02 23:17:12 +09:00
.gitignore Render the redfish interop profile in the docs 2024-06-27 16:32:28 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:40:53 +00:00
.mailmap Add my new address to .mailmap 2020-04-13 07:29:37 -07:00
.pre-commit-config.yaml enable ruff in pre-commit with some initial lints 2024-12-16 09:07:39 -06:00
.stestr.conf Migrate to stestr as unit tests runner 2017-09-22 08:56:34 +00:00
bindep.txt Always rebuild sphinx env on doc build 2025-08-15 10:56:13 +12:00
CONTRIBUTING.rst Project Contributing updates for Goal 2020-02-20 02:01:21 +00:00
driver-requirements.txt Remove sushy-oem-idrac from driver requirements 2025-10-28 17:26:28 +01:00
LICENSE Added project infrastructure needs. 2013-05-02 14:55:43 -04:00
pyproject.toml Add a kubernetes provider for console container 2025-12-04 11:25:05 -08:00
README.rst Remove tags from README 2025-05-05 22:35:29 +00:00
requirements.txt Revert "Switch from local RPC to automated JSON RPC on localhost" 2025-08-28 17:10:25 +02:00
setup.cfg Migrate setup configuration to pyproject.toml 2025-09-22 11:46:52 +01:00
setup.py add pyproject.toml to support pip 23.1 2024-11-05 08:00:24 -06:00
test-requirements.txt Drop direct dependency on iso8601 2025-03-01 06:06:01 +00:00
tox.ini Add hacking check to ban eventlet imports 2025-08-28 11:30:57 +02:00

======
Ironic
======

.. image:: https://governance.openstack.org/tc/badges/ironic.svg

Overview
--------

Ironic consists of an API and plug-ins for managing and provisioning
physical machines in a security-aware and fault-tolerant manner. It can be
used with nova as a hypervisor driver, or standalone service using bifrost.
By default, it will use PXE and IPMI to interact with bare metal machines.
Ironic also supports vendor-specific plug-ins which may implement additional
functionality.

Ironic is distributed under the terms of the Apache License, Version 2.0. The
full terms and conditions of this license are detailed in the LICENSE file.

Project resources
~~~~~~~~~~~~~~~~~

* Documentation: https://docs.openstack.org/ironic/latest
* Source: https://opendev.org/openstack/ironic
* Bugs: https://bugs.launchpad.net/ironic/+bugs
* Wiki: https://wiki.openstack.org/wiki/Ironic
* APIs: https://docs.openstack.org/api-ref/baremetal/index.html
* Release Notes: https://docs.openstack.org/releasenotes/ironic/
* Design Specifications: https://specs.openstack.org/openstack/ironic-specs/

Project status, bugs, and requests for feature enhancements (RFEs) are tracked
in Launchpad:
https://launchpad.net/ironic

For information on how to contribute to ironic, see
https://docs.openstack.org/ironic/latest/contributor