| Server IP : 3.96.16.70 / Your IP : 216.73.216.15 Web Server : Apache System : Linux ip-172-31-26-103.ca-central-1.compute.internal 6.1.163-186.299.amzn2023.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Feb 24 16:35:42 UTC 2026 x86_64 User : ec2-user ( 1000) PHP Version : 8.4.18 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /lib/python3.9/site-packages/cloudinit/cmd/__pycache__/ |
Upload File : |
a
�½b�) � @ s� d Z ddlZddlZddlZddlmZ ddlmZmZ ddl m
Z
m Z ddl m
Z
mZmZ ddlmZmZmZ dZe�e�Zdd d
�Zd d � Zed
�dd�Zeeee d�dd�Z dd� Z dd� Z e dkr�e � dS )aT Query standardized instance metadata provided to machine, returning a JSON
structure.
Some instance-data values may be binary on some platforms, such as userdata and
vendordata. Attempt to decompress and decode UTF-8 any binary values.
Any binary values in the instance metadata will be base64-encoded and prefixed
with "ci-b64:" in the output. userdata and, where applicable, vendordata may
be provided to the machine gzip-compressed (and therefore as binary data).
query will attempt to decompress these to a string before emitting the JSON
output; if this fails, they are treated as binary.
� N)�EACCES)�log�util)�addLogHandlerCLI�read_cfg_paths)�convert_jinja_instance_data�get_jinja_variable_alias�render_jinja_payload)�INSTANCE_JSON_FILE� INSTANCE_JSON_SENSITIVE_FILE�REDACT_SENSITIVE_VALUE�queryc C s� | st jttd�} | jdddddd� | jdd td
t d � | jd d
dddd� | jddtdd � | jddtdd � | jdtddd� | jdddddd d � | jd d td d!d"� | S )#a# Build or extend an arg parser for query utility.
@param parser: Optional existing ArgumentParser instance representing the
query subcommand which will be extended to support the args of
this utility.
@returns: ArgumentParser with proper argument configuration.
)�prog� descriptionz-dz--debug�
store_trueFz+Add verbose messages during template render)�action�default�helpz-iz--instance-dataz>Path to instance-data.json file. Default is /run/cloud-init/%s)�typer z-lz --list-keyszBList query keys available at the provided instance-data <varname>.z-uz --user-datazHPath to user-data file. Default is /var/lib/cloud/instance/user-data.txtz-vz
--vendor-datazLPath to vendor-data file. Default is /var/lib/cloud/instance/vendor-data.txt�varname�?z�A dot-delimited specific variable to query from instance-data. For example: v1.local_hostname. If the value is not JSON serializable, it will be base64-encoded and will contain the prefix "ci-b64:". )r �nargsr z-az--all�dump_allz Dump all available instance-data)r r �destr z-fz--format�formatz�Optionally specify a custom output format string. Any instance-data variable can be specified between double-curly braces. For example -f "{{ v2.cloud_name }}")r r r )�argparse�ArgumentParser�NAME�__doc__� add_argument�strr
��parser� r# �7/usr/lib/python3.9/site-packages/cloudinit/cmd/query.py�
get_parser( st ����
� � � �� r% c C sB t j| dd�}z |�d�W S ty< t j|ddd� Y S 0 dS )z�Attempt to return a string of user-data from ud_file_path
Attempt to decode or decompress if needed.
If unable to decode the content, raw bytes will be returned.
@returns: String of uncompressed userdata if possible, otherwise bytes.
F)�decodezutf-8T)�quietr& N)r � load_filer& �UnicodeDecodeErrorZ decomp_gzip)Z ud_file_pathZbdatar# r# r$ �
load_userdata~ s
r* )�returnc
C sb d}t �� }t| ||g�s t� }| r*| }nRt j�|jt�}|dkrxt j�|jt�}t j� |�rd|}q|t
� d||� |}n|}|r�|}nt j�|j d�}|r�|} nt j�|j d�} zt
�|�}
W nP ttf�y } z2| jtkr�t
�d|� n t
�d|� � W Y d} ~ n
d} ~ 0 0 t
�|
�} |dk�rFdt|f | d < dt| f | d
< nt|�| d < t| �| d
< | S ) a� Return a dict of merged instance-data, vendordata and userdata.
The dict will contain supplemental userdata and vendordata keys sourced
from default user-data and vendor-data files.
Non-root users will have redacted INSTANCE_JSON_FILE content and redacted
vendordata and userdata values.
:raise: IOError/OSError on absence of instance-data.json file or invalid
access perms.
Nr z4Missing root-readable %s. Using redacted %s instead.z
user-data.txtzvendor-data.txtz$No read permission on '%s'. Try sudoz Missing instance-data file: %sz <%s> file:%sZuserdataZ
vendordata)�os�getuid�allr �path�joinZrun_dirr
r �exists�LOGZwarningZ
instance_linkr r( �IOError�OSError�errnor �errorZ load_jsonr r* ) �
instance_data� user_data� vendor_data�pathsZuidZinstance_data_fnZredacted_data_fnZsensitive_data_fnZ user_data_fnZvendor_data_fnZ
instance_json�er# r# r$ �_read_instance_data� s\ � �
�
� r< ��jinja_vars_without_aliases�jinja_vars_with_aliasesr � list_keysc
C s� d}| }|� d�D ]�}z || }W nL tyn } z4|rFdj||d�}n
d�|�}t|�|�W Y d}~n
d}~0 0 ||v r�|| }n"|D ] } t| �|kr�|| } q�q�|r�|d7 }||7 }q|S )a� Return the value of the dot-delimited varname path in instance-data
Split a dot-delimited jinja variable name path into components, walk the
path components into the instance_data and look up a matching jinja
variable name or cloud-init's underscore-delimited key aliases.
:raises: ValueError when varname represents an invalid key name or path or
if list-keys is provided by varname isn't a dict object.
� �.z*instance-data '{key_path}' has no '{leaf}')ZleafZkey_pathz Undefined instance-data key '{}'N)�split�KeyErrorr �
ValueErrorr )
r> r? r r@ Zwalked_key_path�responseZ
key_path_partr; �msg�keyr# r# r$ �(_find_instance_data_leaf_by_varname_path� s, �
rI c
C s� t t|jrtjntj� t|j|j|j |j
g�sHt� d� t � �
� dS zt|j|j|j�}W n ttfyv Y dS 0 |j r�dj |j d�}t|d||jr�dndd�}|r�t|� d S dS t|�}|j�r&t|dd
�}zt|||j|jd �}W n6 ttf�y$ } zt� |� W Y d }~dS d }~0 0 |j�r^t|t��sLt� d
|j� dS d� t |� � ��}t|t ��stt �!|�}t|� d S )z3Handle calls to 'cloud-init query' as a subcommand.zDExpected one of the options: --all, --format, --list-keys or varname� z## template: jinja
{fmt})�fmtzquery commandlineTF)�payloadZ
payload_fnr7 �debugr )Zinclude_key_aliasesr= Nz+--list-keys provided but '%s' is not a dict�
)"r r2 rM r �DEBUGZWARNING�anyr@ r r r r6 r% Z
print_helpr< r7 r8 r9 r3 r4 r �printr rI rD rE �
isinstance�dictr0 �sorted�keysr r Z
json_dumps)�name�argsr7 rL Zrendered_payloadrF r? r; r# r# r$ � handle_args� sf �
� ���
�
rX c C s t � } t�tt| �� �� dS )z,Tool to query specific instance-data values.N)r% �sys�exitrX r �
parse_argsr! r# r# r$ �main: s r\ �__main__)N)!r r r, rY r5 r Z cloudinitr r Zcloudinit.cmd.develr r Z!cloudinit.handlers.jinja_templater r r Zcloudinit.sourcesr
r r r Z getLoggerr2 r% r* rS r< r �boolrI rX r\ �__name__r# r# r# r$ �<module> s,
VF� +=