oc_adm_router.py 104 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123
  1. #!/usr/bin/env python
  2. # pylint: disable=missing-docstring
  3. # flake8: noqa: T001
  4. # ___ ___ _ _ ___ ___ _ _____ ___ ___
  5. # / __| __| \| | __| _ \ /_\_ _| __| \
  6. # | (_ | _|| .` | _|| / / _ \| | | _|| |) |
  7. # \___|___|_|\_|___|_|_\/_/_\_\_|_|___|___/_ _____
  8. # | \ / _ \ | \| |/ _ \_ _| | __| \_ _|_ _|
  9. # | |) | (_) | | .` | (_) || | | _|| |) | | | |
  10. # |___/ \___/ |_|\_|\___/ |_| |___|___/___| |_|
  11. #
  12. # Copyright 2016 Red Hat, Inc. and/or its affiliates
  13. # and other contributors as indicated by the @author tags.
  14. #
  15. # Licensed under the Apache License, Version 2.0 (the "License");
  16. # you may not use this file except in compliance with the License.
  17. # You may obtain a copy of the License at
  18. #
  19. # http://www.apache.org/licenses/LICENSE-2.0
  20. #
  21. # Unless required by applicable law or agreed to in writing, software
  22. # distributed under the License is distributed on an "AS IS" BASIS,
  23. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  24. # See the License for the specific language governing permissions and
  25. # limitations under the License.
  26. #
  27. # -*- -*- -*- Begin included fragment: lib/import.py -*- -*- -*-
  28. '''
  29. OpenShiftCLI class that wraps the oc commands in a subprocess
  30. '''
  31. # pylint: disable=too-many-lines
  32. from __future__ import print_function
  33. import atexit
  34. import copy
  35. import json
  36. import os
  37. import re
  38. import shutil
  39. import subprocess
  40. import tempfile
  41. # pylint: disable=import-error
  42. try:
  43. import ruamel.yaml as yaml
  44. except ImportError:
  45. import yaml
  46. from ansible.module_utils.basic import AnsibleModule
  47. # -*- -*- -*- End included fragment: lib/import.py -*- -*- -*-
  48. # -*- -*- -*- Begin included fragment: doc/router -*- -*- -*-
  49. DOCUMENTATION = '''
  50. ---
  51. module: oc_adm_router
  52. short_description: Module to manage openshift router
  53. description:
  54. - Manage openshift router programmatically.
  55. options:
  56. state:
  57. description:
  58. - Whether to create or delete the router
  59. - present - create the router
  60. - absent - remove the router
  61. - list - return the current representation of a router
  62. required: false
  63. default: present
  64. choices:
  65. - present
  66. - absent
  67. aliases: []
  68. kubeconfig:
  69. description:
  70. - The path for the kubeconfig file to use for authentication
  71. required: false
  72. default: /etc/origin/master/admin.kubeconfig
  73. aliases: []
  74. debug:
  75. description:
  76. - Turn on debug output.
  77. required: false
  78. default: False
  79. aliases: []
  80. name:
  81. description:
  82. - The name of the router
  83. required: false
  84. default: router
  85. aliases: []
  86. namespace:
  87. description:
  88. - The namespace where to manage the router.
  89. required: false
  90. default: default
  91. aliases: []
  92. images:
  93. description:
  94. - The image to base this router on - ${component} will be replaced with --type
  95. required: 'openshift3/ose-${component}:${version}'
  96. default: None
  97. aliases: []
  98. latest_images:
  99. description:
  100. - If true, attempt to use the latest image for the registry instead of the latest release.
  101. required: false
  102. default: False
  103. aliases: []
  104. labels:
  105. description:
  106. - A set of labels to uniquely identify the registry and its components.
  107. required: false
  108. default: None
  109. aliases: []
  110. ports:
  111. description:
  112. - A list of strings in the 'port:port' format
  113. required: False
  114. default:
  115. - 80:80
  116. - 443:443
  117. aliases: []
  118. replicas:
  119. description:
  120. - The replication factor of the registry; commonly 2 when high availability is desired.
  121. required: False
  122. default: 1
  123. aliases: []
  124. selector:
  125. description:
  126. - Selector used to filter nodes on deployment. Used to run routers on a specific set of nodes.
  127. required: False
  128. default: None
  129. aliases: []
  130. service_account:
  131. description:
  132. - Name of the service account to use to run the router pod.
  133. required: False
  134. default: router
  135. aliases: []
  136. router_type:
  137. description:
  138. - The router image to use - if you specify --images this flag may be ignored.
  139. required: false
  140. default: haproxy-router
  141. aliases: []
  142. external_host:
  143. description:
  144. - If the underlying router implementation connects with an external host, this is the external host's hostname.
  145. required: false
  146. default: None
  147. aliases: []
  148. external_host_vserver:
  149. description:
  150. - If the underlying router implementation uses virtual servers, this is the name of the virtual server for HTTP connections.
  151. required: false
  152. default: None
  153. aliases: []
  154. external_host_insecure:
  155. description:
  156. - If the underlying router implementation connects with an external host
  157. - over a secure connection, this causes the router to skip strict certificate verification with the external host.
  158. required: false
  159. default: False
  160. aliases: []
  161. external_host_partition_path:
  162. description:
  163. - If the underlying router implementation uses partitions for control boundaries, this is the path to use for that partition.
  164. required: false
  165. default: None
  166. aliases: []
  167. external_host_username:
  168. description:
  169. - If the underlying router implementation connects with an external host, this is the username for authenticating with the external host.
  170. required: false
  171. default: None
  172. aliases: []
  173. external_host_password:
  174. description:
  175. - If the underlying router implementation connects with an external host, this is the password for authenticating with the external host.
  176. required: false
  177. default: None
  178. aliases: []
  179. external_host_private_key:
  180. description:
  181. - If the underlying router implementation requires an SSH private key, this is the path to the private key file.
  182. required: false
  183. default: None
  184. aliases: []
  185. expose_metrics:
  186. description:
  187. - This is a hint to run an extra container in the pod to expose metrics - the image
  188. - will either be set depending on the router implementation or provided with --metrics-image.
  189. required: false
  190. default: False
  191. aliases: []
  192. metrics_image:
  193. description:
  194. - If expose_metrics is specified this is the image to use to run a sidecar container
  195. - in the pod exposing metrics. If not set and --expose-metrics is true the image will
  196. - depend on router implementation.
  197. required: false
  198. default: None
  199. aliases: []
  200. author:
  201. - "Kenny Woodson <kwoodson@redhat.com>"
  202. extends_documentation_fragment:
  203. - There are some exceptions to note when doing the idempotency in this module.
  204. - The strategy is to use the oc adm router command to generate a default
  205. - configuration when creating or updating a router. Often times there
  206. - differences from the generated template and what is in memory in openshift.
  207. - We make exceptions to not check these specific values when comparing objects.
  208. - Here are a list of exceptions:
  209. - - DeploymentConfig:
  210. - dnsPolicy
  211. - terminationGracePeriodSeconds
  212. - restartPolicy
  213. - timeoutSeconds
  214. - livenessProbe
  215. - readinessProbe
  216. - terminationMessagePath
  217. - hostPort
  218. - defaultMode
  219. - Service:
  220. - portalIP
  221. - clusterIP
  222. - sessionAffinity
  223. - type
  224. - ServiceAccount:
  225. - secrets
  226. - imagePullSecrets
  227. '''
  228. EXAMPLES = '''
  229. - name: create routers
  230. oc_adm_router:
  231. name: router
  232. service_account: router
  233. replicas: 2
  234. namespace: default
  235. selector: type=infra
  236. cert_file: /etc/origin/master/named_certificates/router.crt
  237. key_file: /etc/origin/master/named_certificates/router.key
  238. cacert_file: /etc/origin/master/named_certificates/router.ca
  239. edits:
  240. - key: spec.strategy.rollingParams
  241. value:
  242. intervalSeconds: 1
  243. maxSurge: 50%
  244. maxUnavailable: 50%
  245. timeoutSeconds: 600
  246. updatePeriodSeconds: 1
  247. action: put
  248. - key: spec.template.spec.containers[0].resources.limits.memory
  249. value: 2G
  250. action: put
  251. - key: spec.template.spec.containers[0].resources.requests.memory
  252. value: 1G
  253. action: put
  254. - key: spec.template.spec.containers[0].env
  255. value:
  256. name: EXTENDED_VALIDATION
  257. value: 'false'
  258. action: update
  259. register: router_out
  260. run_once: True
  261. '''
  262. # -*- -*- -*- End included fragment: doc/router -*- -*- -*-
  263. # -*- -*- -*- Begin included fragment: ../../lib_utils/src/class/yedit.py -*- -*- -*-
  264. class YeditException(Exception):
  265. ''' Exception class for Yedit '''
  266. pass
  267. # pylint: disable=too-many-public-methods
  268. class Yedit(object):
  269. ''' Class to modify yaml files '''
  270. re_valid_key = r"(((\[-?\d+\])|([0-9a-zA-Z%s/_-]+)).?)+$"
  271. re_key = r"(?:\[(-?\d+)\])|([0-9a-zA-Z%s/_-]+)"
  272. com_sep = set(['.', '#', '|', ':'])
  273. # pylint: disable=too-many-arguments
  274. def __init__(self,
  275. filename=None,
  276. content=None,
  277. content_type='yaml',
  278. separator='.',
  279. backup=False):
  280. self.content = content
  281. self._separator = separator
  282. self.filename = filename
  283. self.__yaml_dict = content
  284. self.content_type = content_type
  285. self.backup = backup
  286. self.load(content_type=self.content_type)
  287. if self.__yaml_dict is None:
  288. self.__yaml_dict = {}
  289. @property
  290. def separator(self):
  291. ''' getter method for separator '''
  292. return self._separator
  293. @separator.setter
  294. def separator(self, inc_sep):
  295. ''' setter method for separator '''
  296. self._separator = inc_sep
  297. @property
  298. def yaml_dict(self):
  299. ''' getter method for yaml_dict '''
  300. return self.__yaml_dict
  301. @yaml_dict.setter
  302. def yaml_dict(self, value):
  303. ''' setter method for yaml_dict '''
  304. self.__yaml_dict = value
  305. @staticmethod
  306. def parse_key(key, sep='.'):
  307. '''parse the key allowing the appropriate separator'''
  308. common_separators = list(Yedit.com_sep - set([sep]))
  309. return re.findall(Yedit.re_key % ''.join(common_separators), key)
  310. @staticmethod
  311. def valid_key(key, sep='.'):
  312. '''validate the incoming key'''
  313. common_separators = list(Yedit.com_sep - set([sep]))
  314. if not re.match(Yedit.re_valid_key % ''.join(common_separators), key):
  315. return False
  316. return True
  317. @staticmethod
  318. def remove_entry(data, key, sep='.'):
  319. ''' remove data at location key '''
  320. if key == '' and isinstance(data, dict):
  321. data.clear()
  322. return True
  323. elif key == '' and isinstance(data, list):
  324. del data[:]
  325. return True
  326. if not (key and Yedit.valid_key(key, sep)) and \
  327. isinstance(data, (list, dict)):
  328. return None
  329. key_indexes = Yedit.parse_key(key, sep)
  330. for arr_ind, dict_key in key_indexes[:-1]:
  331. if dict_key and isinstance(data, dict):
  332. data = data.get(dict_key, None)
  333. elif (arr_ind and isinstance(data, list) and
  334. int(arr_ind) <= len(data) - 1):
  335. data = data[int(arr_ind)]
  336. else:
  337. return None
  338. # process last index for remove
  339. # expected list entry
  340. if key_indexes[-1][0]:
  341. if isinstance(data, list) and int(key_indexes[-1][0]) <= len(data) - 1: # noqa: E501
  342. del data[int(key_indexes[-1][0])]
  343. return True
  344. # expected dict entry
  345. elif key_indexes[-1][1]:
  346. if isinstance(data, dict):
  347. del data[key_indexes[-1][1]]
  348. return True
  349. @staticmethod
  350. def add_entry(data, key, item=None, sep='.'):
  351. ''' Get an item from a dictionary with key notation a.b.c
  352. d = {'a': {'b': 'c'}}}
  353. key = a#b
  354. return c
  355. '''
  356. if key == '':
  357. pass
  358. elif (not (key and Yedit.valid_key(key, sep)) and
  359. isinstance(data, (list, dict))):
  360. return None
  361. key_indexes = Yedit.parse_key(key, sep)
  362. for arr_ind, dict_key in key_indexes[:-1]:
  363. if dict_key:
  364. if isinstance(data, dict) and dict_key in data and data[dict_key]: # noqa: E501
  365. data = data[dict_key]
  366. continue
  367. elif data and not isinstance(data, dict):
  368. raise YeditException("Unexpected item type found while going through key " +
  369. "path: {} (at key: {})".format(key, dict_key))
  370. data[dict_key] = {}
  371. data = data[dict_key]
  372. elif (arr_ind and isinstance(data, list) and
  373. int(arr_ind) <= len(data) - 1):
  374. data = data[int(arr_ind)]
  375. else:
  376. raise YeditException("Unexpected item type found while going through key path: {}".format(key))
  377. if key == '':
  378. data = item
  379. # process last index for add
  380. # expected list entry
  381. elif key_indexes[-1][0] and isinstance(data, list) and int(key_indexes[-1][0]) <= len(data) - 1: # noqa: E501
  382. data[int(key_indexes[-1][0])] = item
  383. # expected dict entry
  384. elif key_indexes[-1][1] and isinstance(data, dict):
  385. data[key_indexes[-1][1]] = item
  386. # didn't add/update to an existing list, nor add/update key to a dict
  387. # so we must have been provided some syntax like a.b.c[<int>] = "data" for a
  388. # non-existent array
  389. else:
  390. raise YeditException("Error adding to object at path: {}".format(key))
  391. return data
  392. @staticmethod
  393. def get_entry(data, key, sep='.'):
  394. ''' Get an item from a dictionary with key notation a.b.c
  395. d = {'a': {'b': 'c'}}}
  396. key = a.b
  397. return c
  398. '''
  399. if key == '':
  400. pass
  401. elif (not (key and Yedit.valid_key(key, sep)) and
  402. isinstance(data, (list, dict))):
  403. return None
  404. key_indexes = Yedit.parse_key(key, sep)
  405. for arr_ind, dict_key in key_indexes:
  406. if dict_key and isinstance(data, dict):
  407. data = data.get(dict_key, None)
  408. elif (arr_ind and isinstance(data, list) and
  409. int(arr_ind) <= len(data) - 1):
  410. data = data[int(arr_ind)]
  411. else:
  412. return None
  413. return data
  414. @staticmethod
  415. def _write(filename, contents):
  416. ''' Actually write the file contents to disk. This helps with mocking. '''
  417. tmp_filename = filename + '.yedit'
  418. with open(tmp_filename, 'w') as yfd:
  419. yfd.write(contents)
  420. os.rename(tmp_filename, filename)
  421. def write(self):
  422. ''' write to file '''
  423. if not self.filename:
  424. raise YeditException('Please specify a filename.')
  425. if self.backup and self.file_exists():
  426. shutil.copy(self.filename, self.filename + '.orig')
  427. # Try to set format attributes if supported
  428. try:
  429. self.yaml_dict.fa.set_block_style()
  430. except AttributeError:
  431. pass
  432. # Try to use RoundTripDumper if supported.
  433. try:
  434. Yedit._write(self.filename, yaml.dump(self.yaml_dict, Dumper=yaml.RoundTripDumper))
  435. except AttributeError:
  436. Yedit._write(self.filename, yaml.safe_dump(self.yaml_dict, default_flow_style=False))
  437. return (True, self.yaml_dict)
  438. def read(self):
  439. ''' read from file '''
  440. # check if it exists
  441. if self.filename is None or not self.file_exists():
  442. return None
  443. contents = None
  444. with open(self.filename) as yfd:
  445. contents = yfd.read()
  446. return contents
  447. def file_exists(self):
  448. ''' return whether file exists '''
  449. if os.path.exists(self.filename):
  450. return True
  451. return False
  452. def load(self, content_type='yaml'):
  453. ''' return yaml file '''
  454. contents = self.read()
  455. if not contents and not self.content:
  456. return None
  457. if self.content:
  458. if isinstance(self.content, dict):
  459. self.yaml_dict = self.content
  460. return self.yaml_dict
  461. elif isinstance(self.content, str):
  462. contents = self.content
  463. # check if it is yaml
  464. try:
  465. if content_type == 'yaml' and contents:
  466. # Try to set format attributes if supported
  467. try:
  468. self.yaml_dict.fa.set_block_style()
  469. except AttributeError:
  470. pass
  471. # Try to use RoundTripLoader if supported.
  472. try:
  473. self.yaml_dict = yaml.safe_load(contents, yaml.RoundTripLoader)
  474. except AttributeError:
  475. self.yaml_dict = yaml.safe_load(contents)
  476. # Try to set format attributes if supported
  477. try:
  478. self.yaml_dict.fa.set_block_style()
  479. except AttributeError:
  480. pass
  481. elif content_type == 'json' and contents:
  482. self.yaml_dict = json.loads(contents)
  483. except yaml.YAMLError as err:
  484. # Error loading yaml or json
  485. raise YeditException('Problem with loading yaml file. %s' % err)
  486. return self.yaml_dict
  487. def get(self, key):
  488. ''' get a specified key'''
  489. try:
  490. entry = Yedit.get_entry(self.yaml_dict, key, self.separator)
  491. except KeyError:
  492. entry = None
  493. return entry
  494. def pop(self, path, key_or_item):
  495. ''' remove a key, value pair from a dict or an item for a list'''
  496. try:
  497. entry = Yedit.get_entry(self.yaml_dict, path, self.separator)
  498. except KeyError:
  499. entry = None
  500. if entry is None:
  501. return (False, self.yaml_dict)
  502. if isinstance(entry, dict):
  503. # AUDIT:maybe-no-member makes sense due to fuzzy types
  504. # pylint: disable=maybe-no-member
  505. if key_or_item in entry:
  506. entry.pop(key_or_item)
  507. return (True, self.yaml_dict)
  508. return (False, self.yaml_dict)
  509. elif isinstance(entry, list):
  510. # AUDIT:maybe-no-member makes sense due to fuzzy types
  511. # pylint: disable=maybe-no-member
  512. ind = None
  513. try:
  514. ind = entry.index(key_or_item)
  515. except ValueError:
  516. return (False, self.yaml_dict)
  517. entry.pop(ind)
  518. return (True, self.yaml_dict)
  519. return (False, self.yaml_dict)
  520. def delete(self, path):
  521. ''' remove path from a dict'''
  522. try:
  523. entry = Yedit.get_entry(self.yaml_dict, path, self.separator)
  524. except KeyError:
  525. entry = None
  526. if entry is None:
  527. return (False, self.yaml_dict)
  528. result = Yedit.remove_entry(self.yaml_dict, path, self.separator)
  529. if not result:
  530. return (False, self.yaml_dict)
  531. return (True, self.yaml_dict)
  532. def exists(self, path, value):
  533. ''' check if value exists at path'''
  534. try:
  535. entry = Yedit.get_entry(self.yaml_dict, path, self.separator)
  536. except KeyError:
  537. entry = None
  538. if isinstance(entry, list):
  539. if value in entry:
  540. return True
  541. return False
  542. elif isinstance(entry, dict):
  543. if isinstance(value, dict):
  544. rval = False
  545. for key, val in value.items():
  546. if entry[key] != val:
  547. rval = False
  548. break
  549. else:
  550. rval = True
  551. return rval
  552. return value in entry
  553. return entry == value
  554. def append(self, path, value):
  555. '''append value to a list'''
  556. try:
  557. entry = Yedit.get_entry(self.yaml_dict, path, self.separator)
  558. except KeyError:
  559. entry = None
  560. if entry is None:
  561. self.put(path, [])
  562. entry = Yedit.get_entry(self.yaml_dict, path, self.separator)
  563. if not isinstance(entry, list):
  564. return (False, self.yaml_dict)
  565. # AUDIT:maybe-no-member makes sense due to loading data from
  566. # a serialized format.
  567. # pylint: disable=maybe-no-member
  568. entry.append(value)
  569. return (True, self.yaml_dict)
  570. # pylint: disable=too-many-arguments
  571. def update(self, path, value, index=None, curr_value=None):
  572. ''' put path, value into a dict '''
  573. try:
  574. entry = Yedit.get_entry(self.yaml_dict, path, self.separator)
  575. except KeyError:
  576. entry = None
  577. if isinstance(entry, dict):
  578. # AUDIT:maybe-no-member makes sense due to fuzzy types
  579. # pylint: disable=maybe-no-member
  580. if not isinstance(value, dict):
  581. raise YeditException('Cannot replace key, value entry in ' +
  582. 'dict with non-dict type. value=[%s] [%s]' % (value, type(value))) # noqa: E501
  583. entry.update(value)
  584. return (True, self.yaml_dict)
  585. elif isinstance(entry, list):
  586. # AUDIT:maybe-no-member makes sense due to fuzzy types
  587. # pylint: disable=maybe-no-member
  588. ind = None
  589. if curr_value:
  590. try:
  591. ind = entry.index(curr_value)
  592. except ValueError:
  593. return (False, self.yaml_dict)
  594. elif index is not None:
  595. ind = index
  596. if ind is not None and entry[ind] != value:
  597. entry[ind] = value
  598. return (True, self.yaml_dict)
  599. # see if it exists in the list
  600. try:
  601. ind = entry.index(value)
  602. except ValueError:
  603. # doesn't exist, append it
  604. entry.append(value)
  605. return (True, self.yaml_dict)
  606. # already exists, return
  607. if ind is not None:
  608. return (False, self.yaml_dict)
  609. return (False, self.yaml_dict)
  610. def put(self, path, value):
  611. ''' put path, value into a dict '''
  612. try:
  613. entry = Yedit.get_entry(self.yaml_dict, path, self.separator)
  614. except KeyError:
  615. entry = None
  616. if entry == value:
  617. return (False, self.yaml_dict)
  618. # deepcopy didn't work
  619. # Try to use ruamel.yaml and fallback to pyyaml
  620. try:
  621. tmp_copy = yaml.load(yaml.round_trip_dump(self.yaml_dict,
  622. default_flow_style=False),
  623. yaml.RoundTripLoader)
  624. except AttributeError:
  625. tmp_copy = copy.deepcopy(self.yaml_dict)
  626. # set the format attributes if available
  627. try:
  628. tmp_copy.fa.set_block_style()
  629. except AttributeError:
  630. pass
  631. result = Yedit.add_entry(tmp_copy, path, value, self.separator)
  632. if result is None:
  633. return (False, self.yaml_dict)
  634. # When path equals "" it is a special case.
  635. # "" refers to the root of the document
  636. # Only update the root path (entire document) when its a list or dict
  637. if path == '':
  638. if isinstance(result, list) or isinstance(result, dict):
  639. self.yaml_dict = result
  640. return (True, self.yaml_dict)
  641. return (False, self.yaml_dict)
  642. self.yaml_dict = tmp_copy
  643. return (True, self.yaml_dict)
  644. def create(self, path, value):
  645. ''' create a yaml file '''
  646. if not self.file_exists():
  647. # deepcopy didn't work
  648. # Try to use ruamel.yaml and fallback to pyyaml
  649. try:
  650. tmp_copy = yaml.load(yaml.round_trip_dump(self.yaml_dict,
  651. default_flow_style=False),
  652. yaml.RoundTripLoader)
  653. except AttributeError:
  654. tmp_copy = copy.deepcopy(self.yaml_dict)
  655. # set the format attributes if available
  656. try:
  657. tmp_copy.fa.set_block_style()
  658. except AttributeError:
  659. pass
  660. result = Yedit.add_entry(tmp_copy, path, value, self.separator)
  661. if result is not None:
  662. self.yaml_dict = tmp_copy
  663. return (True, self.yaml_dict)
  664. return (False, self.yaml_dict)
  665. @staticmethod
  666. def get_curr_value(invalue, val_type):
  667. '''return the current value'''
  668. if invalue is None:
  669. return None
  670. curr_value = invalue
  671. if val_type == 'yaml':
  672. curr_value = yaml.load(invalue)
  673. elif val_type == 'json':
  674. curr_value = json.loads(invalue)
  675. return curr_value
  676. @staticmethod
  677. def parse_value(inc_value, vtype=''):
  678. '''determine value type passed'''
  679. true_bools = ['y', 'Y', 'yes', 'Yes', 'YES', 'true', 'True', 'TRUE',
  680. 'on', 'On', 'ON', ]
  681. false_bools = ['n', 'N', 'no', 'No', 'NO', 'false', 'False', 'FALSE',
  682. 'off', 'Off', 'OFF']
  683. # It came in as a string but you didn't specify value_type as string
  684. # we will convert to bool if it matches any of the above cases
  685. if isinstance(inc_value, str) and 'bool' in vtype:
  686. if inc_value not in true_bools and inc_value not in false_bools:
  687. raise YeditException('Not a boolean type. str=[%s] vtype=[%s]' % (inc_value, vtype))
  688. elif isinstance(inc_value, bool) and 'str' in vtype:
  689. inc_value = str(inc_value)
  690. # There is a special case where '' will turn into None after yaml loading it so skip
  691. if isinstance(inc_value, str) and inc_value == '':
  692. pass
  693. # If vtype is not str then go ahead and attempt to yaml load it.
  694. elif isinstance(inc_value, str) and 'str' not in vtype:
  695. try:
  696. inc_value = yaml.safe_load(inc_value)
  697. except Exception:
  698. raise YeditException('Could not determine type of incoming ' +
  699. 'value. value=[%s] vtype=[%s]'
  700. % (type(inc_value), vtype))
  701. return inc_value
  702. @staticmethod
  703. def process_edits(edits, yamlfile):
  704. '''run through a list of edits and process them one-by-one'''
  705. results = []
  706. for edit in edits:
  707. value = Yedit.parse_value(edit['value'], edit.get('value_type', ''))
  708. if 'action' in edit and edit['action'] == 'update':
  709. # pylint: disable=line-too-long
  710. curr_value = Yedit.get_curr_value(Yedit.parse_value(edit.get('curr_value', None)), # noqa: E501
  711. edit.get('curr_value_format', None)) # noqa: E501
  712. rval = yamlfile.update(edit['key'],
  713. value,
  714. edit.get('index', None),
  715. curr_value)
  716. elif 'action' in edit and edit['action'] == 'append':
  717. rval = yamlfile.append(edit['key'], value)
  718. else:
  719. rval = yamlfile.put(edit['key'], value)
  720. if rval[0]:
  721. results.append({'key': edit['key'], 'edit': rval[1]})
  722. return {'changed': len(results) > 0, 'results': results}
  723. # pylint: disable=too-many-return-statements,too-many-branches
  724. @staticmethod
  725. def run_ansible(params):
  726. '''perform the idempotent crud operations'''
  727. yamlfile = Yedit(filename=params['src'],
  728. backup=params['backup'],
  729. separator=params['separator'])
  730. state = params['state']
  731. if params['src']:
  732. rval = yamlfile.load()
  733. if yamlfile.yaml_dict is None and state != 'present':
  734. return {'failed': True,
  735. 'msg': 'Error opening file [%s]. Verify that the ' +
  736. 'file exists, that it is has correct' +
  737. ' permissions, and is valid yaml.'}
  738. if state == 'list':
  739. if params['content']:
  740. content = Yedit.parse_value(params['content'], params['content_type'])
  741. yamlfile.yaml_dict = content
  742. if params['key']:
  743. rval = yamlfile.get(params['key']) or {}
  744. return {'changed': False, 'result': rval, 'state': state}
  745. elif state == 'absent':
  746. if params['content']:
  747. content = Yedit.parse_value(params['content'], params['content_type'])
  748. yamlfile.yaml_dict = content
  749. if params['update']:
  750. rval = yamlfile.pop(params['key'], params['value'])
  751. else:
  752. rval = yamlfile.delete(params['key'])
  753. if rval[0] and params['src']:
  754. yamlfile.write()
  755. return {'changed': rval[0], 'result': rval[1], 'state': state}
  756. elif state == 'present':
  757. # check if content is different than what is in the file
  758. if params['content']:
  759. content = Yedit.parse_value(params['content'], params['content_type'])
  760. # We had no edits to make and the contents are the same
  761. if yamlfile.yaml_dict == content and \
  762. params['value'] is None:
  763. return {'changed': False, 'result': yamlfile.yaml_dict, 'state': state}
  764. yamlfile.yaml_dict = content
  765. # If we were passed a key, value then
  766. # we enapsulate it in a list and process it
  767. # Key, Value passed to the module : Converted to Edits list #
  768. edits = []
  769. _edit = {}
  770. if params['value'] is not None:
  771. _edit['value'] = params['value']
  772. _edit['value_type'] = params['value_type']
  773. _edit['key'] = params['key']
  774. if params['update']:
  775. _edit['action'] = 'update'
  776. _edit['curr_value'] = params['curr_value']
  777. _edit['curr_value_format'] = params['curr_value_format']
  778. _edit['index'] = params['index']
  779. elif params['append']:
  780. _edit['action'] = 'append'
  781. edits.append(_edit)
  782. elif params['edits'] is not None:
  783. edits = params['edits']
  784. if edits:
  785. results = Yedit.process_edits(edits, yamlfile)
  786. # if there were changes and a src provided to us we need to write
  787. if results['changed'] and params['src']:
  788. yamlfile.write()
  789. return {'changed': results['changed'], 'result': results['results'], 'state': state}
  790. # no edits to make
  791. if params['src']:
  792. # pylint: disable=redefined-variable-type
  793. rval = yamlfile.write()
  794. return {'changed': rval[0],
  795. 'result': rval[1],
  796. 'state': state}
  797. # We were passed content but no src, key or value, or edits. Return contents in memory
  798. return {'changed': False, 'result': yamlfile.yaml_dict, 'state': state}
  799. return {'failed': True, 'msg': 'Unkown state passed'}
  800. # -*- -*- -*- End included fragment: ../../lib_utils/src/class/yedit.py -*- -*- -*-
  801. # -*- -*- -*- Begin included fragment: lib/base.py -*- -*- -*-
  802. # pylint: disable=too-many-lines
  803. # noqa: E301,E302,E303,T001
  804. class OpenShiftCLIError(Exception):
  805. '''Exception class for openshiftcli'''
  806. pass
  807. ADDITIONAL_PATH_LOOKUPS = ['/usr/local/bin', os.path.expanduser('~/bin')]
  808. def locate_oc_binary():
  809. ''' Find and return oc binary file '''
  810. # https://github.com/openshift/openshift-ansible/issues/3410
  811. # oc can be in /usr/local/bin in some cases, but that may not
  812. # be in $PATH due to ansible/sudo
  813. paths = os.environ.get("PATH", os.defpath).split(os.pathsep) + ADDITIONAL_PATH_LOOKUPS
  814. oc_binary = 'oc'
  815. # Use shutil.which if it is available, otherwise fallback to a naive path search
  816. try:
  817. which_result = shutil.which(oc_binary, path=os.pathsep.join(paths))
  818. if which_result is not None:
  819. oc_binary = which_result
  820. except AttributeError:
  821. for path in paths:
  822. if os.path.exists(os.path.join(path, oc_binary)):
  823. oc_binary = os.path.join(path, oc_binary)
  824. break
  825. return oc_binary
  826. # pylint: disable=too-few-public-methods
  827. class OpenShiftCLI(object):
  828. ''' Class to wrap the command line tools '''
  829. def __init__(self,
  830. namespace,
  831. kubeconfig='/etc/origin/master/admin.kubeconfig',
  832. verbose=False,
  833. all_namespaces=False):
  834. ''' Constructor for OpenshiftCLI '''
  835. self.namespace = namespace
  836. self.verbose = verbose
  837. self.kubeconfig = Utils.create_tmpfile_copy(kubeconfig)
  838. self.all_namespaces = all_namespaces
  839. self.oc_binary = locate_oc_binary()
  840. # Pylint allows only 5 arguments to be passed.
  841. # pylint: disable=too-many-arguments
  842. def _replace_content(self, resource, rname, content, force=False, sep='.'):
  843. ''' replace the current object with the content '''
  844. res = self._get(resource, rname)
  845. if not res['results']:
  846. return res
  847. fname = Utils.create_tmpfile(rname + '-')
  848. yed = Yedit(fname, res['results'][0], separator=sep)
  849. changes = []
  850. for key, value in content.items():
  851. changes.append(yed.put(key, value))
  852. if any([change[0] for change in changes]):
  853. yed.write()
  854. atexit.register(Utils.cleanup, [fname])
  855. return self._replace(fname, force)
  856. return {'returncode': 0, 'updated': False}
  857. def _replace(self, fname, force=False):
  858. '''replace the current object with oc replace'''
  859. cmd = ['replace', '-f', fname]
  860. if force:
  861. cmd.append('--force')
  862. return self.openshift_cmd(cmd)
  863. def _create_from_content(self, rname, content):
  864. '''create a temporary file and then call oc create on it'''
  865. fname = Utils.create_tmpfile(rname + '-')
  866. yed = Yedit(fname, content=content)
  867. yed.write()
  868. atexit.register(Utils.cleanup, [fname])
  869. return self._create(fname)
  870. def _create(self, fname):
  871. '''call oc create on a filename'''
  872. return self.openshift_cmd(['create', '-f', fname])
  873. def _delete(self, resource, rname, selector=None):
  874. '''call oc delete on a resource'''
  875. cmd = ['delete', resource, rname]
  876. if selector:
  877. cmd.append('--selector=%s' % selector)
  878. return self.openshift_cmd(cmd)
  879. def _process(self, template_name, create=False, params=None, template_data=None): # noqa: E501
  880. '''process a template
  881. template_name: the name of the template to process
  882. create: whether to send to oc create after processing
  883. params: the parameters for the template
  884. template_data: the incoming template's data; instead of a file
  885. '''
  886. cmd = ['process']
  887. if template_data:
  888. cmd.extend(['-f', '-'])
  889. else:
  890. cmd.append(template_name)
  891. if params:
  892. param_str = ["%s=%s" % (key, value) for key, value in params.items()]
  893. cmd.append('-v')
  894. cmd.extend(param_str)
  895. results = self.openshift_cmd(cmd, output=True, input_data=template_data)
  896. if results['returncode'] != 0 or not create:
  897. return results
  898. fname = Utils.create_tmpfile(template_name + '-')
  899. yed = Yedit(fname, results['results'])
  900. yed.write()
  901. atexit.register(Utils.cleanup, [fname])
  902. return self.openshift_cmd(['create', '-f', fname])
  903. def _get(self, resource, rname=None, selector=None):
  904. '''return a resource by name '''
  905. cmd = ['get', resource]
  906. if selector:
  907. cmd.append('--selector=%s' % selector)
  908. elif rname:
  909. cmd.append(rname)
  910. cmd.extend(['-o', 'json'])
  911. rval = self.openshift_cmd(cmd, output=True)
  912. # Ensure results are retuned in an array
  913. if 'items' in rval:
  914. rval['results'] = rval['items']
  915. elif not isinstance(rval['results'], list):
  916. rval['results'] = [rval['results']]
  917. return rval
  918. def _schedulable(self, node=None, selector=None, schedulable=True):
  919. ''' perform oadm manage-node scheduable '''
  920. cmd = ['manage-node']
  921. if node:
  922. cmd.extend(node)
  923. else:
  924. cmd.append('--selector=%s' % selector)
  925. cmd.append('--schedulable=%s' % schedulable)
  926. return self.openshift_cmd(cmd, oadm=True, output=True, output_type='raw') # noqa: E501
  927. def _list_pods(self, node=None, selector=None, pod_selector=None):
  928. ''' perform oadm list pods
  929. node: the node in which to list pods
  930. selector: the label selector filter if provided
  931. pod_selector: the pod selector filter if provided
  932. '''
  933. cmd = ['manage-node']
  934. if node:
  935. cmd.extend(node)
  936. else:
  937. cmd.append('--selector=%s' % selector)
  938. if pod_selector:
  939. cmd.append('--pod-selector=%s' % pod_selector)
  940. cmd.extend(['--list-pods', '-o', 'json'])
  941. return self.openshift_cmd(cmd, oadm=True, output=True, output_type='raw')
  942. # pylint: disable=too-many-arguments
  943. def _evacuate(self, node=None, selector=None, pod_selector=None, dry_run=False, grace_period=None, force=False):
  944. ''' perform oadm manage-node evacuate '''
  945. cmd = ['manage-node']
  946. if node:
  947. cmd.extend(node)
  948. else:
  949. cmd.append('--selector=%s' % selector)
  950. if dry_run:
  951. cmd.append('--dry-run')
  952. if pod_selector:
  953. cmd.append('--pod-selector=%s' % pod_selector)
  954. if grace_period:
  955. cmd.append('--grace-period=%s' % int(grace_period))
  956. if force:
  957. cmd.append('--force')
  958. cmd.append('--evacuate')
  959. return self.openshift_cmd(cmd, oadm=True, output=True, output_type='raw')
  960. def _version(self):
  961. ''' return the openshift version'''
  962. return self.openshift_cmd(['version'], output=True, output_type='raw')
  963. def _import_image(self, url=None, name=None, tag=None):
  964. ''' perform image import '''
  965. cmd = ['import-image']
  966. image = '{0}'.format(name)
  967. if tag:
  968. image += ':{0}'.format(tag)
  969. cmd.append(image)
  970. if url:
  971. cmd.append('--from={0}/{1}'.format(url, image))
  972. cmd.append('-n{0}'.format(self.namespace))
  973. cmd.append('--confirm')
  974. return self.openshift_cmd(cmd)
  975. def _run(self, cmds, input_data):
  976. ''' Actually executes the command. This makes mocking easier. '''
  977. curr_env = os.environ.copy()
  978. curr_env.update({'KUBECONFIG': self.kubeconfig})
  979. proc = subprocess.Popen(cmds,
  980. stdin=subprocess.PIPE,
  981. stdout=subprocess.PIPE,
  982. stderr=subprocess.PIPE,
  983. env=curr_env)
  984. stdout, stderr = proc.communicate(input_data)
  985. return proc.returncode, stdout.decode(), stderr.decode()
  986. # pylint: disable=too-many-arguments,too-many-branches
  987. def openshift_cmd(self, cmd, oadm=False, output=False, output_type='json', input_data=None):
  988. '''Base command for oc '''
  989. cmds = [self.oc_binary]
  990. if oadm:
  991. cmds.append('adm')
  992. cmds.extend(cmd)
  993. if self.all_namespaces:
  994. cmds.extend(['--all-namespaces'])
  995. elif self.namespace is not None and self.namespace.lower() not in ['none', 'emtpy']: # E501
  996. cmds.extend(['-n', self.namespace])
  997. rval = {}
  998. results = ''
  999. err = None
  1000. if self.verbose:
  1001. print(' '.join(cmds))
  1002. try:
  1003. returncode, stdout, stderr = self._run(cmds, input_data)
  1004. except OSError as ex:
  1005. returncode, stdout, stderr = 1, '', 'Failed to execute {}: {}'.format(subprocess.list2cmdline(cmds), ex)
  1006. rval = {"returncode": returncode,
  1007. "results": results,
  1008. "cmd": ' '.join(cmds)}
  1009. if returncode == 0:
  1010. if output:
  1011. if output_type == 'json':
  1012. try:
  1013. rval['results'] = json.loads(stdout)
  1014. except ValueError as verr:
  1015. if "No JSON object could be decoded" in verr.args:
  1016. err = verr.args
  1017. elif output_type == 'raw':
  1018. rval['results'] = stdout
  1019. if self.verbose:
  1020. print("STDOUT: {0}".format(stdout))
  1021. print("STDERR: {0}".format(stderr))
  1022. if err:
  1023. rval.update({"err": err,
  1024. "stderr": stderr,
  1025. "stdout": stdout,
  1026. "cmd": cmds})
  1027. else:
  1028. rval.update({"stderr": stderr,
  1029. "stdout": stdout,
  1030. "results": {}})
  1031. return rval
  1032. class Utils(object):
  1033. ''' utilities for openshiftcli modules '''
  1034. @staticmethod
  1035. def _write(filename, contents):
  1036. ''' Actually write the file contents to disk. This helps with mocking. '''
  1037. with open(filename, 'w') as sfd:
  1038. sfd.write(contents)
  1039. @staticmethod
  1040. def create_tmp_file_from_contents(rname, data, ftype='yaml'):
  1041. ''' create a file in tmp with name and contents'''
  1042. tmp = Utils.create_tmpfile(prefix=rname)
  1043. if ftype == 'yaml':
  1044. # AUDIT:no-member makes sense here due to ruamel.YAML/PyYAML usage
  1045. # pylint: disable=no-member
  1046. if hasattr(yaml, 'RoundTripDumper'):
  1047. Utils._write(tmp, yaml.dump(data, Dumper=yaml.RoundTripDumper))
  1048. else:
  1049. Utils._write(tmp, yaml.safe_dump(data, default_flow_style=False))
  1050. elif ftype == 'json':
  1051. Utils._write(tmp, json.dumps(data))
  1052. else:
  1053. Utils._write(tmp, data)
  1054. # Register cleanup when module is done
  1055. atexit.register(Utils.cleanup, [tmp])
  1056. return tmp
  1057. @staticmethod
  1058. def create_tmpfile_copy(inc_file):
  1059. '''create a temporary copy of a file'''
  1060. tmpfile = Utils.create_tmpfile('lib_openshift-')
  1061. Utils._write(tmpfile, open(inc_file).read())
  1062. # Cleanup the tmpfile
  1063. atexit.register(Utils.cleanup, [tmpfile])
  1064. return tmpfile
  1065. @staticmethod
  1066. def create_tmpfile(prefix='tmp'):
  1067. ''' Generates and returns a temporary file name '''
  1068. with tempfile.NamedTemporaryFile(prefix=prefix, delete=False) as tmp:
  1069. return tmp.name
  1070. @staticmethod
  1071. def create_tmp_files_from_contents(content, content_type=None):
  1072. '''Turn an array of dict: filename, content into a files array'''
  1073. if not isinstance(content, list):
  1074. content = [content]
  1075. files = []
  1076. for item in content:
  1077. path = Utils.create_tmp_file_from_contents(item['path'] + '-',
  1078. item['data'],
  1079. ftype=content_type)
  1080. files.append({'name': os.path.basename(item['path']),
  1081. 'path': path})
  1082. return files
  1083. @staticmethod
  1084. def cleanup(files):
  1085. '''Clean up on exit '''
  1086. for sfile in files:
  1087. if os.path.exists(sfile):
  1088. if os.path.isdir(sfile):
  1089. shutil.rmtree(sfile)
  1090. elif os.path.isfile(sfile):
  1091. os.remove(sfile)
  1092. @staticmethod
  1093. def exists(results, _name):
  1094. ''' Check to see if the results include the name '''
  1095. if not results:
  1096. return False
  1097. if Utils.find_result(results, _name):
  1098. return True
  1099. return False
  1100. @staticmethod
  1101. def find_result(results, _name):
  1102. ''' Find the specified result by name'''
  1103. rval = None
  1104. for result in results:
  1105. if 'metadata' in result and result['metadata']['name'] == _name:
  1106. rval = result
  1107. break
  1108. return rval
  1109. @staticmethod
  1110. def get_resource_file(sfile, sfile_type='yaml'):
  1111. ''' return the service file '''
  1112. contents = None
  1113. with open(sfile) as sfd:
  1114. contents = sfd.read()
  1115. if sfile_type == 'yaml':
  1116. # AUDIT:no-member makes sense here due to ruamel.YAML/PyYAML usage
  1117. # pylint: disable=no-member
  1118. if hasattr(yaml, 'RoundTripLoader'):
  1119. contents = yaml.load(contents, yaml.RoundTripLoader)
  1120. else:
  1121. contents = yaml.safe_load(contents)
  1122. elif sfile_type == 'json':
  1123. contents = json.loads(contents)
  1124. return contents
  1125. @staticmethod
  1126. def filter_versions(stdout):
  1127. ''' filter the oc version output '''
  1128. version_dict = {}
  1129. version_search = ['oc', 'openshift', 'kubernetes']
  1130. for line in stdout.strip().split('\n'):
  1131. for term in version_search:
  1132. if not line:
  1133. continue
  1134. if line.startswith(term):
  1135. version_dict[term] = line.split()[-1]
  1136. # horrible hack to get openshift version in Openshift 3.2
  1137. # By default "oc version in 3.2 does not return an "openshift" version
  1138. if "openshift" not in version_dict:
  1139. version_dict["openshift"] = version_dict["oc"]
  1140. return version_dict
  1141. @staticmethod
  1142. def add_custom_versions(versions):
  1143. ''' create custom versions strings '''
  1144. versions_dict = {}
  1145. for tech, version in versions.items():
  1146. # clean up "-" from version
  1147. if "-" in version:
  1148. version = version.split("-")[0]
  1149. if version.startswith('v'):
  1150. versions_dict[tech + '_numeric'] = version[1:].split('+')[0]
  1151. # "v3.3.0.33" is what we have, we want "3.3"
  1152. versions_dict[tech + '_short'] = version[1:4]
  1153. return versions_dict
  1154. @staticmethod
  1155. def openshift_installed():
  1156. ''' check if openshift is installed '''
  1157. import yum
  1158. yum_base = yum.YumBase()
  1159. if yum_base.rpmdb.searchNevra(name='atomic-openshift'):
  1160. return True
  1161. return False
  1162. # Disabling too-many-branches. This is a yaml dictionary comparison function
  1163. # pylint: disable=too-many-branches,too-many-return-statements,too-many-statements
  1164. @staticmethod
  1165. def check_def_equal(user_def, result_def, skip_keys=None, debug=False):
  1166. ''' Given a user defined definition, compare it with the results given back by our query. '''
  1167. # Currently these values are autogenerated and we do not need to check them
  1168. skip = ['metadata', 'status']
  1169. if skip_keys:
  1170. skip.extend(skip_keys)
  1171. for key, value in result_def.items():
  1172. if key in skip:
  1173. continue
  1174. # Both are lists
  1175. if isinstance(value, list):
  1176. if key not in user_def:
  1177. if debug:
  1178. print('User data does not have key [%s]' % key)
  1179. print('User data: %s' % user_def)
  1180. return False
  1181. if not isinstance(user_def[key], list):
  1182. if debug:
  1183. print('user_def[key] is not a list key=[%s] user_def[key]=%s' % (key, user_def[key]))
  1184. return False
  1185. if len(user_def[key]) != len(value):
  1186. if debug:
  1187. print("List lengths are not equal.")
  1188. print("key=[%s]: user_def[%s] != value[%s]" % (key, len(user_def[key]), len(value)))
  1189. print("user_def: %s" % user_def[key])
  1190. print("value: %s" % value)
  1191. return False
  1192. for values in zip(user_def[key], value):
  1193. if isinstance(values[0], dict) and isinstance(values[1], dict):
  1194. if debug:
  1195. print('sending list - list')
  1196. print(type(values[0]))
  1197. print(type(values[1]))
  1198. result = Utils.check_def_equal(values[0], values[1], skip_keys=skip_keys, debug=debug)
  1199. if not result:
  1200. print('list compare returned false')
  1201. return False
  1202. elif value != user_def[key]:
  1203. if debug:
  1204. print('value should be identical')
  1205. print(user_def[key])
  1206. print(value)
  1207. return False
  1208. # recurse on a dictionary
  1209. elif isinstance(value, dict):
  1210. if key not in user_def:
  1211. if debug:
  1212. print("user_def does not have key [%s]" % key)
  1213. return False
  1214. if not isinstance(user_def[key], dict):
  1215. if debug:
  1216. print("dict returned false: not instance of dict")
  1217. return False
  1218. # before passing ensure keys match
  1219. api_values = set(value.keys()) - set(skip)
  1220. user_values = set(user_def[key].keys()) - set(skip)
  1221. if api_values != user_values:
  1222. if debug:
  1223. print("keys are not equal in dict")
  1224. print(user_values)
  1225. print(api_values)
  1226. return False
  1227. result = Utils.check_def_equal(user_def[key], value, skip_keys=skip_keys, debug=debug)
  1228. if not result:
  1229. if debug:
  1230. print("dict returned false")
  1231. print(result)
  1232. return False
  1233. # Verify each key, value pair is the same
  1234. else:
  1235. if key not in user_def or value != user_def[key]:
  1236. if debug:
  1237. print("value not equal; user_def does not have key")
  1238. print(key)
  1239. print(value)
  1240. if key in user_def:
  1241. print(user_def[key])
  1242. return False
  1243. if debug:
  1244. print('returning true')
  1245. return True
  1246. class OpenShiftCLIConfig(object):
  1247. '''Generic Config'''
  1248. def __init__(self, rname, namespace, kubeconfig, options):
  1249. self.kubeconfig = kubeconfig
  1250. self.name = rname
  1251. self.namespace = namespace
  1252. self._options = options
  1253. @property
  1254. def config_options(self):
  1255. ''' return config options '''
  1256. return self._options
  1257. def to_option_list(self):
  1258. '''return all options as a string'''
  1259. return self.stringify()
  1260. def stringify(self):
  1261. ''' return the options hash as cli params in a string '''
  1262. rval = []
  1263. for key in sorted(self.config_options.keys()):
  1264. data = self.config_options[key]
  1265. if data['include'] \
  1266. and (data['value'] or isinstance(data['value'], int)):
  1267. rval.append('--{}={}'.format(key.replace('_', '-'), data['value']))
  1268. return rval
  1269. # -*- -*- -*- End included fragment: lib/base.py -*- -*- -*-
  1270. # -*- -*- -*- Begin included fragment: lib/service.py -*- -*- -*-
  1271. # pylint: disable=too-many-instance-attributes
  1272. class ServiceConfig(object):
  1273. ''' Handle service options '''
  1274. # pylint: disable=too-many-arguments
  1275. def __init__(self,
  1276. sname,
  1277. namespace,
  1278. ports,
  1279. selector=None,
  1280. labels=None,
  1281. cluster_ip=None,
  1282. portal_ip=None,
  1283. session_affinity=None,
  1284. service_type=None):
  1285. ''' constructor for handling service options '''
  1286. self.name = sname
  1287. self.namespace = namespace
  1288. self.ports = ports
  1289. self.selector = selector
  1290. self.labels = labels
  1291. self.cluster_ip = cluster_ip
  1292. self.portal_ip = portal_ip
  1293. self.session_affinity = session_affinity
  1294. self.service_type = service_type
  1295. self.data = {}
  1296. self.create_dict()
  1297. def create_dict(self):
  1298. ''' instantiates a service dict '''
  1299. self.data['apiVersion'] = 'v1'
  1300. self.data['kind'] = 'Service'
  1301. self.data['metadata'] = {}
  1302. self.data['metadata']['name'] = self.name
  1303. self.data['metadata']['namespace'] = self.namespace
  1304. if self.labels:
  1305. for lab, lab_value in self.labels.items():
  1306. self.data['metadata'][lab] = lab_value
  1307. self.data['spec'] = {}
  1308. if self.ports:
  1309. self.data['spec']['ports'] = self.ports
  1310. else:
  1311. self.data['spec']['ports'] = []
  1312. if self.selector:
  1313. self.data['spec']['selector'] = self.selector
  1314. self.data['spec']['sessionAffinity'] = self.session_affinity or 'None'
  1315. if self.cluster_ip:
  1316. self.data['spec']['clusterIP'] = self.cluster_ip
  1317. if self.portal_ip:
  1318. self.data['spec']['portalIP'] = self.portal_ip
  1319. if self.service_type:
  1320. self.data['spec']['type'] = self.service_type
  1321. # pylint: disable=too-many-instance-attributes,too-many-public-methods
  1322. class Service(Yedit):
  1323. ''' Class to model the oc service object '''
  1324. port_path = "spec.ports"
  1325. portal_ip = "spec.portalIP"
  1326. cluster_ip = "spec.clusterIP"
  1327. selector_path = 'spec.selector'
  1328. kind = 'Service'
  1329. def __init__(self, content):
  1330. '''Service constructor'''
  1331. super(Service, self).__init__(content=content)
  1332. def get_ports(self):
  1333. ''' get a list of ports '''
  1334. return self.get(Service.port_path) or []
  1335. def get_selector(self):
  1336. ''' get the service selector'''
  1337. return self.get(Service.selector_path) or {}
  1338. def add_ports(self, inc_ports):
  1339. ''' add a port object to the ports list '''
  1340. if not isinstance(inc_ports, list):
  1341. inc_ports = [inc_ports]
  1342. ports = self.get_ports()
  1343. if not ports:
  1344. self.put(Service.port_path, inc_ports)
  1345. else:
  1346. ports.extend(inc_ports)
  1347. return True
  1348. def find_ports(self, inc_port):
  1349. ''' find a specific port '''
  1350. for port in self.get_ports():
  1351. if port['port'] == inc_port['port']:
  1352. return port
  1353. return None
  1354. def delete_ports(self, inc_ports):
  1355. ''' remove a port from a service '''
  1356. if not isinstance(inc_ports, list):
  1357. inc_ports = [inc_ports]
  1358. ports = self.get(Service.port_path) or []
  1359. if not ports:
  1360. return True
  1361. removed = False
  1362. for inc_port in inc_ports:
  1363. port = self.find_ports(inc_port)
  1364. if port:
  1365. ports.remove(port)
  1366. removed = True
  1367. return removed
  1368. def add_cluster_ip(self, sip):
  1369. '''add cluster ip'''
  1370. self.put(Service.cluster_ip, sip)
  1371. def add_portal_ip(self, pip):
  1372. '''add cluster ip'''
  1373. self.put(Service.portal_ip, pip)
  1374. # -*- -*- -*- End included fragment: lib/service.py -*- -*- -*-
  1375. # -*- -*- -*- Begin included fragment: lib/deploymentconfig.py -*- -*- -*-
  1376. # pylint: disable=too-many-public-methods
  1377. class DeploymentConfig(Yedit):
  1378. ''' Class to model an openshift DeploymentConfig'''
  1379. default_deployment_config = '''
  1380. apiVersion: v1
  1381. kind: DeploymentConfig
  1382. metadata:
  1383. name: default_dc
  1384. namespace: default
  1385. spec:
  1386. replicas: 0
  1387. selector:
  1388. default_dc: default_dc
  1389. strategy:
  1390. resources: {}
  1391. rollingParams:
  1392. intervalSeconds: 1
  1393. maxSurge: 0
  1394. maxUnavailable: 25%
  1395. timeoutSeconds: 600
  1396. updatePercent: -25
  1397. updatePeriodSeconds: 1
  1398. type: Rolling
  1399. template:
  1400. metadata:
  1401. spec:
  1402. containers:
  1403. - env:
  1404. - name: default
  1405. value: default
  1406. image: default
  1407. imagePullPolicy: IfNotPresent
  1408. name: default_dc
  1409. ports:
  1410. - containerPort: 8000
  1411. hostPort: 8000
  1412. protocol: TCP
  1413. name: default_port
  1414. resources: {}
  1415. terminationMessagePath: /dev/termination-log
  1416. dnsPolicy: ClusterFirst
  1417. hostNetwork: true
  1418. nodeSelector:
  1419. type: compute
  1420. restartPolicy: Always
  1421. securityContext: {}
  1422. serviceAccount: default
  1423. serviceAccountName: default
  1424. terminationGracePeriodSeconds: 30
  1425. triggers:
  1426. - type: ConfigChange
  1427. '''
  1428. replicas_path = "spec.replicas"
  1429. env_path = "spec.template.spec.containers[0].env"
  1430. volumes_path = "spec.template.spec.volumes"
  1431. container_path = "spec.template.spec.containers"
  1432. volume_mounts_path = "spec.template.spec.containers[0].volumeMounts"
  1433. def __init__(self, content=None):
  1434. ''' Constructor for deploymentconfig '''
  1435. if not content:
  1436. content = DeploymentConfig.default_deployment_config
  1437. super(DeploymentConfig, self).__init__(content=content)
  1438. def add_env_value(self, key, value):
  1439. ''' add key, value pair to env array '''
  1440. rval = False
  1441. env = self.get_env_vars()
  1442. if env:
  1443. env.append({'name': key, 'value': value})
  1444. rval = True
  1445. else:
  1446. result = self.put(DeploymentConfig.env_path, {'name': key, 'value': value})
  1447. rval = result[0]
  1448. return rval
  1449. def exists_env_value(self, key, value):
  1450. ''' return whether a key, value pair exists '''
  1451. results = self.get_env_vars()
  1452. if not results:
  1453. return False
  1454. for result in results:
  1455. if result['name'] == key and result['value'] == value:
  1456. return True
  1457. return False
  1458. def exists_env_key(self, key):
  1459. ''' return whether a key, value pair exists '''
  1460. results = self.get_env_vars()
  1461. if not results:
  1462. return False
  1463. for result in results:
  1464. if result['name'] == key:
  1465. return True
  1466. return False
  1467. def get_env_var(self, key):
  1468. '''return a environment variables '''
  1469. results = self.get(DeploymentConfig.env_path) or []
  1470. if not results:
  1471. return None
  1472. for env_var in results:
  1473. if env_var['name'] == key:
  1474. return env_var
  1475. return None
  1476. def get_env_vars(self):
  1477. '''return a environment variables '''
  1478. return self.get(DeploymentConfig.env_path) or []
  1479. def delete_env_var(self, keys):
  1480. '''delete a list of keys '''
  1481. if not isinstance(keys, list):
  1482. keys = [keys]
  1483. env_vars_array = self.get_env_vars()
  1484. modified = False
  1485. idx = None
  1486. for key in keys:
  1487. for env_idx, env_var in enumerate(env_vars_array):
  1488. if env_var['name'] == key:
  1489. idx = env_idx
  1490. break
  1491. if idx:
  1492. modified = True
  1493. del env_vars_array[idx]
  1494. if modified:
  1495. return True
  1496. return False
  1497. def update_env_var(self, key, value):
  1498. '''place an env in the env var list'''
  1499. env_vars_array = self.get_env_vars()
  1500. idx = None
  1501. for env_idx, env_var in enumerate(env_vars_array):
  1502. if env_var['name'] == key:
  1503. idx = env_idx
  1504. break
  1505. if idx:
  1506. env_vars_array[idx]['value'] = value
  1507. else:
  1508. self.add_env_value(key, value)
  1509. return True
  1510. def exists_volume_mount(self, volume_mount):
  1511. ''' return whether a volume mount exists '''
  1512. exist_volume_mounts = self.get_volume_mounts()
  1513. if not exist_volume_mounts:
  1514. return False
  1515. volume_mount_found = False
  1516. for exist_volume_mount in exist_volume_mounts:
  1517. if exist_volume_mount['name'] == volume_mount['name']:
  1518. volume_mount_found = True
  1519. break
  1520. return volume_mount_found
  1521. def exists_volume(self, volume):
  1522. ''' return whether a volume exists '''
  1523. exist_volumes = self.get_volumes()
  1524. volume_found = False
  1525. for exist_volume in exist_volumes:
  1526. if exist_volume['name'] == volume['name']:
  1527. volume_found = True
  1528. break
  1529. return volume_found
  1530. def find_volume_by_name(self, volume, mounts=False):
  1531. ''' return the index of a volume '''
  1532. volumes = []
  1533. if mounts:
  1534. volumes = self.get_volume_mounts()
  1535. else:
  1536. volumes = self.get_volumes()
  1537. for exist_volume in volumes:
  1538. if exist_volume['name'] == volume['name']:
  1539. return exist_volume
  1540. return None
  1541. def get_replicas(self):
  1542. ''' return replicas setting '''
  1543. return self.get(DeploymentConfig.replicas_path)
  1544. def get_volume_mounts(self):
  1545. '''return volume mount information '''
  1546. return self.get_volumes(mounts=True)
  1547. def get_volumes(self, mounts=False):
  1548. '''return volume mount information '''
  1549. if mounts:
  1550. return self.get(DeploymentConfig.volume_mounts_path) or []
  1551. return self.get(DeploymentConfig.volumes_path) or []
  1552. def delete_volume_by_name(self, volume):
  1553. '''delete a volume '''
  1554. modified = False
  1555. exist_volume_mounts = self.get_volume_mounts()
  1556. exist_volumes = self.get_volumes()
  1557. del_idx = None
  1558. for idx, exist_volume in enumerate(exist_volumes):
  1559. if 'name' in exist_volume and exist_volume['name'] == volume['name']:
  1560. del_idx = idx
  1561. break
  1562. if del_idx != None:
  1563. del exist_volumes[del_idx]
  1564. modified = True
  1565. del_idx = None
  1566. for idx, exist_volume_mount in enumerate(exist_volume_mounts):
  1567. if 'name' in exist_volume_mount and exist_volume_mount['name'] == volume['name']:
  1568. del_idx = idx
  1569. break
  1570. if del_idx != None:
  1571. del exist_volume_mounts[idx]
  1572. modified = True
  1573. return modified
  1574. def add_volume_mount(self, volume_mount):
  1575. ''' add a volume or volume mount to the proper location '''
  1576. exist_volume_mounts = self.get_volume_mounts()
  1577. if not exist_volume_mounts and volume_mount:
  1578. self.put(DeploymentConfig.volume_mounts_path, [volume_mount])
  1579. else:
  1580. exist_volume_mounts.append(volume_mount)
  1581. def add_volume(self, volume):
  1582. ''' add a volume or volume mount to the proper location '''
  1583. exist_volumes = self.get_volumes()
  1584. if not volume:
  1585. return
  1586. if not exist_volumes:
  1587. self.put(DeploymentConfig.volumes_path, [volume])
  1588. else:
  1589. exist_volumes.append(volume)
  1590. def update_replicas(self, replicas):
  1591. ''' update replicas value '''
  1592. self.put(DeploymentConfig.replicas_path, replicas)
  1593. def update_volume(self, volume):
  1594. '''place an env in the env var list'''
  1595. exist_volumes = self.get_volumes()
  1596. if not volume:
  1597. return False
  1598. # update the volume
  1599. update_idx = None
  1600. for idx, exist_vol in enumerate(exist_volumes):
  1601. if exist_vol['name'] == volume['name']:
  1602. update_idx = idx
  1603. break
  1604. if update_idx != None:
  1605. exist_volumes[update_idx] = volume
  1606. else:
  1607. self.add_volume(volume)
  1608. return True
  1609. def update_volume_mount(self, volume_mount):
  1610. '''place an env in the env var list'''
  1611. modified = False
  1612. exist_volume_mounts = self.get_volume_mounts()
  1613. if not volume_mount:
  1614. return False
  1615. # update the volume mount
  1616. for exist_vol_mount in exist_volume_mounts:
  1617. if exist_vol_mount['name'] == volume_mount['name']:
  1618. if 'mountPath' in exist_vol_mount and \
  1619. str(exist_vol_mount['mountPath']) != str(volume_mount['mountPath']):
  1620. exist_vol_mount['mountPath'] = volume_mount['mountPath']
  1621. modified = True
  1622. break
  1623. if not modified:
  1624. self.add_volume_mount(volume_mount)
  1625. modified = True
  1626. return modified
  1627. def needs_update_volume(self, volume, volume_mount):
  1628. ''' verify a volume update is needed '''
  1629. exist_volume = self.find_volume_by_name(volume)
  1630. exist_volume_mount = self.find_volume_by_name(volume, mounts=True)
  1631. results = []
  1632. results.append(exist_volume['name'] == volume['name'])
  1633. if 'secret' in volume:
  1634. results.append('secret' in exist_volume)
  1635. results.append(exist_volume['secret']['secretName'] == volume['secret']['secretName'])
  1636. results.append(exist_volume_mount['name'] == volume_mount['name'])
  1637. results.append(exist_volume_mount['mountPath'] == volume_mount['mountPath'])
  1638. elif 'emptyDir' in volume:
  1639. results.append(exist_volume_mount['name'] == volume['name'])
  1640. results.append(exist_volume_mount['mountPath'] == volume_mount['mountPath'])
  1641. elif 'persistentVolumeClaim' in volume:
  1642. pvc = 'persistentVolumeClaim'
  1643. results.append(pvc in exist_volume)
  1644. if results[-1]:
  1645. results.append(exist_volume[pvc]['claimName'] == volume[pvc]['claimName'])
  1646. if 'claimSize' in volume[pvc]:
  1647. results.append(exist_volume[pvc]['claimSize'] == volume[pvc]['claimSize'])
  1648. elif 'hostpath' in volume:
  1649. results.append('hostPath' in exist_volume)
  1650. results.append(exist_volume['hostPath']['path'] == volume_mount['mountPath'])
  1651. return not all(results)
  1652. def needs_update_replicas(self, replicas):
  1653. ''' verify whether a replica update is needed '''
  1654. current_reps = self.get(DeploymentConfig.replicas_path)
  1655. return not current_reps == replicas
  1656. # -*- -*- -*- End included fragment: lib/deploymentconfig.py -*- -*- -*-
  1657. # -*- -*- -*- Begin included fragment: lib/serviceaccount.py -*- -*- -*-
  1658. class ServiceAccountConfig(object):
  1659. '''Service account config class
  1660. This class stores the options and returns a default service account
  1661. '''
  1662. # pylint: disable=too-many-arguments
  1663. def __init__(self, sname, namespace, kubeconfig, secrets=None, image_pull_secrets=None):
  1664. self.name = sname
  1665. self.kubeconfig = kubeconfig
  1666. self.namespace = namespace
  1667. self.secrets = secrets or []
  1668. self.image_pull_secrets = image_pull_secrets or []
  1669. self.data = {}
  1670. self.create_dict()
  1671. def create_dict(self):
  1672. ''' instantiate a properly structured volume '''
  1673. self.data['apiVersion'] = 'v1'
  1674. self.data['kind'] = 'ServiceAccount'
  1675. self.data['metadata'] = {}
  1676. self.data['metadata']['name'] = self.name
  1677. self.data['metadata']['namespace'] = self.namespace
  1678. self.data['secrets'] = []
  1679. if self.secrets:
  1680. for sec in self.secrets:
  1681. self.data['secrets'].append({"name": sec})
  1682. self.data['imagePullSecrets'] = []
  1683. if self.image_pull_secrets:
  1684. for sec in self.image_pull_secrets:
  1685. self.data['imagePullSecrets'].append({"name": sec})
  1686. class ServiceAccount(Yedit):
  1687. ''' Class to wrap the oc command line tools '''
  1688. image_pull_secrets_path = "imagePullSecrets"
  1689. secrets_path = "secrets"
  1690. def __init__(self, content):
  1691. '''ServiceAccount constructor'''
  1692. super(ServiceAccount, self).__init__(content=content)
  1693. self._secrets = None
  1694. self._image_pull_secrets = None
  1695. @property
  1696. def image_pull_secrets(self):
  1697. ''' property for image_pull_secrets '''
  1698. if self._image_pull_secrets is None:
  1699. self._image_pull_secrets = self.get(ServiceAccount.image_pull_secrets_path) or []
  1700. return self._image_pull_secrets
  1701. @image_pull_secrets.setter
  1702. def image_pull_secrets(self, secrets):
  1703. ''' property for secrets '''
  1704. self._image_pull_secrets = secrets
  1705. @property
  1706. def secrets(self):
  1707. ''' property for secrets '''
  1708. if not self._secrets:
  1709. self._secrets = self.get(ServiceAccount.secrets_path) or []
  1710. return self._secrets
  1711. @secrets.setter
  1712. def secrets(self, secrets):
  1713. ''' property for secrets '''
  1714. self._secrets = secrets
  1715. def delete_secret(self, inc_secret):
  1716. ''' remove a secret '''
  1717. remove_idx = None
  1718. for idx, sec in enumerate(self.secrets):
  1719. if sec['name'] == inc_secret:
  1720. remove_idx = idx
  1721. break
  1722. if remove_idx:
  1723. del self.secrets[remove_idx]
  1724. return True
  1725. return False
  1726. def delete_image_pull_secret(self, inc_secret):
  1727. ''' remove a image_pull_secret '''
  1728. remove_idx = None
  1729. for idx, sec in enumerate(self.image_pull_secrets):
  1730. if sec['name'] == inc_secret:
  1731. remove_idx = idx
  1732. break
  1733. if remove_idx:
  1734. del self.image_pull_secrets[remove_idx]
  1735. return True
  1736. return False
  1737. def find_secret(self, inc_secret):
  1738. '''find secret'''
  1739. for secret in self.secrets:
  1740. if secret['name'] == inc_secret:
  1741. return secret
  1742. return None
  1743. def find_image_pull_secret(self, inc_secret):
  1744. '''find secret'''
  1745. for secret in self.image_pull_secrets:
  1746. if secret['name'] == inc_secret:
  1747. return secret
  1748. return None
  1749. def add_secret(self, inc_secret):
  1750. '''add secret'''
  1751. if self.secrets:
  1752. self.secrets.append({"name": inc_secret}) # pylint: disable=no-member
  1753. else:
  1754. self.put(ServiceAccount.secrets_path, [{"name": inc_secret}])
  1755. def add_image_pull_secret(self, inc_secret):
  1756. '''add image_pull_secret'''
  1757. if self.image_pull_secrets:
  1758. self.image_pull_secrets.append({"name": inc_secret}) # pylint: disable=no-member
  1759. else:
  1760. self.put(ServiceAccount.image_pull_secrets_path, [{"name": inc_secret}])
  1761. # -*- -*- -*- End included fragment: lib/serviceaccount.py -*- -*- -*-
  1762. # -*- -*- -*- Begin included fragment: lib/secret.py -*- -*- -*-
  1763. # pylint: disable=too-many-instance-attributes
  1764. class SecretConfig(object):
  1765. ''' Handle secret options '''
  1766. # pylint: disable=too-many-arguments
  1767. def __init__(self,
  1768. sname,
  1769. namespace,
  1770. kubeconfig,
  1771. secrets=None):
  1772. ''' constructor for handling secret options '''
  1773. self.kubeconfig = kubeconfig
  1774. self.name = sname
  1775. self.namespace = namespace
  1776. self.secrets = secrets
  1777. self.data = {}
  1778. self.create_dict()
  1779. def create_dict(self):
  1780. ''' assign the correct properties for a secret dict '''
  1781. self.data['apiVersion'] = 'v1'
  1782. self.data['kind'] = 'Secret'
  1783. self.data['metadata'] = {}
  1784. self.data['metadata']['name'] = self.name
  1785. self.data['metadata']['namespace'] = self.namespace
  1786. self.data['data'] = {}
  1787. if self.secrets:
  1788. for key, value in self.secrets.items():
  1789. self.data['data'][key] = value
  1790. # pylint: disable=too-many-instance-attributes
  1791. class Secret(Yedit):
  1792. ''' Class to wrap the oc command line tools '''
  1793. secret_path = "data"
  1794. kind = 'secret'
  1795. def __init__(self, content):
  1796. '''secret constructor'''
  1797. super(Secret, self).__init__(content=content)
  1798. self._secrets = None
  1799. @property
  1800. def secrets(self):
  1801. '''secret property getter'''
  1802. if self._secrets is None:
  1803. self._secrets = self.get_secrets()
  1804. return self._secrets
  1805. @secrets.setter
  1806. def secrets(self):
  1807. '''secret property setter'''
  1808. if self._secrets is None:
  1809. self._secrets = self.get_secrets()
  1810. return self._secrets
  1811. def get_secrets(self):
  1812. ''' returns all of the defined secrets '''
  1813. return self.get(Secret.secret_path) or {}
  1814. def add_secret(self, key, value):
  1815. ''' add a secret '''
  1816. if self.secrets:
  1817. self.secrets[key] = value
  1818. else:
  1819. self.put(Secret.secret_path, {key: value})
  1820. return True
  1821. def delete_secret(self, key):
  1822. ''' delete secret'''
  1823. try:
  1824. del self.secrets[key]
  1825. except KeyError as _:
  1826. return False
  1827. return True
  1828. def find_secret(self, key):
  1829. ''' find secret'''
  1830. rval = None
  1831. try:
  1832. rval = self.secrets[key]
  1833. except KeyError as _:
  1834. return None
  1835. return {'key': key, 'value': rval}
  1836. def update_secret(self, key, value):
  1837. ''' update a secret'''
  1838. if key in self.secrets:
  1839. self.secrets[key] = value
  1840. else:
  1841. self.add_secret(key, value)
  1842. return True
  1843. # -*- -*- -*- End included fragment: lib/secret.py -*- -*- -*-
  1844. # -*- -*- -*- Begin included fragment: lib/rolebinding.py -*- -*- -*-
  1845. # pylint: disable=too-many-instance-attributes
  1846. class RoleBindingConfig(object):
  1847. ''' Handle rolebinding config '''
  1848. # pylint: disable=too-many-arguments
  1849. def __init__(self,
  1850. name,
  1851. namespace,
  1852. kubeconfig,
  1853. group_names=None,
  1854. role_ref=None,
  1855. subjects=None,
  1856. usernames=None):
  1857. ''' constructor for handling rolebinding options '''
  1858. self.kubeconfig = kubeconfig
  1859. self.name = name
  1860. self.namespace = namespace
  1861. self.group_names = group_names
  1862. self.role_ref = role_ref
  1863. self.subjects = subjects
  1864. self.usernames = usernames
  1865. self.data = {}
  1866. self.create_dict()
  1867. def create_dict(self):
  1868. ''' create a default rolebinding as a dict '''
  1869. self.data['apiVersion'] = 'v1'
  1870. self.data['kind'] = 'RoleBinding'
  1871. self.data['groupNames'] = self.group_names
  1872. self.data['metadata']['name'] = self.name
  1873. self.data['metadata']['namespace'] = self.namespace
  1874. self.data['roleRef'] = self.role_ref
  1875. self.data['subjects'] = self.subjects
  1876. self.data['userNames'] = self.usernames
  1877. # pylint: disable=too-many-instance-attributes,too-many-public-methods
  1878. class RoleBinding(Yedit):
  1879. ''' Class to model a rolebinding openshift object'''
  1880. group_names_path = "groupNames"
  1881. role_ref_path = "roleRef"
  1882. subjects_path = "subjects"
  1883. user_names_path = "userNames"
  1884. kind = 'RoleBinding'
  1885. def __init__(self, content):
  1886. '''RoleBinding constructor'''
  1887. super(RoleBinding, self).__init__(content=content)
  1888. self._subjects = None
  1889. self._role_ref = None
  1890. self._group_names = None
  1891. self._user_names = None
  1892. @property
  1893. def subjects(self):
  1894. ''' subjects property '''
  1895. if self._subjects is None:
  1896. self._subjects = self.get_subjects()
  1897. return self._subjects
  1898. @subjects.setter
  1899. def subjects(self, data):
  1900. ''' subjects property setter'''
  1901. self._subjects = data
  1902. @property
  1903. def role_ref(self):
  1904. ''' role_ref property '''
  1905. if self._role_ref is None:
  1906. self._role_ref = self.get_role_ref()
  1907. return self._role_ref
  1908. @role_ref.setter
  1909. def role_ref(self, data):
  1910. ''' role_ref property setter'''
  1911. self._role_ref = data
  1912. @property
  1913. def group_names(self):
  1914. ''' group_names property '''
  1915. if self._group_names is None:
  1916. self._group_names = self.get_group_names()
  1917. return self._group_names
  1918. @group_names.setter
  1919. def group_names(self, data):
  1920. ''' group_names property setter'''
  1921. self._group_names = data
  1922. @property
  1923. def user_names(self):
  1924. ''' user_names property '''
  1925. if self._user_names is None:
  1926. self._user_names = self.get_user_names()
  1927. return self._user_names
  1928. @user_names.setter
  1929. def user_names(self, data):
  1930. ''' user_names property setter'''
  1931. self._user_names = data
  1932. def get_group_names(self):
  1933. ''' return groupNames '''
  1934. return self.get(RoleBinding.group_names_path) or []
  1935. def get_user_names(self):
  1936. ''' return usernames '''
  1937. return self.get(RoleBinding.user_names_path) or []
  1938. def get_role_ref(self):
  1939. ''' return role_ref '''
  1940. return self.get(RoleBinding.role_ref_path) or {}
  1941. def get_subjects(self):
  1942. ''' return subjects '''
  1943. return self.get(RoleBinding.subjects_path) or []
  1944. #### ADD #####
  1945. def add_subject(self, inc_subject):
  1946. ''' add a subject '''
  1947. if self.subjects:
  1948. # pylint: disable=no-member
  1949. self.subjects.append(inc_subject)
  1950. else:
  1951. self.put(RoleBinding.subjects_path, [inc_subject])
  1952. return True
  1953. def add_role_ref(self, inc_role_ref):
  1954. ''' add a role_ref '''
  1955. if not self.role_ref:
  1956. self.put(RoleBinding.role_ref_path, {"name": inc_role_ref})
  1957. return True
  1958. return False
  1959. def add_group_names(self, inc_group_names):
  1960. ''' add a group_names '''
  1961. if self.group_names:
  1962. # pylint: disable=no-member
  1963. self.group_names.append(inc_group_names)
  1964. else:
  1965. self.put(RoleBinding.group_names_path, [inc_group_names])
  1966. return True
  1967. def add_user_name(self, inc_user_name):
  1968. ''' add a username '''
  1969. if self.user_names:
  1970. # pylint: disable=no-member
  1971. self.user_names.append(inc_user_name)
  1972. else:
  1973. self.put(RoleBinding.user_names_path, [inc_user_name])
  1974. return True
  1975. #### /ADD #####
  1976. #### Remove #####
  1977. def remove_subject(self, inc_subject):
  1978. ''' remove a subject '''
  1979. try:
  1980. # pylint: disable=no-member
  1981. self.subjects.remove(inc_subject)
  1982. except ValueError as _:
  1983. return False
  1984. return True
  1985. def remove_role_ref(self, inc_role_ref):
  1986. ''' remove a role_ref '''
  1987. if self.role_ref and self.role_ref['name'] == inc_role_ref:
  1988. del self.role_ref['name']
  1989. return True
  1990. return False
  1991. def remove_group_name(self, inc_group_name):
  1992. ''' remove a groupname '''
  1993. try:
  1994. # pylint: disable=no-member
  1995. self.group_names.remove(inc_group_name)
  1996. except ValueError as _:
  1997. return False
  1998. return True
  1999. def remove_user_name(self, inc_user_name):
  2000. ''' remove a username '''
  2001. try:
  2002. # pylint: disable=no-member
  2003. self.user_names.remove(inc_user_name)
  2004. except ValueError as _:
  2005. return False
  2006. return True
  2007. #### /REMOVE #####
  2008. #### UPDATE #####
  2009. def update_subject(self, inc_subject):
  2010. ''' update a subject '''
  2011. try:
  2012. # pylint: disable=no-member
  2013. index = self.subjects.index(inc_subject)
  2014. except ValueError as _:
  2015. return self.add_subject(inc_subject)
  2016. self.subjects[index] = inc_subject
  2017. return True
  2018. def update_group_name(self, inc_group_name):
  2019. ''' update a groupname '''
  2020. try:
  2021. # pylint: disable=no-member
  2022. index = self.group_names.index(inc_group_name)
  2023. except ValueError as _:
  2024. return self.add_group_names(inc_group_name)
  2025. self.group_names[index] = inc_group_name
  2026. return True
  2027. def update_user_name(self, inc_user_name):
  2028. ''' update a username '''
  2029. try:
  2030. # pylint: disable=no-member
  2031. index = self.user_names.index(inc_user_name)
  2032. except ValueError as _:
  2033. return self.add_user_name(inc_user_name)
  2034. self.user_names[index] = inc_user_name
  2035. return True
  2036. def update_role_ref(self, inc_role_ref):
  2037. ''' update a role_ref '''
  2038. self.role_ref['name'] = inc_role_ref
  2039. return True
  2040. #### /UPDATE #####
  2041. #### FIND ####
  2042. def find_subject(self, inc_subject):
  2043. ''' find a subject '''
  2044. index = None
  2045. try:
  2046. # pylint: disable=no-member
  2047. index = self.subjects.index(inc_subject)
  2048. except ValueError as _:
  2049. return index
  2050. return index
  2051. def find_group_name(self, inc_group_name):
  2052. ''' find a group_name '''
  2053. index = None
  2054. try:
  2055. # pylint: disable=no-member
  2056. index = self.group_names.index(inc_group_name)
  2057. except ValueError as _:
  2058. return index
  2059. return index
  2060. def find_user_name(self, inc_user_name):
  2061. ''' find a user_name '''
  2062. index = None
  2063. try:
  2064. # pylint: disable=no-member
  2065. index = self.user_names.index(inc_user_name)
  2066. except ValueError as _:
  2067. return index
  2068. return index
  2069. def find_role_ref(self, inc_role_ref):
  2070. ''' find a user_name '''
  2071. if self.role_ref and self.role_ref['name'] == inc_role_ref['name']:
  2072. return self.role_ref
  2073. return None
  2074. # -*- -*- -*- End included fragment: lib/rolebinding.py -*- -*- -*-
  2075. # -*- -*- -*- Begin included fragment: class/oc_adm_router.py -*- -*- -*-
  2076. class RouterException(Exception):
  2077. ''' Router exception'''
  2078. pass
  2079. class RouterConfig(OpenShiftCLIConfig):
  2080. ''' RouterConfig is a DTO for the router. '''
  2081. def __init__(self, rname, namespace, kubeconfig, router_options):
  2082. super(RouterConfig, self).__init__(rname, namespace, kubeconfig, router_options)
  2083. class Router(OpenShiftCLI):
  2084. ''' Class to wrap the oc command line tools '''
  2085. def __init__(self,
  2086. router_config,
  2087. verbose=False):
  2088. ''' Constructor for OpenshiftOC
  2089. a router consists of 3 or more parts
  2090. - dc/router
  2091. - svc/router
  2092. - sa/router
  2093. - secret/router-certs
  2094. - clusterrolebinding/router-router-role
  2095. '''
  2096. super(Router, self).__init__('default', router_config.kubeconfig, verbose)
  2097. self.config = router_config
  2098. self.verbose = verbose
  2099. self.router_parts = [{'kind': 'dc', 'name': self.config.name},
  2100. {'kind': 'svc', 'name': self.config.name},
  2101. {'kind': 'sa', 'name': self.config.config_options['service_account']['value']},
  2102. {'kind': 'secret', 'name': self.config.name + '-certs'},
  2103. {'kind': 'clusterrolebinding', 'name': 'router-' + self.config.name + '-role'},
  2104. ]
  2105. self.__prepared_router = None
  2106. self.dconfig = None
  2107. self.svc = None
  2108. self._secret = None
  2109. self._serviceaccount = None
  2110. self._rolebinding = None
  2111. @property
  2112. def prepared_router(self):
  2113. ''' property for the prepared router'''
  2114. if self.__prepared_router is None:
  2115. results = self._prepare_router()
  2116. if not results or 'returncode' in results and results['returncode'] != 0:
  2117. if 'stderr' in results:
  2118. raise RouterException('Could not perform router preparation: %s' % results['stderr'])
  2119. raise RouterException('Could not perform router preparation.')
  2120. self.__prepared_router = results
  2121. return self.__prepared_router
  2122. @prepared_router.setter
  2123. def prepared_router(self, obj):
  2124. '''setter for the prepared_router'''
  2125. self.__prepared_router = obj
  2126. @property
  2127. def deploymentconfig(self):
  2128. ''' property deploymentconfig'''
  2129. return self.dconfig
  2130. @deploymentconfig.setter
  2131. def deploymentconfig(self, config):
  2132. ''' setter for property deploymentconfig '''
  2133. self.dconfig = config
  2134. @property
  2135. def service(self):
  2136. ''' property for service '''
  2137. return self.svc
  2138. @service.setter
  2139. def service(self, config):
  2140. ''' setter for property service '''
  2141. self.svc = config
  2142. @property
  2143. def secret(self):
  2144. ''' property secret '''
  2145. return self._secret
  2146. @secret.setter
  2147. def secret(self, config):
  2148. ''' setter for property secret '''
  2149. self._secret = config
  2150. @property
  2151. def serviceaccount(self):
  2152. ''' property for serviceaccount '''
  2153. return self._serviceaccount
  2154. @serviceaccount.setter
  2155. def serviceaccount(self, config):
  2156. ''' setter for property serviceaccount '''
  2157. self._serviceaccount = config
  2158. @property
  2159. def rolebinding(self):
  2160. ''' property rolebinding '''
  2161. return self._rolebinding
  2162. @rolebinding.setter
  2163. def rolebinding(self, config):
  2164. ''' setter for property rolebinding '''
  2165. self._rolebinding = config
  2166. def get_object_by_kind(self, kind):
  2167. '''return the current object kind by name'''
  2168. if re.match("^(dc|deploymentconfig)$", kind, flags=re.IGNORECASE):
  2169. return self.deploymentconfig
  2170. elif re.match("^(svc|service)$", kind, flags=re.IGNORECASE):
  2171. return self.service
  2172. elif re.match("^(sa|serviceaccount)$", kind, flags=re.IGNORECASE):
  2173. return self.serviceaccount
  2174. elif re.match("secret", kind, flags=re.IGNORECASE):
  2175. return self.secret
  2176. elif re.match("clusterrolebinding", kind, flags=re.IGNORECASE):
  2177. return self.rolebinding
  2178. return None
  2179. def get(self):
  2180. ''' return the self.router_parts '''
  2181. self.service = None
  2182. self.deploymentconfig = None
  2183. self.serviceaccount = None
  2184. self.secret = None
  2185. self.rolebinding = None
  2186. for part in self.router_parts:
  2187. result = self._get(part['kind'], rname=part['name'])
  2188. if result['returncode'] == 0 and part['kind'] == 'dc':
  2189. self.deploymentconfig = DeploymentConfig(result['results'][0])
  2190. elif result['returncode'] == 0 and part['kind'] == 'svc':
  2191. self.service = Service(content=result['results'][0])
  2192. elif result['returncode'] == 0 and part['kind'] == 'sa':
  2193. self.serviceaccount = ServiceAccount(content=result['results'][0])
  2194. elif result['returncode'] == 0 and part['kind'] == 'secret':
  2195. self.secret = Secret(content=result['results'][0])
  2196. elif result['returncode'] == 0 and part['kind'] == 'clusterrolebinding':
  2197. self.rolebinding = RoleBinding(content=result['results'][0])
  2198. return {'deploymentconfig': self.deploymentconfig,
  2199. 'service': self.service,
  2200. 'serviceaccount': self.serviceaccount,
  2201. 'secret': self.secret,
  2202. 'clusterrolebinding': self.rolebinding,
  2203. }
  2204. def exists(self):
  2205. '''return a whether svc or dc exists '''
  2206. if self.deploymentconfig and self.service and self.secret and self.serviceaccount:
  2207. return True
  2208. return False
  2209. def delete(self):
  2210. '''return all pods '''
  2211. parts = []
  2212. for part in self.router_parts:
  2213. parts.append(self._delete(part['kind'], part['name']))
  2214. rval = 0
  2215. for part in parts:
  2216. if part['returncode'] != 0 and not 'already exist' in part['stderr']:
  2217. rval = part['returncode']
  2218. return {'returncode': rval, 'results': parts}
  2219. def add_modifications(self, deploymentconfig):
  2220. '''modify the deployment config'''
  2221. # We want modifications in the form of edits coming in from the module.
  2222. # Let's apply these here
  2223. edit_results = []
  2224. for edit in self.config.config_options['edits'].get('value', []):
  2225. if edit['action'] == 'put':
  2226. edit_results.append(deploymentconfig.put(edit['key'],
  2227. edit['value']))
  2228. if edit['action'] == 'update':
  2229. edit_results.append(deploymentconfig.update(edit['key'],
  2230. edit['value'],
  2231. edit.get('index', None),
  2232. edit.get('curr_value', None)))
  2233. if edit['action'] == 'append':
  2234. edit_results.append(deploymentconfig.append(edit['key'],
  2235. edit['value']))
  2236. if edit_results and not any([res[0] for res in edit_results]):
  2237. return None
  2238. return deploymentconfig
  2239. # pylint: disable=too-many-branches
  2240. def _prepare_router(self):
  2241. '''prepare router for instantiation'''
  2242. # if cacert, key, and cert were passed, combine them into a pem file
  2243. if (self.config.config_options['cacert_file']['value'] and
  2244. self.config.config_options['cert_file']['value'] and
  2245. self.config.config_options['key_file']['value']):
  2246. router_pem = '/tmp/router.pem'
  2247. with open(router_pem, 'w') as rfd:
  2248. rfd.write(open(self.config.config_options['cert_file']['value']).read())
  2249. rfd.write(open(self.config.config_options['key_file']['value']).read())
  2250. if self.config.config_options['cacert_file']['value'] and \
  2251. os.path.exists(self.config.config_options['cacert_file']['value']):
  2252. rfd.write(open(self.config.config_options['cacert_file']['value']).read())
  2253. atexit.register(Utils.cleanup, [router_pem])
  2254. self.config.config_options['default_cert']['value'] = router_pem
  2255. elif self.config.config_options['default_cert']['value'] is None:
  2256. # No certificate was passed to us. do not pass one to oc adm router
  2257. self.config.config_options['default_cert']['include'] = False
  2258. options = self.config.to_option_list()
  2259. cmd = ['router', self.config.name]
  2260. cmd.extend(options)
  2261. cmd.extend(['--dry-run=True', '-o', 'json'])
  2262. results = self.openshift_cmd(cmd, oadm=True, output=True, output_type='json')
  2263. # pylint: disable=maybe-no-member
  2264. if results['returncode'] != 0 or 'items' not in results['results']:
  2265. return results
  2266. oc_objects = {'DeploymentConfig': {'obj': None, 'path': None, 'update': False},
  2267. 'Secret': {'obj': None, 'path': None, 'update': False},
  2268. 'ServiceAccount': {'obj': None, 'path': None, 'update': False},
  2269. 'ClusterRoleBinding': {'obj': None, 'path': None, 'update': False},
  2270. 'Service': {'obj': None, 'path': None, 'update': False},
  2271. }
  2272. # pylint: disable=invalid-sequence-index
  2273. for res in results['results']['items']:
  2274. if res['kind'] == 'DeploymentConfig':
  2275. oc_objects['DeploymentConfig']['obj'] = DeploymentConfig(res)
  2276. elif res['kind'] == 'Service':
  2277. oc_objects['Service']['obj'] = Service(res)
  2278. elif res['kind'] == 'ServiceAccount':
  2279. oc_objects['ServiceAccount']['obj'] = ServiceAccount(res)
  2280. elif res['kind'] == 'Secret':
  2281. oc_objects['Secret']['obj'] = Secret(res)
  2282. elif res['kind'] == 'ClusterRoleBinding':
  2283. oc_objects['ClusterRoleBinding']['obj'] = RoleBinding(res)
  2284. # Currently only deploymentconfig needs updating
  2285. # Verify we got a deploymentconfig
  2286. if not oc_objects['DeploymentConfig']['obj']:
  2287. return results
  2288. # add modifications added
  2289. oc_objects['DeploymentConfig']['obj'] = self.add_modifications(oc_objects['DeploymentConfig']['obj'])
  2290. for oc_type, oc_data in oc_objects.items():
  2291. if oc_data['obj'] is not None:
  2292. oc_data['path'] = Utils.create_tmp_file_from_contents(oc_type, oc_data['obj'].yaml_dict)
  2293. return oc_objects
  2294. def create(self):
  2295. '''Create a router
  2296. This includes the different parts:
  2297. - deploymentconfig
  2298. - service
  2299. - serviceaccount
  2300. - secrets
  2301. - clusterrolebinding
  2302. '''
  2303. results = []
  2304. self.needs_update()
  2305. import time
  2306. # pylint: disable=maybe-no-member
  2307. for kind, oc_data in self.prepared_router.items():
  2308. if oc_data['obj'] is not None:
  2309. time.sleep(1)
  2310. if self.get_object_by_kind(kind) is None:
  2311. results.append(self._create(oc_data['path']))
  2312. elif oc_data['update']:
  2313. results.append(self._replace(oc_data['path']))
  2314. rval = 0
  2315. for result in results:
  2316. if result['returncode'] != 0 and not 'already exist' in result['stderr']:
  2317. rval = result['returncode']
  2318. return {'returncode': rval, 'results': results}
  2319. def update(self):
  2320. '''run update for the router. This performs a replace'''
  2321. results = []
  2322. # pylint: disable=maybe-no-member
  2323. for _, oc_data in self.prepared_router.items():
  2324. if oc_data['update']:
  2325. results.append(self._replace(oc_data['path']))
  2326. rval = 0
  2327. for result in results:
  2328. if result['returncode'] != 0:
  2329. rval = result['returncode']
  2330. return {'returncode': rval, 'results': results}
  2331. # pylint: disable=too-many-return-statements,too-many-branches
  2332. def needs_update(self):
  2333. ''' check to see if we need to update '''
  2334. # ServiceAccount:
  2335. # Need to determine changes from the pregenerated ones from the original
  2336. # Since these are auto generated, we can skip
  2337. skip = ['secrets', 'imagePullSecrets']
  2338. if self.serviceaccount is None or \
  2339. not Utils.check_def_equal(self.prepared_router['ServiceAccount']['obj'].yaml_dict,
  2340. self.serviceaccount.yaml_dict,
  2341. skip_keys=skip,
  2342. debug=self.verbose):
  2343. self.prepared_router['ServiceAccount']['update'] = True
  2344. # Secret:
  2345. # See if one was generated from our dry-run and verify it if needed
  2346. if self.prepared_router['Secret']['obj']:
  2347. if not self.secret:
  2348. self.prepared_router['Secret']['update'] = True
  2349. if self.secret is None or \
  2350. not Utils.check_def_equal(self.prepared_router['Secret']['obj'].yaml_dict,
  2351. self.secret.yaml_dict,
  2352. skip_keys=skip,
  2353. debug=self.verbose):
  2354. self.prepared_router['Secret']['update'] = True
  2355. # Service:
  2356. # Fix the ports to have protocol=TCP
  2357. for port in self.prepared_router['Service']['obj'].get('spec.ports'):
  2358. port['protocol'] = 'TCP'
  2359. skip = ['portalIP', 'clusterIP', 'sessionAffinity', 'type']
  2360. if self.service is None or \
  2361. not Utils.check_def_equal(self.prepared_router['Service']['obj'].yaml_dict,
  2362. self.service.yaml_dict,
  2363. skip_keys=skip,
  2364. debug=self.verbose):
  2365. self.prepared_router['Service']['update'] = True
  2366. # DeploymentConfig:
  2367. # Router needs some exceptions.
  2368. # We do not want to check the autogenerated password for stats admin
  2369. if self.deploymentconfig is not None:
  2370. if not self.config.config_options['stats_password']['value']:
  2371. for idx, env_var in enumerate(self.prepared_router['DeploymentConfig']['obj'].get(\
  2372. 'spec.template.spec.containers[0].env') or []):
  2373. if env_var['name'] == 'STATS_PASSWORD':
  2374. env_var['value'] = \
  2375. self.deploymentconfig.get('spec.template.spec.containers[0].env[%s].value' % idx)
  2376. break
  2377. # dry-run doesn't add the protocol to the ports section. We will manually do that.
  2378. for idx, port in enumerate(self.prepared_router['DeploymentConfig']['obj'].get(\
  2379. 'spec.template.spec.containers[0].ports') or []):
  2380. if not 'protocol' in port:
  2381. port['protocol'] = 'TCP'
  2382. # These are different when generating
  2383. skip = ['dnsPolicy',
  2384. 'terminationGracePeriodSeconds',
  2385. 'restartPolicy', 'timeoutSeconds',
  2386. 'livenessProbe', 'readinessProbe',
  2387. 'terminationMessagePath', 'hostPort',
  2388. 'defaultMode',
  2389. ]
  2390. if self.deploymentconfig is None or \
  2391. not Utils.check_def_equal(self.prepared_router['DeploymentConfig']['obj'].yaml_dict,
  2392. self.deploymentconfig.yaml_dict,
  2393. skip_keys=skip,
  2394. debug=self.verbose):
  2395. self.prepared_router['DeploymentConfig']['update'] = True
  2396. # Check if any of the parts need updating, if so, return True
  2397. # else, no need to update
  2398. # pylint: disable=no-member
  2399. return any([self.prepared_router[oc_type]['update'] for oc_type in self.prepared_router.keys()])
  2400. @staticmethod
  2401. def run_ansible(params, check_mode):
  2402. '''run ansible idempotent code'''
  2403. rconfig = RouterConfig(params['name'],
  2404. params['namespace'],
  2405. params['kubeconfig'],
  2406. {'default_cert': {'value': params['default_cert'], 'include': True},
  2407. 'cert_file': {'value': params['cert_file'], 'include': False},
  2408. 'key_file': {'value': params['key_file'], 'include': False},
  2409. 'images': {'value': params['images'], 'include': True},
  2410. 'latest_images': {'value': params['latest_images'], 'include': True},
  2411. 'labels': {'value': params['labels'], 'include': True},
  2412. 'ports': {'value': ','.join(params['ports']), 'include': True},
  2413. 'replicas': {'value': params['replicas'], 'include': True},
  2414. 'selector': {'value': params['selector'], 'include': True},
  2415. 'service_account': {'value': params['service_account'], 'include': True},
  2416. 'router_type': {'value': params['router_type'], 'include': False},
  2417. 'host_network': {'value': params['host_network'], 'include': True},
  2418. 'external_host': {'value': params['external_host'], 'include': True},
  2419. 'external_host_vserver': {'value': params['external_host_vserver'],
  2420. 'include': True},
  2421. 'external_host_insecure': {'value': params['external_host_insecure'],
  2422. 'include': True},
  2423. 'external_host_partition_path': {'value': params['external_host_partition_path'],
  2424. 'include': True},
  2425. 'external_host_username': {'value': params['external_host_username'],
  2426. 'include': True},
  2427. 'external_host_password': {'value': params['external_host_password'],
  2428. 'include': True},
  2429. 'external_host_private_key': {'value': params['external_host_private_key'],
  2430. 'include': True},
  2431. 'expose_metrics': {'value': params['expose_metrics'], 'include': True},
  2432. 'metrics_image': {'value': params['metrics_image'], 'include': True},
  2433. 'stats_user': {'value': params['stats_user'], 'include': True},
  2434. 'stats_password': {'value': params['stats_password'], 'include': True},
  2435. 'stats_port': {'value': params['stats_port'], 'include': True},
  2436. # extra
  2437. 'cacert_file': {'value': params['cacert_file'], 'include': False},
  2438. # edits
  2439. 'edits': {'value': params['edits'], 'include': False},
  2440. })
  2441. state = params['state']
  2442. ocrouter = Router(rconfig, verbose=params['debug'])
  2443. api_rval = ocrouter.get()
  2444. ########
  2445. # get
  2446. ########
  2447. if state == 'list':
  2448. return {'changed': False, 'results': api_rval, 'state': state}
  2449. ########
  2450. # Delete
  2451. ########
  2452. if state == 'absent':
  2453. if not ocrouter.exists():
  2454. return {'changed': False, 'state': state}
  2455. if check_mode:
  2456. return {'changed': True, 'msg': 'CHECK_MODE: Would have performed a delete.'}
  2457. # In case of delete we return a list of each object
  2458. # that represents a router and its result in a list
  2459. # pylint: disable=redefined-variable-type
  2460. api_rval = ocrouter.delete()
  2461. return {'changed': True, 'results': api_rval, 'state': state}
  2462. if state == 'present':
  2463. ########
  2464. # Create
  2465. ########
  2466. if not ocrouter.exists():
  2467. if check_mode:
  2468. return {'changed': True, 'msg': 'CHECK_MODE: Would have performed a create.'}
  2469. api_rval = ocrouter.create()
  2470. if api_rval['returncode'] != 0:
  2471. return {'failed': True, 'msg': api_rval}
  2472. return {'changed': True, 'results': api_rval, 'state': state}
  2473. ########
  2474. # Update
  2475. ########
  2476. if not ocrouter.needs_update():
  2477. return {'changed': False, 'state': state}
  2478. if check_mode:
  2479. return {'changed': False, 'msg': 'CHECK_MODE: Would have performed an update.'}
  2480. api_rval = ocrouter.update()
  2481. if api_rval['returncode'] != 0:
  2482. return {'failed': True, 'msg': api_rval}
  2483. return {'changed': True, 'results': api_rval, 'state': state}
  2484. # -*- -*- -*- End included fragment: class/oc_adm_router.py -*- -*- -*-
  2485. # -*- -*- -*- Begin included fragment: ansible/oc_adm_router.py -*- -*- -*-
  2486. def main():
  2487. '''
  2488. ansible oc module for router
  2489. '''
  2490. module = AnsibleModule(
  2491. argument_spec=dict(
  2492. state=dict(default='present', type='str',
  2493. choices=['present', 'absent']),
  2494. debug=dict(default=False, type='bool'),
  2495. namespace=dict(default='default', type='str'),
  2496. name=dict(default='router', type='str'),
  2497. kubeconfig=dict(default='/etc/origin/master/admin.kubeconfig', type='str'),
  2498. default_cert=dict(default=None, type='str'),
  2499. cert_file=dict(default=None, type='str'),
  2500. key_file=dict(default=None, type='str'),
  2501. images=dict(default=None, type='str'), #'openshift3/ose-${component}:${version}'
  2502. latest_images=dict(default=False, type='bool'),
  2503. labels=dict(default=None, type='list'),
  2504. ports=dict(default=['80:80', '443:443'], type='list'),
  2505. replicas=dict(default=1, type='int'),
  2506. selector=dict(default=None, type='str'),
  2507. service_account=dict(default='router', type='str'),
  2508. router_type=dict(default='haproxy-router', type='str'),
  2509. host_network=dict(default=True, type='bool'),
  2510. # external host options
  2511. external_host=dict(default=None, type='str'),
  2512. external_host_vserver=dict(default=None, type='str'),
  2513. external_host_insecure=dict(default=False, type='bool'),
  2514. external_host_partition_path=dict(default=None, type='str'),
  2515. external_host_username=dict(default=None, type='str'),
  2516. external_host_password=dict(default=None, type='str'),
  2517. external_host_private_key=dict(default=None, type='str'),
  2518. # Metrics
  2519. expose_metrics=dict(default=False, type='bool'),
  2520. metrics_image=dict(default=None, type='str'),
  2521. # Stats
  2522. stats_user=dict(default=None, type='str'),
  2523. stats_password=dict(default=None, type='str'),
  2524. stats_port=dict(default=1936, type='int'),
  2525. # extra
  2526. cacert_file=dict(default=None, type='str'),
  2527. # edits
  2528. edits=dict(default=[], type='list'),
  2529. ),
  2530. mutually_exclusive=[["router_type", "images"],
  2531. ["key_file", "default_cert"],
  2532. ["cert_file", "default_cert"],
  2533. ["cacert_file", "default_cert"],
  2534. ],
  2535. required_together=[['cacert_file', 'cert_file', 'key_file']],
  2536. supports_check_mode=True,
  2537. )
  2538. results = Router.run_ansible(module.params, module.check_mode)
  2539. if 'failed' in results:
  2540. module.fail_json(**results)
  2541. module.exit_json(**results)
  2542. if __name__ == '__main__':
  2543. main()
  2544. # -*- -*- -*- End included fragment: ansible/oc_adm_router.py -*- -*- -*-