Skip to content

Commit bd0fd24

Browse files
naveenkandakurnaveenkandakur
authored
Merge pull request #133 from ansible-hmc-org/dev-collection
December-2024 release content for version 1.11.0
2 parents 7e2e2c0 + 16f6531 commit bd0fd24

35 files changed

+2800
-208
lines changed

‎.github/workflows/doc-publish.yaml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ jobs:
1313
# generate doc files
1414
########################################################################
1515
gen-doc:
16-
runs-on: ubuntu-latest
16+
runs-on: ubuntu-22.04
1717
strategy:
1818
fail-fast: false
1919
matrix:
@@ -44,7 +44,7 @@ jobs:
4444
path: ./docs/build
4545

4646
deploy-doc:
47-
runs-on: ubuntu-latest
47+
runs-on: ubuntu-22.04
4848
needs: gen-doc
4949
environment:
5050
name: github-pages

‎.github/workflows/linting.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ on:
1414

1515
jobs:
1616
module-linting-test:
17-
runs-on: ubuntu-latest
17+
runs-on: ubuntu-22.04
1818
strategy:
1919
matrix:
2020
python-version: ['3.10', '3.11']

‎.github/workflows/unit-tests.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ on:
1414

1515
jobs:
1616
unit-test:
17-
runs-on: ubuntu-latest
17+
runs-on: ubuntu-22.04
1818
strategy:
1919
matrix:
2020
python-version: ['3.7']

‎devops/bin/gen_doc.sh‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,15 +16,28 @@ trap 'err_report "$BASH_COMMAND" $? $LINENO' ERR
1616
DIR="$(pwd)"
1717
MODULE_DIR="$DIR/plugins/modules"
1818
INV_PLUGIN_DIR="$DIR/plugins/inventory"
19+
ROLE_DIR="$DIR/roles"
20+
ROLE_LIST=`ls -1 $ROLE_DIR`
1921
DOC_SRC_DIR="$DIR/docs/source"
2022
DOC_BLD_DIR="$DIR/docs/build"
2123

2224
#ansible-doc-extractor --template $DOC_TEMPLATE $DOC_SRC_DIR $MODULE_DIR/*.py
2325
[[ ! -d "$DOC_SRC_DIR"/modules ]] && mkdir -p "$DOC_SRC_DIR"/modules && mkdir -p "$DOC_SRC_DIR"/plugins
26+
[[ ! -d "$DOC_SRC_DIR"/roles ]] && mkdir -p "$DOC_SRC_DIR"/roles
2427
[[ ! -d "$DOC_BLD_DIR" ]] && mkdir -p "$DOC_BLD_DIR"
28+
29+
# generate the updated role documentations
30+
for role in $ROLE_LIST
31+
do
32+
cp $ROLE_DIR/$role/README.rst $DOC_SRC_DIR/roles/$role.rst
33+
done
2534
ansible-doc-extractor "$DOC_SRC_DIR"/modules "$MODULE_DIR"/*.py
2635
ansible-doc-extractor "$DOC_SRC_DIR"/plugins "$INV_PLUGIN_DIR"/*.py
27-
sphinx-build -b html "$DOC_SRC_DIR" "$DOC_BLD_DIR"
36+
37+
38+
# create the html files
39+
sphinx-build -b html $DOC_SRC_DIR $DOC_BLD_DIR
40+
2841
ls "$DOC_BLD_DIR"
2942
touch "$DOC_BLD_DIR"/.nojekyll
3043

‎docs/Makefile‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,3 +11,4 @@ all:
1111
clean:
1212
rm -rf build
1313
rm -rf source/modules/*.rst
14+
rm -rf source/roles/*.md

‎docs/source/index.rst‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,13 +58,14 @@ This Ansible collection is maintained by the IBM Power HMC development team.
5858
quickstart
5959

6060
.. toctree::
61-
:maxdepth: 3
61+
:maxdepth: 4
6262
:caption: References
6363
:hidden:
6464

6565
modules
6666
plugins
6767
playbooks
68+
roles
6869
demo
6970

7071
.. toctree::

‎docs/source/release_notes.rst‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -264,3 +264,24 @@ Notes
264264

265265
.. _GitHub v1.10.0:
266266
https://github.com/IBM/ansible-power-hmc/releases/download/v1.10.0/ibm-power_hmc-1.10.0.tar.gz
267+
268+
Version 1.11.0
269+
-------------
270+
Notes
271+
* vios: Support for VIOS install through HMC local disk
272+
* vios: Support for VIOS image copy, delete and list from HMC
273+
* vios_update_upgrade: Support for VIOS update and upgrade (Issue: #104)
274+
* power_system: Support for PCM status listing (Issue: #136)
275+
* hmc_update_upgrade: Fix for list ptf failing for fully patched HMC (Issue: #130)
276+
* Introduced a role for password policy management
277+
* MTMS Support for all the modules
278+
279+
Availability
280+
* `Galaxy v1.11.0`_
281+
* `GitHub v1.11.0`_
282+
283+
.. _Galaxy v1.11.0:
284+
https://galaxy.ansible.com/download/ibm-power_hmc-1.11.0.tar.gz
285+
286+
.. _GitHub v1.11.0:
287+
https://github.com/IBM/ansible-power-hmc/releases/download/v1.11.0/ibm-power_hmc-1.11.0.tar.gz

‎docs/source/roles.rst‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
.. ...........................................................................
2+
.. © Copyright IBM Corporation 2024 .
3+
.. ...........................................................................
4+
5+
Roles
6+
=======
7+
8+
The **IBM Power Systems HMC collection** contains roles that can be used in a playbook
9+
to automate tasks on HMC. Ansible executes each tasks on the target node and
10+
returns the result back to the controller. While different roles perform
11+
different tasks, their interfaces and responses follow similar patterns.
12+
13+
Role reference
14+
----------------
15+
16+
Reference material for each role contains documentation on the accepted
17+
parameters and their expected values.
18+
19+
20+
.. toctree::
21+
:maxdepth: 1
22+
:caption: Contents
23+
:glob:
24+
25+
roles/*

‎galaxy.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ namespace: ibm
77
name: power_hmc
88

99
# The version of the collection. Must be compatible with semantic versioning
10-
version: 1.10.0
10+
version: 1.11.0
1111

1212

1313
# The path to the Markdown (.md) readme file. This path is relative to the root of the collection

‎playbooks/demo_copy_and_install_vios.yml‎

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
---
2+
- name: Install the VIOS version 3.1.0.10 after copying the image from remote server to Power HMC disk
3+
hosts: hmcs
4+
connection: local
5+
vars:
6+
curr_hmc_auth:
7+
username: hscroot
8+
password: !vault |
9+
$ANSIBLE_VAULT;1.1;AES256
10+
34656335616165343966323739633761653065346138623233633764353636373063313736373563
11+
6130373162376464666634363734303164396364656535350a663661636663323434386466383634
12+
63323432303833643864396130393133346666336661346432356433353035663038643833373332
13+
3664333762656138640a306539363765343261383363346532643639383938656434333564323139
14+
6365
15+
16+
tasks:
17+
- name: Copy vios installation image of 3.1.0.10 version from sftp location to HMC disk
18+
ibm.power_hmc.vios:
19+
hmc_host: '{{ inventory_hostname }}'
20+
hmc_auth: "{{ curr_hmc_auth }}"
21+
media: sftp
22+
directory_name: "vios_3.1.0.10"
23+
remote_server: <sftp_server_ip>
24+
sftp_auth:
25+
username: sftp_username
26+
password: sftp_password
27+
remote_directory: /home/hmcct/
28+
files:
29+
- flash.iso
30+
action: copy
31+
register: testout
32+
33+
- name: Stdout the result of copy
34+
ansible.builtin.debug:
35+
msg: '{{ testout }}'
36+
37+
- name: Install the VIOS using image available in disk for 3.1.0.10 version
38+
ibm.power_hmc.vios:
39+
hmc_host: '{{ inventory_hostname }}'
40+
hmc_auth: '{{ curr_hmc_auth }}'
41+
system_name: <system-name>
42+
vios_IP: <vios_ip>
43+
name: <vios-name>
44+
image_dir: "vios_3.1.0.10"
45+
vios_iso: dvdimage.v1.iso
46+
vios_gateway: <gateway_ip>
47+
vios_subnetmask: <subnetmask_ip>
48+
network_macaddr: <mac_address>
49+
action: install
50+
register: output
51+
52+
- name: Stdout the result of installation through disk
53+
ansible.builtin.debug:
54+
msg: '{{ output }}'

0 commit comments

Comments
 (0)