oc_adm_router.py 102 KB

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