CINXE.COM

<!doctype html><html lang=en class=color-toggle-hidden color-theme=light><head><meta charset=utf-8><script type="text/javascript"> ;window.NREUM||(NREUM={});NREUM.init={distributed_tracing:{enabled:true},privacy:{cookies_enabled:true},ajax:{deny_list:["bam.nr-data.net"]}}; window.NREUM||(NREUM={}),__nr_require=function(t,e,n){function r(n){if(!e[n]){var o=e[n]={exports:{}};t[n][0].call(o.exports,function(e){var o=t[n][1][e];return r(o||e)},o,o.exports)}return e[n].exports}if("function"==typeof __nr_require)return __nr_require;for(var o=0;o<n.length;o++)r(n[o]);return r}({1:[function(t,e,n){function r(t){try{s.console&&console.log(t)}catch(e){}}var o,i=t("ee"),a=t(32),s={};try{o=localStorage.getItem("__nr_flags").split(","),console&&"function"==typeof console.log&&(s.console=!0,o.indexOf("dev")!==-1&&(s.dev=!0),o.indexOf("nr_dev")!==-1&&(s.nrDev=!0))}catch(c){}s.nrDev&&i.on("internal-error",function(t){r(t.stack)}),s.dev&&i.on("fn-err",function(t,e,n){r(n.stack)}),s.dev&&(r("NR AGENT IN DEVELOPMENT MODE"),r("flags: "+a(s,function(t,e){return t}).join(", ")))},{}],2:[function(t,e,n){function r(t,e,n,r,s){try{l?l-=1:o(s||new UncaughtException(t,e,n),!0)}catch(f){try{i("ierr",[f,c.now(),!0])}catch(d){}}return"function"==typeof u&&u.apply(this,a(arguments))}function UncaughtException(t,e,n){this.message=t||"Uncaught error with no additional information",this.sourceURL=e,this.line=n}function o(t,e){var n=e?null:c.now();i("err",[t,n])}var i=t("handle"),a=t(33),s=t("ee"),c=t("loader"),f=t("gos"),u=window.onerror,d=!1,p="nr@seenError";if(!c.disabled){var l=0;c.features.err=!0,t(1),window.onerror=r;try{throw new Error}catch(h){"stack"in h&&(t(14),t(13),"addEventListener"in window&&t(7),c.xhrWrappable&&t(15),d=!0)}s.on("fn-start",function(t,e,n){d&&(l+=1)}),s.on("fn-err",function(t,e,n){d&&!n[p]&&(f(n,p,function(){return!0}),this.thrown=!0,o(n))}),s.on("fn-end",function(){d&&!this.thrown&&l>0&&(l-=1)}),s.on("internal-error",function(t){i("ierr",[t,c.now(),!0])})}},{}],3:[function(t,e,n){var r=t("loader");r.disabled||(r.features.ins=!0)},{}],4:[function(t,e,n){function r(){U++,L=g.hash,this[u]=y.now()}function o(){U--,g.hash!==L&&i(0,!0);var t=y.now();this[h]=~~this[h]+t-this[u],this[d]=t}function i(t,e){E.emit("newURL",[""+g,e])}function a(t,e){t.on(e,function(){this[e]=y.now()})}var s="-start",c="-end",f="-body",u="fn"+s,d="fn"+c,p="cb"+s,l="cb"+c,h="jsTime",m="fetch",v="addEventListener",w=window,g=w.location,y=t("loader");if(w[v]&&y.xhrWrappable&&!y.disabled){var x=t(11),b=t(12),E=t(9),R=t(7),O=t(14),T=t(8),P=t(15),S=t(10),M=t("ee"),N=M.get("tracer"),C=t(23);t(17),y.features.spa=!0;var L,U=0;M.on(u,r),b.on(p,r),S.on(p,r),M.on(d,o),b.on(l,o),S.on(l,o),M.buffer([u,d,"xhr-resolved"]),R.buffer([u]),O.buffer(["setTimeout"+c,"clearTimeout"+s,u]),P.buffer([u,"new-xhr","send-xhr"+s]),T.buffer([m+s,m+"-done",m+f+s,m+f+c]),E.buffer(["newURL"]),x.buffer([u]),b.buffer(["propagate",p,l,"executor-err","resolve"+s]),N.buffer([u,"no-"+u]),S.buffer(["new-jsonp","cb-start","jsonp-error","jsonp-end"]),a(T,m+s),a(T,m+"-done"),a(S,"new-jsonp"),a(S,"jsonp-end"),a(S,"cb-start"),E.on("pushState-end",i),E.on("replaceState-end",i),w[v]("hashchange",i,C(!0)),w[v]("load",i,C(!0)),w[v]("popstate",function(){i(0,U>1)},C(!0))}},{}],5:[function(t,e,n){function r(){var t=new PerformanceObserver(function(t,e){var n=t.getEntries();s(v,[n])});try{t.observe({entryTypes:["resource"]})}catch(e){}}function o(t){if(s(v,[window.performance.getEntriesByType(w)]),window.performance["c"+p])try{window.performance[h](m,o,!1)}catch(t){}else try{window.performance[h]("webkit"+m,o,!1)}catch(t){}}function i(t){}if(window.performance&&window.performance.timing&&window.performance.getEntriesByType){var a=t("ee"),s=t("handle"),c=t(14),f=t(13),u=t(6),d=t(23),p="learResourceTimings",l="addEventListener",h="removeEventListener",m="resourcetimingbufferfull",v="bstResource",w="resource",g="-start",y="-end",x="fn"+g,b="fn"+y,E="bstTimer",R="pushState",O=t("loader");if(!O.disabled){O.features.stn=!0,t(9),"addEventListener"in window&&t(7);var T=NREUM.o.EV;a.on(x,function(t,e){var n=t[0];n instanceof T&&(this.bstStart=O.now())}),a.on(b,function(t,e){var n=t[0];n instanceof T&&s("bst",[n,e,this.bstStart,O.now()])}),c.on(x,function(t,e,n){this.bstStart=O.now(),this.bstType=n}),c.on(b,function(t,e){s(E,[e,this.bstStart,O.now(),this.bstType])}),f.on(x,function(){this.bstStart=O.now()}),f.on(b,function(t,e){s(E,[e,this.bstStart,O.now(),"requestAnimationFrame"])}),a.on(R+g,function(t){this.time=O.now(),this.startPath=location.pathname+location.hash}),a.on(R+y,function(t){s("bstHist",[location.pathname+location.hash,this.startPath,this.time])}),u()?(s(v,[window.performance.getEntriesByType("resource")]),r()):l in window.performance&&(window.performance["c"+p]?window.performance[l](m,o,d(!1)):window.performance[l]("webkit"+m,o,d(!1))),document[l]("scroll",i,d(!1)),document[l]("keypress",i,d(!1)),document[l]("click",i,d(!1))}}},{}],6:[function(t,e,n){e.exports=function(){return"PerformanceObserver"in window&&"function"==typeof window.PerformanceObserver}},{}],7:[function(t,e,n){function r(t){for(var e=t;e&&!e.hasOwnProperty(u);)e=Object.getPrototypeOf(e);e&&o(e)}function o(t){s.inPlace(t,[u,d],"-",i)}function i(t,e){return t[1]}var a=t("ee").get("events"),s=t("wrap-function")(a,!0),c=t("gos"),f=XMLHttpRequest,u="addEventListener",d="removeEventListener";e.exports=a,"getPrototypeOf"in Object?(r(document),r(window),r(f.prototype)):f.prototype.hasOwnProperty(u)&&(o(window),o(f.prototype)),a.on(u+"-start",function(t,e){var n=t[1];if(null!==n&&("function"==typeof n||"object"==typeof n)){var r=c(n,"nr@wrapped",function(){function t(){if("function"==typeof n.handleEvent)return n.handleEvent.apply(n,arguments)}var e={object:t,"function":n}[typeof n];return e?s(e,"fn-",null,e.name||"anonymous"):n});this.wrapped=t[1]=r}}),a.on(d+"-start",function(t){t[1]=this.wrapped||t[1]})},{}],8:[function(t,e,n){function r(t,e,n){var r=t[e];"function"==typeof r&&(t[e]=function(){var t=i(arguments),e={};o.emit(n+"before-start",[t],e);var a;e[m]&&e[m].dt&&(a=e[m].dt);var s=r.apply(this,t);return o.emit(n+"start",[t,a],s),s.then(function(t){return o.emit(n+"end",[null,t],s),t},function(t){throw o.emit(n+"end",[t],s),t})})}var o=t("ee").get("fetch"),i=t(33),a=t(32);e.exports=o;var s=window,c="fetch-",f=c+"body-",u=["arrayBuffer","blob","json","text","formData"],d=s.Request,p=s.Response,l=s.fetch,h="prototype",m="nr@context";d&&p&&l&&(a(u,function(t,e){r(d[h],e,f),r(p[h],e,f)}),r(s,"fetch",c),o.on(c+"end",function(t,e){var n=this;if(e){var r=e.headers.get("content-length");null!==r&&(n.rxSize=r),o.emit(c+"done",[null,e],n)}else o.emit(c+"done",[t],n)}))},{}],9:[function(t,e,n){var r=t("ee").get("history"),o=t("wrap-function")(r);e.exports=r;var i=window.history&&window.history.constructor&&window.history.constructor.prototype,a=window.history;i&&i.pushState&&i.replaceState&&(a=i),o.inPlace(a,["pushState","replaceState"],"-")},{}],10:[function(t,e,n){function r(t){function e(){f.emit("jsonp-end",[],l),t.removeEventListener("load",e,c(!1)),t.removeEventListener("error",n,c(!1))}function n(){f.emit("jsonp-error",[],l),f.emit("jsonp-end",[],l),t.removeEventListener("load",e,c(!1)),t.removeEventListener("error",n,c(!1))}var r=t&&"string"==typeof t.nodeName&&"script"===t.nodeName.toLowerCase();if(r){var o="function"==typeof t.addEventListener;if(o){var a=i(t.src);if(a){var d=s(a),p="function"==typeof d.parent[d.key];if(p){var l={};u.inPlace(d.parent,[d.key],"cb-",l),t.addEventListener("load",e,c(!1)),t.addEventListener("error",n,c(!1)),f.emit("new-jsonp",[t.src],l)}}}}}function o(){return"addEventListener"in window}function i(t){var e=t.match(d);return e?e[1]:null}function a(t,e){var n=t.match(l),r=n[1],o=n[3];return o?a(o,e[r]):e[r]}function s(t){var e=t.match(p);return e&&e.length>=3?{key:e[2],parent:a(e[1],window)}:{key:t,parent:window}}var c=t(23),f=t("ee").get("jsonp"),u=t("wrap-function")(f);if(e.exports=f,o()){var d=/[?&](?:callback|cb)=([^&#]+)/,p=/(.*)\.([^.]+)/,l=/^(\w+)(\.|$)(.*)$/,h=["appendChild","insertBefore","replaceChild"];Node&&Node.prototype&&Node.prototype.appendChild?u.inPlace(Node.prototype,h,"dom-"):(u.inPlace(HTMLElement.prototype,h,"dom-"),u.inPlace(HTMLHeadElement.prototype,h,"dom-"),u.inPlace(HTMLBodyElement.prototype,h,"dom-")),f.on("dom-start",function(t){r(t[0])})}},{}],11:[function(t,e,n){var r=t("ee").get("mutation"),o=t("wrap-function")(r),i=NREUM.o.MO;e.exports=r,i&&(window.MutationObserver=function(t){return this instanceof i?new i(o(t,"fn-")):i.apply(this,arguments)},MutationObserver.prototype=i.prototype)},{}],12:[function(t,e,n){function r(t){var e=i.context(),n=s(t,"executor-",e,null,!1),r=new f(n);return i.context(r).getCtx=function(){return e},r}var o=t("wrap-function"),i=t("ee").get("promise"),a=t("ee").getOrSetContext,s=o(i),c=t(32),f=NREUM.o.PR;e.exports=i,f&&(window.Promise=r,["all","race"].forEach(function(t){var e=f[t];f[t]=function(n){function r(t){return function(){i.emit("propagate",[null,!o],a,!1,!1),o=o||!t}}var o=!1;c(n,function(e,n){Promise.resolve(n).then(r("all"===t),r(!1))});var a=e.apply(f,arguments),s=f.resolve(a);return s}}),["resolve","reject"].forEach(function(t){var e=f[t];f[t]=function(t){var n=e.apply(f,arguments);return t!==n&&i.emit("propagate",[t,!0],n,!1,!1),n}}),f.prototype["catch"]=function(t){return this.then(null,t)},f.prototype=Object.create(f.prototype,{constructor:{value:r}}),c(Object.getOwnPropertyNames(f),function(t,e){try{r[e]=f[e]}catch(n){}}),o.wrapInPlace(f.prototype,"then",function(t){return function(){var e=this,n=o.argsToArray.apply(this,arguments),r=a(e);r.promise=e,n[0]=s(n[0],"cb-",r,null,!1),n[1]=s(n[1],"cb-",r,null,!1);var c=t.apply(this,n);return r.nextPromise=c,i.emit("propagate",[e,!0],c,!1,!1),c}}),i.on("executor-start",function(t){t[0]=s(t[0],"resolve-",this,null,!1),t[1]=s(t[1],"resolve-",this,null,!1)}),i.on("executor-err",function(t,e,n){t[1](n)}),i.on("cb-end",function(t,e,n){i.emit("propagate",[n,!0],this.nextPromise,!1,!1)}),i.on("propagate",function(t,e,n){this.getCtx&&!e||(this.getCtx=function(){if(t instanceof Promise)var e=i.context(t);return e&&e.getCtx?e.getCtx():this})}),r.toString=function(){return""+f})},{}],13:[function(t,e,n){var r=t("ee").get("raf"),o=t("wrap-function")(r),i="equestAnimationFrame";e.exports=r,o.inPlace(window,["r"+i,"mozR"+i,"webkitR"+i,"msR"+i],"raf-"),r.on("raf-start",function(t){t[0]=o(t[0],"fn-")})},{}],14:[function(t,e,n){function r(t,e,n){t[0]=a(t[0],"fn-",null,n)}function o(t,e,n){this.method=n,this.timerDuration=isNaN(t[1])?0:+t[1],t[0]=a(t[0],"fn-",this,n)}var i=t("ee").get("timer"),a=t("wrap-function")(i),s="setTimeout",c="setInterval",f="clearTimeout",u="-start",d="-";e.exports=i,a.inPlace(window,[s,"setImmediate"],s+d),a.inPlace(window,[c],c+d),a.inPlace(window,[f,"clearImmediate"],f+d),i.on(c+u,r),i.on(s+u,o)},{}],15:[function(t,e,n){function r(t,e){d.inPlace(e,["onreadystatechange"],"fn-",s)}function o(){var t=this,e=u.context(t);t.readyState>3&&!e.resolved&&(e.resolved=!0,u.emit("xhr-resolved",[],t)),d.inPlace(t,y,"fn-",s)}function i(t){x.push(t),m&&(E?E.then(a):w?w(a):(R=-R,O.data=R))}function a(){for(var t=0;t<x.length;t++)r([],x[t]);x.length&&(x=[])}function s(t,e){return e}function c(t,e){for(var n in t)e[n]=t[n];return e}t(7);var f=t("ee"),u=f.get("xhr"),d=t("wrap-function")(u),p=t(23),l=NREUM.o,h=l.XHR,m=l.MO,v=l.PR,w=l.SI,g="readystatechange",y=["onload","onerror","onabort","onloadstart","onloadend","onprogress","ontimeout"],x=[];e.exports=u;var b=window.XMLHttpRequest=function(t){var e=new h(t);try{u.emit("new-xhr",[e],e),e.addEventListener(g,o,p(!1))}catch(n){try{u.emit("internal-error",[n])}catch(r){}}return e};if(c(h,b),b.prototype=h.prototype,d.inPlace(b.prototype,["open","send"],"-xhr-",s),u.on("send-xhr-start",function(t,e){r(t,e),i(e)}),u.on("open-xhr-start",r),m){var E=v&&v.resolve();if(!w&&!v){var R=1,O=document.createTextNode(R);new m(a).observe(O,{characterData:!0})}}else f.on("fn-end",function(t){t[0]&&t[0].type===g||a()})},{}],16:[function(t,e,n){function r(t){if(!s(t))return null;var e=window.NREUM;if(!e.loader_config)return null;var n=(e.loader_config.accountID||"").toString()||null,r=(e.loader_config.agentID||"").toString()||null,f=(e.loader_config.trustKey||"").toString()||null;if(!n||!r)return null;var h=l.generateSpanId(),m=l.generateTraceId(),v=Date.now(),w={spanId:h,traceId:m,timestamp:v};return(t.sameOrigin||c(t)&&p())&&(w.traceContextParentHeader=o(h,m),w.traceContextStateHeader=i(h,v,n,r,f)),(t.sameOrigin&&!u()||!t.sameOrigin&&c(t)&&d())&&(w.newrelicHeader=a(h,m,v,n,r,f)),w}function o(t,e){return"00-"+e+"-"+t+"-01"}function i(t,e,n,r,o){var i=0,a="",s=1,c="",f="";return o+"@nr="+i+"-"+s+"-"+n+"-"+r+"-"+t+"-"+a+"-"+c+"-"+f+"-"+e}function a(t,e,n,r,o,i){var a="btoa"in window&&"function"==typeof window.btoa;if(!a)return null;var s={v:[0,1],d:{ty:"Browser",ac:r,ap:o,id:t,tr:e,ti:n}};return i&&r!==i&&(s.d.tk=i),btoa(JSON.stringify(s))}function s(t){return f()&&c(t)}function c(t){var e=!1,n={};if("init"in NREUM&&"distributed_tracing"in NREUM.init&&(n=NREUM.init.distributed_tracing),t.sameOrigin)e=!0;else if(n.allowed_origins instanceof Array)for(var r=0;r<n.allowed_origins.length;r++){var o=h(n.allowed_origins[r]);if(t.hostname===o.hostname&&t.protocol===o.protocol&&t.port===o.port){e=!0;break}}return e}function f(){return"init"in NREUM&&"distributed_tracing"in NREUM.init&&!!NREUM.init.distributed_tracing.enabled}function u(){return"init"in NREUM&&"distributed_tracing"in NREUM.init&&!!NREUM.init.distributed_tracing.exclude_newrelic_header}function d(){return"init"in NREUM&&"distributed_tracing"in NREUM.init&&NREUM.init.distributed_tracing.cors_use_newrelic_header!==!1}function p(){return"init"in NREUM&&"distributed_tracing"in NREUM.init&&!!NREUM.init.distributed_tracing.cors_use_tracecontext_headers}var l=t(29),h=t(18);e.exports={generateTracePayload:r,shouldGenerateTrace:s}},{}],17:[function(t,e,n){function r(t){var e=this.params,n=this.metrics;if(!this.ended){this.ended=!0;for(var r=0;r<p;r++)t.removeEventListener(d[r],this.listener,!1);e.aborted||(n.duration=a.now()-this.startTime,this.loadCaptureCalled||4!==t.readyState?null==e.status&&(e.status=0):i(this,t),n.cbTime=this.cbTime,s("xhr",[e,n,this.startTime,this.endTime,"xhr"],this))}}function o(t,e){var n=c(e),r=t.params;r.hostname=n.hostname,r.port=n.port,r.protocol=n.protocol,r.host=n.hostname+":"+n.port,r.pathname=n.pathname,t.parsedOrigin=n,t.sameOrigin=n.sameOrigin}function i(t,e){t.params.status=e.status;var n=v(e,t.lastSize);if(n&&(t.metrics.rxSize=n),t.sameOrigin){var r=e.getResponseHeader("X-NewRelic-App-Data");r&&(t.params.cat=r.split(", ").pop())}t.loadCaptureCalled=!0}var a=t("loader");if(a.xhrWrappable&&!a.disabled){var s=t("handle"),c=t(18),f=t(16).generateTracePayload,u=t("ee"),d=["load","error","abort","timeout"],p=d.length,l=t("id"),h=t(24),m=t(22),v=t(19),w=t(23),g=NREUM.o.REQ,y=window.XMLHttpRequest;a.features.xhr=!0,t(15),t(8),u.on("new-xhr",function(t){var e=this;e.totalCbs=0,e.called=0,e.cbTime=0,e.end=r,e.ended=!1,e.xhrGuids={},e.lastSize=null,e.loadCaptureCalled=!1,e.params=this.params||{},e.metrics=this.metrics||{},t.addEventListener("load",function(n){i(e,t)},w(!1)),h&&(h>34||h<10)||t.addEventListener("progress",function(t){e.lastSize=t.loaded},w(!1))}),u.on("open-xhr-start",function(t){this.params={method:t[0]},o(this,t[1]),this.metrics={}}),u.on("open-xhr-end",function(t,e){"loader_config"in NREUM&&"xpid"in NREUM.loader_config&&this.sameOrigin&&e.setRequestHeader("X-NewRelic-ID",NREUM.loader_config.xpid);var n=f(this.parsedOrigin);if(n){var r=!1;n.newrelicHeader&&(e.setRequestHeader("newrelic",n.newrelicHeader),r=!0),n.traceContextParentHeader&&(e.setRequestHeader("traceparent",n.traceContextParentHeader),n.traceContextStateHeader&&e.setRequestHeader("tracestate",n.traceContextStateHeader),r=!0),r&&(this.dt=n)}}),u.on("send-xhr-start",function(t,e){var n=this.metrics,r=t[0],o=this;if(n&&r){var i=m(r);i&&(n.txSize=i)}this.startTime=a.now(),this.listener=function(t){try{"abort"!==t.type||o.loadCaptureCalled||(o.params.aborted=!0),("load"!==t.type||o.called===o.totalCbs&&(o.onloadCalled||"function"!=typeof e.onload))&&o.end(e)}catch(n){try{u.emit("internal-error",[n])}catch(r){}}};for(var s=0;s<p;s++)e.addEventListener(d[s],this.listener,w(!1))}),u.on("xhr-cb-time",function(t,e,n){this.cbTime+=t,e?this.onloadCalled=!0:this.called+=1,this.called!==this.totalCbs||!this.onloadCalled&&"function"==typeof n.onload||this.end(n)}),u.on("xhr-load-added",function(t,e){var n=""+l(t)+!!e;this.xhrGuids&&!this.xhrGuids[n]&&(this.xhrGuids[n]=!0,this.totalCbs+=1)}),u.on("xhr-load-removed",function(t,e){var n=""+l(t)+!!e;this.xhrGuids&&this.xhrGuids[n]&&(delete this.xhrGuids[n],this.totalCbs-=1)}),u.on("xhr-resolved",function(){this.endTime=a.now()}),u.on("addEventListener-end",function(t,e){e instanceof y&&"load"===t[0]&&u.emit("xhr-load-added",[t[1],t[2]],e)}),u.on("removeEventListener-end",function(t,e){e instanceof y&&"load"===t[0]&&u.emit("xhr-load-removed",[t[1],t[2]],e)}),u.on("fn-start",function(t,e,n){e instanceof y&&("onload"===n&&(this.onload=!0),("load"===(t[0]&&t[0].type)||this.onload)&&(this.xhrCbStart=a.now()))}),u.on("fn-end",function(t,e){this.xhrCbStart&&u.emit("xhr-cb-time",[a.now()-this.xhrCbStart,this.onload,e],e)}),u.on("fetch-before-start",function(t){function e(t,e){var n=!1;return e.newrelicHeader&&(t.set("newrelic",e.newrelicHeader),n=!0),e.traceContextParentHeader&&(t.set("traceparent",e.traceContextParentHeader),e.traceContextStateHeader&&t.set("tracestate",e.traceContextStateHeader),n=!0),n}var n,r=t[1]||{};"string"==typeof t[0]?n=t[0]:t[0]&&t[0].url?n=t[0].url:window.URL&&t[0]&&t[0]instanceof URL&&(n=t[0].href),n&&(this.parsedOrigin=c(n),this.sameOrigin=this.parsedOrigin.sameOrigin);var o=f(this.parsedOrigin);if(o&&(o.newrelicHeader||o.traceContextParentHeader))if("string"==typeof t[0]||window.URL&&t[0]&&t[0]instanceof URL){var i={};for(var a in r)i[a]=r[a];i.headers=new Headers(r.headers||{}),e(i.headers,o)&&(this.dt=o),t.length>1?t[1]=i:t.push(i)}else t[0]&&t[0].headers&&e(t[0].headers,o)&&(this.dt=o)}),u.on("fetch-start",function(t,e){this.params={},this.metrics={},this.startTime=a.now(),this.dt=e,t.length>=1&&(this.target=t[0]),t.length>=2&&(this.opts=t[1]);var n,r=this.opts||{},i=this.target;"string"==typeof i?n=i:"object"==typeof i&&i instanceof g?n=i.url:window.URL&&"object"==typeof i&&i instanceof URL&&(n=i.href),o(this,n);var s=(""+(i&&i instanceof g&&i.method||r.method||"GET")).toUpperCase();this.params.method=s,this.txSize=m(r.body)||0}),u.on("fetch-done",function(t,e){this.endTime=a.now(),this.params||(this.params={}),this.params.status=e?e.status:0;var n;"string"==typeof this.rxSize&&this.rxSize.length>0&&(n=+this.rxSize);var r={txSize:this.txSize,rxSize:n,duration:a.now()-this.startTime};s("xhr",[this.params,r,this.startTime,this.endTime,"fetch"],this)})}},{}],18:[function(t,e,n){var r={};e.exports=function(t){if(t in r)return r[t];var e=document.createElement("a"),n=window.location,o={};e.href=t,o.port=e.port;var i=e.href.split("://");!o.port&&i[1]&&(o.port=i[1].split("/")[0].split("@").pop().split(":")[1]),o.port&&"0"!==o.port||(o.port="https"===i[0]?"443":"80"),o.hostname=e.hostname||n.hostname,o.pathname=e.pathname,o.protocol=i[0],"/"!==o.pathname.charAt(0)&&(o.pathname="/"+o.pathname);var a=!e.protocol||":"===e.protocol||e.protocol===n.protocol,s=e.hostname===document.domain&&e.port===n.port;return o.sameOrigin=a&&(!e.hostname||s),"/"===o.pathname&&(r[t]=o),o}},{}],19:[function(t,e,n){function r(t,e){var n=t.responseType;return"json"===n&&null!==e?e:"arraybuffer"===n||"blob"===n||"json"===n?o(t.response):"text"===n||""===n||void 0===n?o(t.responseText):void 0}var o=t(22);e.exports=r},{}],20:[function(t,e,n){function r(){}function o(t,e,n,r){return function(){return u.recordSupportability("API/"+e+"/called"),i(t+e,[f.now()].concat(s(arguments)),n?null:this,r),n?void 0:this}}var i=t("handle"),a=t(32),s=t(33),c=t("ee").get("tracer"),f=t("loader"),u=t(25),d=NREUM;"undefined"==typeof window.newrelic&&(newrelic=d);var p=["setPageViewName","setCustomAttribute","setErrorHandler","finished","addToTrace","inlineHit","addRelease"],l="api-",h=l+"ixn-";a(p,function(t,e){d[e]=o(l,e,!0,"api")}),d.addPageAction=o(l,"addPageAction",!0),d.setCurrentRouteName=o(l,"routeName",!0),e.exports=newrelic,d.interaction=function(){return(new r).get()};var m=r.prototype={createTracer:function(t,e){var n={},r=this,o="function"==typeof e;return i(h+"tracer",[f.now(),t,n],r),function(){if(c.emit((o?"":"no-")+"fn-start",[f.now(),r,o],n),o)try{return e.apply(this,arguments)}catch(t){throw c.emit("fn-err",[arguments,this,t],n),t}finally{c.emit("fn-end",[f.now()],n)}}}};a("actionText,setName,setAttribute,save,ignore,onEnd,getContext,end,get".split(","),function(t,e){m[e]=o(h,e)}),newrelic.noticeError=function(t,e){"string"==typeof t&&(t=new Error(t)),u.recordSupportability("API/noticeError/called"),i("err",[t,f.now(),!1,e])}},{}],21:[function(t,e,n){function r(t){if(NREUM.init){for(var e=NREUM.init,n=t.split("."),r=0;r<n.length-1;r++)if(e=e[n[r]],"object"!=typeof e)return;return e=e[n[n.length-1]]}}e.exports={getConfiguration:r}},{}],22:[function(t,e,n){e.exports=function(t){if("string"==typeof t&&t.length)return t.length;if("object"==typeof t){if("undefined"!=typeof ArrayBuffer&&t instanceof ArrayBuffer&&t.byteLength)return t.byteLength;if("undefined"!=typeof Blob&&t instanceof Blob&&t.size)return t.size;if(!("undefined"!=typeof FormData&&t instanceof FormData))try{return JSON.stringify(t).length}catch(e){return}}}},{}],23:[function(t,e,n){var r=!1;try{var o=Object.defineProperty({},"passive",{get:function(){r=!0}});window.addEventListener("testPassive",null,o),window.removeEventListener("testPassive",null,o)}catch(i){}e.exports=function(t){return r?{passive:!0,capture:!!t}:!!t}},{}],24:[function(t,e,n){var r=0,o=navigator.userAgent.match(/Firefox[\/\s](\d+\.\d+)/);o&&(r=+o[1]),e.exports=r},{}],25:[function(t,e,n){function r(t,e){var n=[a,t,{name:t},e];return i("storeMetric",n,null,"api"),n}function o(t,e){var n=[s,t,{name:t},e];return i("storeEventMetrics",n,null,"api"),n}var i=t("handle"),a="sm",s="cm";e.exports={constants:{SUPPORTABILITY_METRIC:a,CUSTOM_METRIC:s},recordSupportability:r,recordCustom:o}},{}],26:[function(t,e,n){function r(){return s.exists&&performance.now?Math.round(performance.now()):(i=Math.max((new Date).getTime(),i))-a}function o(){return i}var i=(new Date).getTime(),a=i,s=t(34);e.exports=r,e.exports.offset=a,e.exports.getLastTimestamp=o},{}],27:[function(t,e,n){function r(t){return!(!t||!t.protocol||"file:"===t.protocol)}e.exports=r},{}],28:[function(t,e,n){function r(t,e){var n=t.getEntries();n.forEach(function(t){"first-paint"===t.name?p("timing",["fp",Math.floor(t.startTime)]):"first-contentful-paint"===t.name&&p("timing",["fcp",Math.floor(t.startTime)])})}function o(t,e){var n=t.getEntries();if(n.length>0){var r=n[n.length-1];if(c&&c<r.startTime)return;p("lcp",[r])}}function i(t){t.getEntries().forEach(function(t){t.hadRecentInput||p("cls",[t])})}function a(t){if(t instanceof v&&!g){var e=Math.round(t.timeStamp),n={type:t.type};e<=l.now()?n.fid=l.now()-e:e>l.offset&&e<=Date.now()?(e-=l.offset,n.fid=l.now()-e):e=l.now(),g=!0,p("timing",["fi",e,n])}}function s(t){"hidden"===t&&(c=l.now(),p("pageHide",[c]))}if(!("init"in NREUM&&"page_view_timing"in NREUM.init&&"enabled"in NREUM.init.page_view_timing&&NREUM.init.page_view_timing.enabled===!1)){var c,f,u,d,p=t("handle"),l=t("loader"),h=t(31),m=t(23),v=NREUM.o.EV;if("PerformanceObserver"in window&&"function"==typeof window.PerformanceObserver){f=new PerformanceObserver(r);try{f.observe({entryTypes:["paint"]})}catch(w){}u=new PerformanceObserver(o);try{u.observe({entryTypes:["largest-contentful-paint"]})}catch(w){}d=new PerformanceObserver(i);try{d.observe({type:"layout-shift",buffered:!0})}catch(w){}}if("addEventListener"in document){var g=!1,y=["click","keydown","mousedown","pointerdown","touchstart"];y.forEach(function(t){document.addEventListener(t,a,m(!1))})}h(s)}},{}],29:[function(t,e,n){function r(){function t(){return e?15&e[n++]:16*Math.random()|0}var e=null,n=0,r=window.crypto||window.msCrypto;r&&r.getRandomValues&&(e=r.getRandomValues(new Uint8Array(31)));for(var o,i="xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",a="",s=0;s<i.length;s++)o=i[s],"x"===o?a+=t().toString(16):"y"===o?(o=3&t()|8,a+=o.toString(16)):a+=o;return a}function o(){return a(16)}function i(){return a(32)}function a(t){function e(){return n?15&n[r++]:16*Math.random()|0}var n=null,r=0,o=window.crypto||window.msCrypto;o&&o.getRandomValues&&Uint8Array&&(n=o.getRandomValues(new Uint8Array(31)));for(var i=[],a=0;a<t;a++)i.push(e().toString(16));return i.join("")}e.exports={generateUuid:r,generateSpanId:o,generateTraceId:i}},{}],30:[function(t,e,n){function r(t,e){if(!o)return!1;if(t!==o)return!1;if(!e)return!0;if(!i)return!1;for(var n=i.split("."),r=e.split("."),a=0;a<r.length;a++)if(r[a]!==n[a])return!1;return!0}var o=null,i=null,a=/Version\/(\S+)\s+Safari/;if(navigator.userAgent){var s=navigator.userAgent,c=s.match(a);c&&s.indexOf("Chrome")===-1&&s.indexOf("Chromium")===-1&&(o="Safari",i=c[1])}e.exports={agent:o,version:i,match:r}},{}],31:[function(t,e,n){function r(t){function e(){t(s&&document[s]?document[s]:document[i]?"hidden":"visible")}"addEventListener"in document&&a&&document.addEventListener(a,e,o(!1))}var o=t(23);e.exports=r;var i,a,s;"undefined"!=typeof document.hidden?(i="hidden",a="visibilitychange",s="visibilityState"):"undefined"!=typeof document.msHidden?(i="msHidden",a="msvisibilitychange"):"undefined"!=typeof document.webkitHidden&&(i="webkitHidden",a="webkitvisibilitychange",s="webkitVisibilityState")},{}],32:[function(t,e,n){function r(t,e){var n=[],r="",i=0;for(r in t)o.call(t,r)&&(n[i]=e(r,t[r]),i+=1);return n}var o=Object.prototype.hasOwnProperty;e.exports=r},{}],33:[function(t,e,n){function r(t,e,n){e||(e=0),"undefined"==typeof n&&(n=t?t.length:0);for(var r=-1,o=n-e||0,i=Array(o<0?0:o);++r<o;)i[r]=t[e+r];return i}e.exports=r},{}],34:[function(t,e,n){e.exports={exists:"undefined"!=typeof window.performance&&window.performance.timing&&"undefined"!=typeof window.performance.timing.navigationStart}},{}],ee:[function(t,e,n){function r(){}function o(t){function e(t){return t&&t instanceof r?t:t?f(t,c,a):a()}function n(n,r,o,i,a){if(a!==!1&&(a=!0),!l.aborted||i){t&&a&&t(n,r,o);for(var s=e(o),c=m(n),f=c.length,u=0;u<f;u++)c[u].apply(s,r);var p=d[y[n]];return p&&p.push([x,n,r,s]),s}}function i(t,e){g[t]=m(t).concat(e)}function h(t,e){var n=g[t];if(n)for(var r=0;r<n.length;r++)n[r]===e&&n.splice(r,1)}function m(t){return g[t]||[]}function v(t){return p[t]=p[t]||o(n)}function w(t,e){l.aborted||u(t,function(t,n){e=e||"feature",y[n]=e,e in d||(d[e]=[])})}var g={},y={},x={on:i,addEventListener:i,removeEventListener:h,emit:n,get:v,listeners:m,context:e,buffer:w,abort:s,aborted:!1};return x}function i(t){return f(t,c,a)}function a(){return new r}function s(){(d.api||d.feature)&&(l.aborted=!0,d=l.backlog={})}var c="nr@context",f=t("gos"),u=t(32),d={},p={},l=e.exports=o();e.exports.getOrSetContext=i,l.backlog=d},{}],gos:[function(t,e,n){function r(t,e,n){if(o.call(t,e))return t[e];var r=n();if(Object.defineProperty&&Object.keys)try{return Object.defineProperty(t,e,{value:r,writable:!0,enumerable:!1}),r}catch(i){}return t[e]=r,r}var o=Object.prototype.hasOwnProperty;e.exports=r},{}],handle:[function(t,e,n){function r(t,e,n,r){o.buffer([t],r),o.emit(t,e,n)}var o=t("ee").get("handle");e.exports=r,r.ee=o},{}],id:[function(t,e,n){function r(t){var e=typeof t;return!t||"object"!==e&&"function"!==e?-1:t===window?0:a(t,i,function(){return o++})}var o=1,i="nr@id",a=t("gos");e.exports=r},{}],loader:[function(t,e,n){function r(){if(!P++){var t=T.info=NREUM.info,e=v.getElementsByTagName("script")[0];if(setTimeout(f.abort,3e4),!(t&&t.licenseKey&&t.applicationID&&e))return f.abort();c(R,function(e,n){t[e]||(t[e]=n)});var n=a();s("mark",["onload",n+T.offset],null,"api"),s("timing",["load",n]);var r=v.createElement("script");0===t.agent.indexOf("http://")||0===t.agent.indexOf("https://")?r.src=t.agent:r.src=h+"://"+t.agent,e.parentNode.insertBefore(r,e)}}function o(){"complete"===v.readyState&&i()}function i(){s("mark",["domContent",a()+T.offset],null,"api")}var a=t(26),s=t("handle"),c=t(32),f=t("ee"),u=t(30),d=t(27),p=t(21),l=t(23),h=p.getConfiguration("ssl")===!1?"http":"https",m=window,v=m.document,w="addEventListener",g="attachEvent",y=m.XMLHttpRequest,x=y&&y.prototype,b=!d(m.location);NREUM.o={ST:setTimeout,SI:m.setImmediate,CT:clearTimeout,XHR:y,REQ:m.Request,EV:m.Event,PR:m.Promise,MO:m.MutationObserver};var E=""+location,R={beacon:"bam.nr-data.net",errorBeacon:"bam.nr-data.net",agent:"js-agent.newrelic.com/nr-spa-1212.min.js"},O=y&&x&&x[w]&&!/CriOS/.test(navigator.userAgent),T=e.exports={offset:a.getLastTimestamp(),now:a,origin:E,features:{},xhrWrappable:O,userAgent:u,disabled:b};if(!b){t(20),t(28),v[w]?(v[w]("DOMContentLoaded",i,l(!1)),m[w]("load",r,l(!1))):(v[g]("onreadystatechange",o),m[g]("onload",r)),s("mark",["firstbyte",a.getLastTimestamp()],null,"api");var P=0}},{}],"wrap-function":[function(t,e,n){function r(t,e){function n(e,n,r,c,f){function nrWrapper(){var i,a,u,p;try{a=this,i=d(arguments),u="function"==typeof r?r(i,a):r||{}}catch(l){o([l,"",[i,a,c],u],t)}s(n+"start",[i,a,c],u,f);try{return p=e.apply(a,i)}catch(h){throw s(n+"err",[i,a,h],u,f),h}finally{s(n+"end",[i,a,p],u,f)}}return a(e)?e:(n||(n=""),nrWrapper[p]=e,i(e,nrWrapper,t),nrWrapper)}function r(t,e,r,o,i){r||(r="");var s,c,f,u="-"===r.charAt(0);for(f=0;f<e.length;f++)c=e[f],s=t[c],a(s)||(t[c]=n(s,u?c+r:r,o,c,i))}function s(n,r,i,a){if(!h||e){var s=h;h=!0;try{t.emit(n,r,i,e,a)}catch(c){o([c,n,r,i],t)}h=s}}return t||(t=u),n.inPlace=r,n.flag=p,n}function o(t,e){e||(e=u);try{e.emit("internal-error",t)}catch(n){}}function i(t,e,n){if(Object.defineProperty&&Object.keys)try{var r=Object.keys(t);return r.forEach(function(n){Object.defineProperty(e,n,{get:function(){return t[n]},set:function(e){return t[n]=e,e}})}),e}catch(i){o([i],n)}for(var a in t)l.call(t,a)&&(e[a]=t[a]);return e}function a(t){return!(t&&t instanceof Function&&t.apply&&!t[p])}function s(t,e){var n=e(t);return n[p]=t,i(t,n,u),n}function c(t,e,n){var r=t[e];t[e]=s(r,n)}function f(){for(var t=arguments.length,e=new Array(t),n=0;n<t;++n)e[n]=arguments[n];return e}var u=t("ee"),d=t(33),p="nr@original",l=Object.prototype.hasOwnProperty,h=!1;e.exports=r,e.exports.wrapFunction=s,e.exports.wrapInPlace=c,e.exports.argsToArray=f},{}]},{},["loader",2,17,5,3,4]); ;NREUM.loader_config={accountID:"3768898",trustKey:"3768898",agentID:"1134285132",licenseKey:"NRJS-2bc9f9fb1efc463f27c",applicationID:"1134285132"} ;NREUM.info={beacon:"bam.nr-data.net",errorBeacon:"bam.nr-data.net",licenseKey:"NRJS-2bc9f9fb1efc463f27c",applicationID:"1134285132",sa:1} newrelic.addRelease("", "Remove-ControllerConfig-r-production-4dd74f6-17d951-17d94f"); </script><meta name=viewport content="width=device-width,initial-scale=1"><meta name=author content="Crossplane Community"><meta name=color-scheme content="light dark"><meta name=docsearch:language content="en"><meta name=generator content="Hugo 0.119.0"><link rel=preload href=/fonts/Avenir-Roman.woff2 as=font type=font/woff2 crossorigin><meta property="og:image" content="/img/crossplane-logo-og.webp"><meta property="twitter:card" content="/img/crossplane-logo-og.webp"><meta property="og:image:width" content="600"><meta property="og:image:height" content="199"><meta property="og:image:alt" content="Crossplane name and popsicle logo"><meta property="twitter:image:alt" content="Crossplane name and popsicle logo"><meta property="og:type" content="website"><meta name=twitter:site content="@crossplane_io"><meta property="og:site_name" content="Crossplane Documentation"><meta name=description content="Compositions are a template for creating Crossplane resources"><meta property="og:url" content="https://docs.crossplane.io/v1.16/concepts/compositions/"><meta name=docsearch:modified content="May 15, 2024"><meta name=docsearch:version content="1.16"><title>Compositions · Crossplane v1.16</title><link rel=canonical href=https://docs.crossplane.io/latest/concepts/compositions/><script>(()=>{var e=window.matchMedia("(prefers-color-scheme: dark)").matches,t=localStorage.getItem("darkSwitch")!==null&&localStorage.getItem("darkSwitch")==="dark",n=localStorage.getItem("darkSwitch")!==null&&localStorage.getItem("darkSwitch")==="light";n&&(e=!1),t||e?document.documentElement.setAttribute("color-theme","dark"):document.documentElement.setAttribute("color-theme","light")})()</script><link rel=stylesheet href=https://cdn.jsdelivr.net/npm/@docsearch/css@3 media=print onload='this.media="all"'><link rel=preconnect href=https://9UXKYX61NK-dsn.algolia.net crossorigin data-proofer-ignore><link href="https://docs.crossplane.io/scss/docs.0346bfd4a8aeace526724de64ddada78a0e5122b3b0c83b1021770d6ddef1160.css" rel=stylesheet><link rel=apple-touch-icon sizes=180x180 href=/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=/favicon-32x32.png><link rel=icon type=image/png sizes=192x192 href=/android-chrome-192x192.png><link rel=icon type=image/png sizes=16x16 href=/favicon-16x16.png><link rel=manifest href=/site.webmanifest><link rel=mask-icon href=/safari-pinned-tab.svg color=#f87c44><meta name=apple-mobile-web-app-title content="Crossplane Docs"><meta name=application-name content="Crossplane Docs"><meta name=msapplication-TileColor content="#333f5b"><meta name=theme-color content="#ffffff"><meta property="og:title" content="Crossplane Docs · v1.16 · Compositions"><meta property="og:description" content="Compositions are a template for creating multiple managed resources as a single object. A Composition composes individual managed resources together into a larger, reusable, solution. An example …"></head><body><svg xmlns="http://www.w3.org/2000/svg" style="display:none"><symbol id="check2" viewBox="0 0 16 16"><path d="M13.854 3.646a.5.5.0 010 .708l-7 7a.5.5.0 01-.708.0l-3.5-3.5a.5.5.0 11.708-.708L6.5 10.293l6.646-6.647a.5.5.0 01.708.0z"/></symbol><symbol id="x" viewBox="0 0 16 16"><path d="M2.146 2.854a.5.5.0 11.708-.708L8 7.293l5.146-5.147a.5.5.0 01.708.708L8.707 8l5.147 5.146a.5.5.0 01-.708.708L8 8.707l-5.146 5.147a.5.5.0 01-.708-.708L7.293 8 2.146 2.854z"/></symbol><symbol id="chevron-expand" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M3.646 9.146a.5.5.0 01.708.0L8 12.793l3.646-3.647a.5.5.0 01.708.708l-4 4a.5.5.0 01-.708.0l-4-4a.5.5.0 010-.708zm0-2.292a.5.5.0 00.708.0L8 3.207l3.646 3.647a.5.5.0 00.708-.708l-4-4a.5.5.0 00-.708.0l-4 4a.5.5.0 000 .708z"/></symbol><symbol id="clipboard" viewBox="0 0 16 16"><path d="M4 1.5H3a2 2 0 00-2 2V14a2 2 0 002 2h10a2 2 0 002-2V3.5a2 2 0 00-2-2h-1v1h1a1 1 0 011 1V14a1 1 0 01-1 1H3a1 1 0 01-1-1V3.5a1 1 0 011-1h1v-1z"/><path d="M9.5 1a.5.5.0 01.5.5v1a.5.5.0 01-.5.5h-3A.5.5.0 016 2.5v-1a.5.5.0 01.5-.5h3zm-3-1A1.5 1.5.0 005 1.5v1A1.5 1.5.0 006.5 4h3A1.5 1.5.0 0011 2.5v-1A1.5 1.5.0 009.5.0h-3z"/></symbol><symbol id="plus" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8 2a.5.5.0 01.5.5v5h5a.5.5.0 010 1h-5v5a.5.5.0 01-1 0v-5h-5a.5.5.0 010-1h5v-5A.5.5.0 018 2z"/></symbol><symbol id="three-dots" viewBox="0 0 16 16"><path d="M3 9.5a1.5 1.5.0 110-3 1.5 1.5.0 010 3zm5 0a1.5 1.5.0 110-3 1.5 1.5.0 010 3zm5 0a1.5 1.5.0 110-3 1.5 1.5.0 010 3z"/></symbol><symbol id="info" viewBox="0 0 16 16"><path d="M8 15A7 7 0 118 1a7 7 0 010 14zm0 1A8 8 0 108 0a8 8 0 000 16z"/><path d="m8.93 6.588-2.29.287-.082.38.45.083c.294.07.352.176.288.469l-.738 3.468c-.194.897.105 1.319.808 1.319.545.0 1.178-.252 1.465-.598l.088-.416c-.2.176-.492.246-.686.246-.275.0-.375-.193-.304-.533L8.93 6.588zM9 4.5a1 1 0 11-2 0 1 1 0 012 0z"/></symbol><symbol id="check" viewBox="0 0 16 16"><path d="M8 15A7 7 0 118 1a7 7 0 010 14zm0 1A8 8 0 108 0a8 8 0 000 16z"/><path d="M10.97 4.97a.235.235.0 00-.02.022L7.477 9.417 5.384 7.323a.75.75.0 00-1.06 1.06L6.97 11.03a.75.75.0 001.079-.02l3.992-4.99A.75.75.0 0010.97 4.97z"/></symbol><symbol id="exclamation" viewBox="0 0 16 16"><path d="M8 15A7 7 0 118 1a7 7 0 010 14zm0 1A8 8 0 108 0a8 8 0 000 16z"/><path d="M7.002 11a1 1 0 112 0 1 1 0 01-2 0zM7.1 4.995a.905.905.0 111.8.0l-.35 3.507a.552.552.0 01-1.1.0L7.1 4.995z"/></symbol><symbol id="x-circle" viewBox="0 0 16 16"><path d="M8 15A7 7 0 118 1a7 7 0 010 14zm0 1A8 8 0 108 0a8 8 0 000 16z"/><path d="M4.646 4.646a.5.5.0 01.708.0L8 7.293l2.646-2.647a.5.5.0 01.708.708L8.707 8l2.647 2.646a.5.5.0 01-.708.708L8 8.707l-2.646 2.647a.5.5.0 01-.708-.708L7.293 8 4.646 5.354a.5.5.0 010-.708z"/></symbol><symbol id="fire" viewBox="0 0 16 16"><path d="M8 16c3.314.0 6-2 6-5.5.0-1.5-.5-4-2.5-6 .25 1.5-1.25 2-1.25 2C11 4 9 .5 6 0c.357 2 .5 4-2 6-1.25 1-2 2.729-2 4.5C2 14 4.686 16 8 16zm0-1c-1.657.0-3-1-3-2.75.0-.75.25-2 1.25-3C6.125 10 7 10.5 7 10.5c-.375-1.25.5-3.25 2-3.5-.179 1-.25 2 1 3 .625.5 1 1.364 1 2.25C11 14 9.657 15 8 15z"/></symbol><symbol id="search" viewBox="0 0 16 16"><path d="M11.742 10.344a6.5 6.5.0 10-1.397 1.398h-.001c.03.04.062.078.098.115l3.85 3.85a1 1 0 001.415-1.414l-3.85-3.85a1.007 1.007.0 00-.115-.1zM12 6.5a5.5 5.5.0 11-11 0 5.5 5.5.0 0111 0z"/></symbol><symbol id="clipboard-check" viewBox="0 0 16 16"><path d="M6.5.0A1.5 1.5.0 005 1.5v1A1.5 1.5.0 006.5 4h3A1.5 1.5.0 0011 2.5v-1A1.5 1.5.0 009.5.0h-3zm3 1a.5.5.0 01.5.5v1a.5.5.0 01-.5.5h-3A.5.5.0 016 2.5v-1a.5.5.0 01.5-.5h3z"/><path d="M4 1.5H3a2 2 0 00-2 2V14a2 2 0 002 2h10a2 2 0 002-2V3.5a2 2 0 00-2-2h-1v1A2.5 2.5.0 019.5 5h-3A2.5 2.5.0 014 2.5v-1zm6.854 7.354-3 3a.5.5.0 01-.708.0l-1.5-1.5a.5.5.0 01.708-.708L7.5 10.793l2.646-2.647a.5.5.0 01.708.708z"/></symbol><symbol id="pencil-square" viewBox="0 0 16 16"><path d="M15.502 1.94a.5.5.0 010 .706L14.459 3.69l-2-2L13.502.646a.5.5.0 01.707.0l1.293 1.293zm-1.75 2.456-2-2L4.939 9.21a.5.5.0 00-.121.196l-.805 2.414a.25.25.0 00.316.316l2.414-.805a.5.5.0 00.196-.12l6.813-6.814z"/><path fill-rule="evenodd" d="M1 13.5A1.5 1.5.0 002.5 15h11a1.5 1.5.0 001.5-1.5v-6a.5.5.0 00-1 0v6a.5.5.0 01-.5.5h-11a.5.5.0 01-.5-.5v-11a.5.5.0 01.5-.5H9a.5.5.0 000-1H2.5A1.5 1.5.0 001 2.5v11z"/></symbol><symbol id="github" viewBox="0 0 16 16"><path d="M8 0C3.58.0.0 3.58.0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38.0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95.0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12.0.0.67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15.0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48.0 1.07-.01 1.93-.01 2.2.0.21.15.46.55.38A8.012 8.012.0 0016 8c0-4.42-3.58-8-8-8z"/></symbol><symbol id="box-arrow-up-right" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.636 3.5a.5.5.0 00-.5-.5H1.5A1.5 1.5.0 000 4.5v10A1.5 1.5.0 001.5 16h10a1.5 1.5.0 001.5-1.5V7.864a.5.5.0 00-1 0V14.5a.5.5.0 01-.5.5h-10a.5.5.0 01-.5-.5v-10a.5.5.0 01.5-.5h6.636a.5.5.0 00.5-.5z"/><path fill-rule="evenodd" d="M16 .5a.5.5.0 00-.5-.5h-5a.5.5.0 000 1h3.793L6.146 9.146a.5.5.0 10.708.708L15 1.707V5.5a.5.5.0 001 0v-5z"/></symbol></svg><header class="navbar docs-navbar navbar-expand-lg py-0 align-items-center"><div class=docs-left-toggle><button class=navbar-toggler type=button data-bs-toggle=offcanvas data-bs-target=#bdSidebar aria-controls=bdSidebar aria-label="Toggle docs content"><svg xmlns="http://www.w3.org/2000/svg" width="1.5rem" height="1.5rem" fill="currentcolor" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M2.5 11.5A.5.5.0 013 11h10a.5.5.0 010 1H3a.5.5.0 01-.5-.5zm0-4A.5.5.0 013 7h10a.5.5.0 010 1H3a.5.5.0 01-.5-.5zm0-4A.5.5.0 013 3h10a.5.5.0 010 1H3a.5.5.0 01-.5-.5z"/></svg> Browse</button></div><div class="docs-right-toggle order-3"><button class=navbar-toggler type=button data-bs-toggle=offcanvas data-bs-target=#offcanvas aria-controls=offcanvas aria-label="Toggle Crossplane navigation"><svg class="bi white" aria-hidden="true"><use xlink:href="#three-dots"/></svg></button></div><div class=navbar-brand><a href=https://www.crossplane.io aria-label=Crossplane><img src=/img/crossplane-logo.svg alt="Crossplane logo" srcset="/img/crossplane-logo.svg 1x, /img/crossplane-logo.svg 2x" width=152px decoding=async data-nimg=future loading=lazy></a></div><div class="w-100 offcanvas-lg offcanvas-end" tabindex=-1 id=offcanvas aria-labelledby=offcanvasLabel><div class="offcanvas-body p-0"><div class="offcanvas-header p-0"><div class=navbar-brand><a href=https://www.crossplane.io aria-label=Crossplane><img src=/img/crossplane-logo.svg alt="Crossplane logo" srcset="/img/crossplane-logo.svg 1x, /img/crossplane-logo.svg 2x" width=152px decoding=async data-nimg=future loading=lazy></a></div><button type=button class="btn-close btn-close-white" data-bs-dismiss=offcanvas aria-label=Close data-bs-target=#offcanvas></button></div><div class="navbar-center-links collapse navbar-collapse justify-content-evenly show"><ul class="navbar-nav align-items-center"><li class=nav-item><a class=navbar-link href=https://www.crossplane.io/why-control-planes>Why Control Planes?</a></li><li class=nav-item><a class=navbar-link aria-current=page href=https://docs.crossplane.io/>Documentation</a></li><li class=nav-item><a class=navbar-link href=https://www.crossplane.io/community>Community</a></li><li class=nav-item><a class=navbar-link href=https://blog.crossplane.io/>Blog</a></li></ul></div><div class="navbar-icons flex-shrink-1 show"><ul class=navbar-nav><li class="nav-item col-xs p-2"><a class=navbar-link href=https://github.com/crossplane title="Crossplane Github Repository" target=_blank rel=noopener><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentcolor" class="icon-github" viewBox="0 0 16 16"><path d="M8 0C3.58.0.0 3.58.0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38.0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95.0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12.0.0.67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15.0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48.0 1.07-.01 1.93-.01 2.2.0.21.15.46.55.38A8.012 8.012.0 0016 8c0-4.42-3.58-8-8-8z"/></svg>Crossplane GitHub</a></li><li class="nav-item col-xs p-2"><div id=slack><a class=navbar-link href=https://slack.crossplane.io title="Join the Crossplane Slack" target=_blank rel=noopener><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentcolor" class="icon-slack" viewBox="0 0 16 16"><path d="M3.362 10.11c0 .926-.756 1.681-1.681 1.681S0 11.036.0 10.111C0 9.186.756 8.43 1.68 8.43h1.682v1.68zm.846.0c0-.924.756-1.68 1.681-1.68s1.681.756 1.681 1.68v4.21c0 .924-.756 1.68-1.68 1.68a1.685 1.685.0 01-1.682-1.68v-4.21zM5.89 3.362c-.926.0-1.682-.756-1.682-1.681S4.964.0 5.89.0s1.68.756 1.68 1.68v1.682H5.89zm0 .846c.924.0 1.68.756 1.68 1.681S6.814 7.57 5.89 7.57H1.68C.757 7.57.0 6.814.0 5.89c0-.926.756-1.682 1.68-1.682h4.21zm6.749 1.682c0-.926.755-1.682 1.68-1.682.925.0 1.681.756 1.681 1.681s-.756 1.681-1.68 1.681h-1.681V5.89zm-.848.0c0 .924-.755 1.68-1.68 1.68A1.685 1.685.0 018.43 5.89V1.68C8.43.757 9.186.0 10.11.0c.926.0 1.681.756 1.681 1.68v4.21zm-1.681 6.748c.926.0 1.682.756 1.682 1.681S11.036 16 10.11 16s-1.681-.756-1.681-1.68v-1.682h1.68zm0-.847c-.924.0-1.68-.755-1.68-1.68.0-.925.756-1.681 1.68-1.681h4.21c.924.0 1.68.756 1.68 1.68.0.926-.756 1.681-1.68 1.681h-4.21z"/></svg>Crossplane Slack</a></div></li><li class="nav-item col-x p-2"><div class="vr d-lg-flex mx-lg-2 text-white"></div></li><li class="nav-item col-xs p-2"><div class="form-check form-switch color-switcher"><input class="d-flex form-check-input" type=checkbox id=darkSwitch> <label class="d-flex navbar-link form-check-label" for=darkSwitch>Dark Mode</label></div></li></ul></div></div></div></header><div class="bd-layout docs-container" data-bs-spy=scroll data-bs-target=#TableOfContents data-bs-threshold=0,1 data-bs-root-margin="0% 0% -75%"><aside class=bd-sidebar><div class="offcanvas-lg offcanvas-start bd-sidebar-container" tabindex=-1 id=bdSidebar aria-labelledby=bdSidebarOffcanvasLabel><div class="offcanvas-header pb-4 border-bottom"><div class="d-flex offcanvas-title fw-bold" id=bdNavbarOffcanvasLabel>Crossplane Documentation - v1.16</div><div class=d-flex><button type=button class="btn-close bi align-self-center p-0" data-bs-dismiss=offcanvas aria-label=Close data-bs-target=#bdSidebar></button></div></div><div class=offcanvas-body><div class="container-fluid p-0"><div class="search-container d-flex row pt-3 ps-4 docsearch opacity-50" data-bs-target=#bdSidebar data-bs-dismiss=offcanvas aria-label="Docs navigation"><div class=p-0 id=docSearch></div></div><nav class="bd-links-nav w-100" aria-label="Docs navigation"><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100"><a class="d-flex w-100 border-0" href=https://docs.crossplane.io/v1.16/>Overview</a></div></div><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100"><a class="d-flex w-100 border-0" href=https://docs.crossplane.io/v1.16/getting-started/>Getting Started</a><div class="d-flex flex-shrink-1 sidebar-control-container align-self-center"><input type=checkbox class="d-flex sidebar-checkbox" aria-label="Close or Expand Getting Started Section"> <label for=collapse-ddb170dc class="sidebar-label collapsed" data-bs-toggle=collapse data-bs-target=#collapse-ddb170dc aria-expanded=false aria-label="Close or Expand Getting Started Section"><svg class="flex bi sidebar-icon plus"><use xlink:href="#plus"/></svg><svg class="flex bi sidebar-icon x"><use xlink:href="#x"/></svg></label></div></div><div class="container flex-row collapse" id=collapse-ddb170dc><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/getting-started/introduction/>Crossplane Introduction</a></div></div><div class="container flex-row collapse" id=collapse-ddb170dc><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/getting-started/provider-aws/>AWS Quickstart</a></div></div><div class="container flex-row collapse" id=collapse-ddb170dc><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/getting-started/provider-azure/>Azure Quickstart</a></div></div><div class="container flex-row collapse" id=collapse-ddb170dc><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/getting-started/provider-gcp/>GCP Quickstart</a></div></div></div><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100"><a class="d-flex w-100 border-0" href=https://docs.crossplane.io/v1.16/software/>Install, Upgrade and Uninstall</a><div class="d-flex flex-shrink-1 sidebar-control-container align-self-center"><input type=checkbox class="d-flex sidebar-checkbox" aria-label="Close or Expand Install, Upgrade and Uninstall Section"> <label for=collapse-9f2b1e08 class="sidebar-label collapsed" data-bs-toggle=collapse data-bs-target=#collapse-9f2b1e08 aria-expanded=false aria-label="Close or Expand Install, Upgrade and Uninstall Section"><svg class="flex bi sidebar-icon plus"><use xlink:href="#plus"/></svg><svg class="flex bi sidebar-icon x"><use xlink:href="#x"/></svg></label></div></div><div class="container flex-row collapse" id=collapse-9f2b1e08><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/software/install/>Install Crossplane</a></div></div><div class="container flex-row collapse" id=collapse-9f2b1e08><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/software/upgrade/>Upgrade Crossplane</a></div></div><div class="container flex-row collapse" id=collapse-9f2b1e08><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/software/uninstall/>Uninstall Crossplane</a></div></div></div><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100 active-parent"><a class="d-flex w-100 border-0" href=https://docs.crossplane.io/v1.16/concepts/>Concepts</a><div class="d-flex flex-shrink-1 sidebar-control-container align-self-center"><input type=checkbox class="d-flex sidebar-checkbox" checked aria-label="Close or Expand Concepts Section"> <label for=collapse-9e31ed45 class=sidebar-label data-bs-toggle=collapse data-bs-target=#collapse-9e31ed45 aria-expanded=false aria-label="Close or Expand Concepts Section"><svg class="flex bi sidebar-icon plus"><use xlink:href="#plus"/></svg><svg class="flex bi sidebar-icon x"><use xlink:href="#x"/></svg></label></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/pods/>Crossplane Pods</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/providers/>Providers</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/managed-resources/>Managed Resources</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex active" href=https://docs.crossplane.io/v1.16/concepts/compositions/>Compositions</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/composition-revisions/>Composition Revisions</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/composite-resource-definitions/>Composite Resource Definitions</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/composite-resources/>Composite Resources</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/claims/>Claims</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/patch-and-transform/>Patch and Transforms</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/environment-configs/>Environment Configurations</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/composition-functions/>Composition Functions</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/usages/>Usages</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/connection-details/>Connection Details</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/packages/>Configuration Packages</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/server-side-apply/>Server-Side Apply</a></div></div><div class="container flex-row collapse show" id=collapse-9e31ed45><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/concepts/image-configs/>Image Configs</a></div></div></div><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100"><a class="d-flex w-100 border-0" href=https://docs.crossplane.io/v1.16/guides/>Guides</a><div class="d-flex flex-shrink-1 sidebar-control-container align-self-center"><input type=checkbox class="d-flex sidebar-checkbox" aria-label="Close or Expand Guides Section"> <label for=collapse-c8ab9da3 class="sidebar-label collapsed" data-bs-toggle=collapse data-bs-target=#collapse-c8ab9da3 aria-expanded=false aria-label="Close or Expand Guides Section"><svg class="flex bi sidebar-icon plus"><use xlink:href="#plus"/></svg><svg class="flex bi sidebar-icon x"><use xlink:href="#x"/></svg></label></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/disaster-recovery/>Disaster Recovery with Crossplane</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/write-a-composition-function-in-go/>Write a Composition Function in Go</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/write-a-composition-function-in-python/>Write a Composition Function in Python</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/import-existing-resources/>Import Existing Resources</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/vault-as-secret-store/>Vault as an External Secret Store</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/vault-injection/>Vault Credential Injection</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/multi-tenant/>Multi-Tenant Crossplane</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/crossplane-with-argo-cd/>Configuring Crossplane with Argo CD</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/self-signed-ca-certs/>Self-Signed CA Certs</a></div></div><div class="container flex-row collapse" id=collapse-c8ab9da3><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/guides/troubleshoot-crossplane/>Troubleshoot Crossplane</a></div></div></div><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100"><a class="d-flex w-100 border-0" href=https://docs.crossplane.io/v1.16/cli/>CLI Reference</a><div class="d-flex flex-shrink-1 sidebar-control-container align-self-center"><input type=checkbox class="d-flex sidebar-checkbox" aria-label="Close or Expand CLI Reference Section"> <label for=collapse-2f1c64f4 class="sidebar-label collapsed" data-bs-toggle=collapse data-bs-target=#collapse-2f1c64f4 aria-expanded=false aria-label="Close or Expand CLI Reference Section"><svg class="flex bi sidebar-icon plus"><use xlink:href="#plus"/></svg><svg class="flex bi sidebar-icon x"><use xlink:href="#x"/></svg></label></div></div><div class="container flex-row collapse" id=collapse-2f1c64f4><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/cli/command-reference/>Command Reference</a></div></div></div><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100"><a class="d-flex w-100 border-0" href=https://docs.crossplane.io/v1.16/api/>API Reference</a><div class="d-flex flex-shrink-1 sidebar-control-container align-self-center"><input type=checkbox class="d-flex sidebar-checkbox" aria-label="Close or Expand API Reference Section"> <label for=collapse-569451c8 class="sidebar-label collapsed" data-bs-toggle=collapse data-bs-target=#collapse-569451c8 aria-expanded=false aria-label="Close or Expand API Reference Section"><svg class="flex bi sidebar-icon plus"><use xlink:href="#plus"/></svg><svg class="flex bi sidebar-icon x"><use xlink:href="#x"/></svg></label></div></div></div><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100"><a class="d-flex w-100 border-0" href=https://docs.crossplane.io/v1.16/learn/>Learn More</a><div class="d-flex flex-shrink-1 sidebar-control-container align-self-center"><input type=checkbox class="d-flex sidebar-checkbox" aria-label="Close or Expand Learn More Section"> <label for=collapse-47924500 class="sidebar-label collapsed" data-bs-toggle=collapse data-bs-target=#collapse-47924500 aria-expanded=false aria-label="Close or Expand Learn More Section"><svg class="flex bi sidebar-icon plus"><use xlink:href="#plus"/></svg><svg class="flex bi sidebar-icon x"><use xlink:href="#x"/></svg></label></div></div><div class="container flex-row collapse" id=collapse-47924500><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/learn/release-cycle/>Release Cycle</a></div></div><div class="container flex-row collapse" id=collapse-47924500><div class="d-flex flex-column"><a class="bd-links d-flex" href=https://docs.crossplane.io/v1.16/learn/feature-lifecycle/>Feature Lifecycle</a></div></div></div><div class="section-container container pe-0 pt-1"><div class=nav-container><a href=https://docs.crossplane.io/contribute/ class="d-inline-flex align-items-center">Contributing Guide</a></div></div><div class="section-container container pe-0 pt-1"><div class="container nav-container pe-0 d-flex w-100"><a class="d-flex w-100 border-0" href="https://github.com/orgs/crossplane/projects/20/views/9?pane=info" target=_blank>Crossplane Roadmap</a><div class="d-flex flex-shrink-1 sidebar-control-container align-self-center"><a href="https://github.com/orgs/crossplane/projects/20/views/9?pane=info"><svg class="flex bi"><use xlink:href="#box-arrow-up-right"/></svg></a></div></div></div></nav></div></div></aside><main class="bd-main order-1"><div class="bd-intro pt-2 ps-lg-2"><div class="d-md-flex flex-md-row-reverse align-items-center justify-content-between"><div class="mb-3 mb-md-0 d-flex"><div class="dropdown float-end bd-dropdown"><a class="btn btn-outline-secondary dropdown-toggle bd-dropdown-item text-reset" href=# role=button id=dropdownMenuLink data-bs-toggle=dropdown aria-haspopup=true aria-expanded=false>v1.16</a><div class="dropdown-menu bd-border-color bd-dropdown" aria-labelledby=dropdownMenuLink><a class="dropdown-item bd-dropdown-item" href=https://docs.crossplane.io/master/concepts/compositions/>master</a> <a class="dropdown-item bd-dropdown-item" href=https://docs.crossplane.io/v1.18/concepts/compositions/>v1.18<div class="badge rounded-pill latest">Latest</div></a><a class="dropdown-item bd-dropdown-item" href=https://docs.crossplane.io/v1.17/concepts/compositions/>v1.17</a> <a class="dropdown-item bd-dropdown-item active" aria-current=true href=https://docs.crossplane.io/v1.16/concepts/compositions/>v1.16</a></div></div></div><h1 class="bd-title mb-0" id=content>Compositions</h1></div></div><div class="bd-toc mt-3 mb-5 my-lg-0 ps-xl-3 mb-lg-5"><button class="btn btn-link p-md-0 mb-2 mb-md-0 text-decoration-none bd-toc-toggle d-md-none" type=button data-bs-toggle=collapse data-bs-target=#tocContents aria-expanded=false aria-controls=tocContents> On this page<svg class="bi d-md-none ms-2" aria-hidden="true"><use xlink:href="#chevron-expand"/></svg></button> On this page<hr class="d-none d-md-block my-2"><div class="collapse bd-toc-collapse" id=tocContents><nav id=TableOfContents><ul class=nav><li class=nav-item><a class=nav-link href=#creating-compositions>Creating Compositions</a><ul class=nav><li class=nav-item><a class=nav-link href=#resource-templates>Resource templates</a><ul class=nav><li class=nav-item><a class=nav-link href=#template-a-managed-resource>Template a managed resource</a></li><li class=nav-item><a class=nav-link href=#template-a-providerconfig>Template a ProviderConfig</a></li><li class=nav-item><a class=nav-link href=#template-another-composite-resource>Template another Composite Resource</a></li><li class=nav-item><a class=nav-link href=#cross-resource-references>Cross-resource references</a><ul class=nav><li class=nav-item><a class=nav-link href=#match-resource-labels>Match resource labels</a></li><li class=nav-item><a class=nav-link href=#match-a-controller-reference>Match a controller reference</a></li></ul></li></ul></li><li class=nav-item><a class=nav-link href=#enabling-composite-resources>Enabling Composite Resources</a></li><li class=nav-item><a class=nav-link href=#changing-resource-fields>Changing resource fields</a><ul class=nav><li class=nav-item><a class=nav-link href=#patch-sets>Patch sets</a></li><li class=nav-item><a class=nav-link href=#patch-with-environmentconfigs>Patch with EnvironmentConfigs</a><ul class=nav><li class=nav-item><a class=nav-link href=#patch-a-composite-resource>Patch a composite resource</a></li><li class=nav-item><a class=nav-link href=#patch-an-individual-resource>Patch an individual resource</a></li></ul></li></ul></li><li class=nav-item><a class=nav-link href=#use-composition-functions>Use composition functions</a></li><li class=nav-item><a class=nav-link href=#storing-connection-details>Storing connection details</a><ul class=nav><li class=nav-item><a class=nav-link href=#composite-resource-combined-secret>Composite resource combined secret</a></li><li class=nav-item><a class=nav-link href=#composed-resource-secrets>Composed resource secrets</a></li><li class=nav-item><a class=nav-link href=#define-secret-keys>Define secret keys</a></li><li class=nav-item><a class=nav-link href=#save-connection-details-to-an-external-secret-store>Save connection details to an external secret store</a></li></ul></li><li class=nav-item><a class=nav-link href=#resource-readiness-checks>Resource readiness checks</a><ul class=nav><li class=nav-item><a class=nav-link href=#match-a-string>Match a string</a></li><li class=nav-item><a class=nav-link href=#match-an-integer>Match an integer</a></li><li class=nav-item><a class=nav-link href=#match-that-a-field-exists>Match that a field exists</a></li><li class=nav-item><a class=nav-link href=#always-consider-a-resource-ready>Always consider a resource ready</a></li><li class=nav-item><a class=nav-link href=#match-a-condition>Match a condition</a></li><li class=nav-item><a class=nav-link href=#match-a-boolean>Match a boolean</a></li></ul></li></ul></li><li class=nav-item><a class=nav-link href=#verify-a-composition>Verify a Composition</a></li><li class=nav-item><a class=nav-link href=#composition-validation>Composition validation</a><ul class=nav><li class=nav-item><a class=nav-link href=#composition-schema-aware-validation>Composition schema aware validation</a><ul class=nav><li class=nav-item><a class=nav-link href=#schema-aware-validation-modes>Schema aware validation modes</a></li></ul></li></ul></li></ul></li></ul></nav><nav class=pt-3><div class=pb-2><svg class="bi" width="1em" height="1em"><use xlink:href="#pencil-square"/></svg><a target=_blank href="https://github.com/crossplane/docs/issues/new?title=[Web%20Bug]%20-%20Compositions&body=%3c!--%20What%27s%20the%20problem?%20--%3e%0a%0a%0aURL:%20https://docs.crossplane.io/v1.16/concepts/compositions/">Report a problem</a></div><div><svg class="bi" width="1em" height="1em"><use xlink:href="#github"/></svg><a href=https://github.com/crossplane/docs/tree/master/content/v1.16/concepts/compositions.md>View page source</a></div></div></nav></div><div class="bd-content ps-lg-2 DocSearch-content"><div class="bd-callout bd-callout-info d-flex flex-column w-100"><div class="d-flex bd-title fs-6 fw-bold border-bottom border-info"><div class="d-flex pe-3 align-self-center"><svg class="bi flex-shrink-0" role="img" aria-label="Info:"><use xlink:href="#info"/></svg></div><div class=d-flex>This document is for an older version of Crossplane.</div></div><div class=mt-3>This document applies to Crossplane version v1.16 and not to the latest release v1.18.</div></div>Compositions are a template for creating multiple managed resources as a single object.A Composition composes individual managed resources together into a larger, reusable, solution.An example Composition may combine a virtual machine, storage resources and networking policies. A Composition template links all these individual resources together.<div class="accordion mb-3" id=confused-about-compositions-xrds-xrs-and-claims-1169-Parent><div class=accordion-item><h2 class=accordion-header id=confused-about-compositions-xrds-xrs-and-claims-1169><button class="accordion-button collapsed" type=button data-bs-toggle=collapse data-bs-target=#confused-about-compositions-xrds-xrs-and-claims-1169-Content aria-expanded=false aria-controls=confused-about-compositions-xrds-xrs-and-claims-1169-Content> Confused about Compositions, XRDs, XRs and Claims?</button></h2><div id=confused-about-compositions-xrds-xrs-and-claims-1169-Content class="accordion-collapse collapse" aria-labelledby=confused-about-compositions-xrds-xrs-and-claims-1169 data-bs-parent=#confused-about-compositions-xrds-xrs-and-claims-1169-Parent><div class="accordion-body rounded-bottom">Crossplane has four core components that users commonly mix up:<ul><li>Compositions - This page. A template to define how to create resources.</li><li><a href=https://docs.crossplane.io/v1.16/concepts/composite-resource-definitions/>Composite Resource Definition</a> (<code>XRD</code>) - A custom API specification.</li><li><a href=https://docs.crossplane.io/v1.16/concepts/composite-resources/>Composite Resource</a> (<code>XR</code>) - Created by using the custom API defined in a Composite Resource Definition. XRs use the Composition template to create new managed resources.</li><li><a href=https://docs.crossplane.io/v1.16/concepts/claims/>Claims</a> (<code>XRC</code>) - Like a Composite Resource, but with namespace scoping.</li></ul></div></div></div></div><h2 id=creating-compositions>Creating Compositions <a class=anchor-link id=creating-compositions href=#creating-compositions aria-label="Link to this section: Creating Compositions"></a></h2>Creating Compositions consists of:<ul><li><a href=#resource-templates>Resource templates</a> defining the resources to create.</li><li><a href=#enabling-composite-resources>Enabling Composite Resources</a> to use this Composition template.</li></ul>Optionally, Compositions also support:<ul><li><a href=#changing-resource-fields>Modifying and patching</a> resource settings.</li><li><a href=#storing-connection-details>Storing connection details</a> and secrets generated by the managed resources.</li><li>Using <a href=#use-composition-functions>Composition Functions</a> to template resources using custom programs.</li><li>Creating a <a href=#resource-readiness-checks>custom check of when a resource is ready</a> to use.</li></ul><h3 id=resource-templates>Resource templates <a class=anchor-link id=resource-templates href=#resource-templates aria-label="Link to this section: Resource templates"></a></h3>The <code><highlight-term id=1731573034373137441 data-label=resources data-line=4>resources</highlight-term></code> field of a Composition’s <code><highlight-term id=1731573034373260080 data-label=resources data-line=3>spec</highlight-term></code> defines the set of things that a Composite Resource creates.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Read more about Composite Resources in the <a href=https://docs.crossplane.io/v1.16/concepts/composite-resources/>Composite Resources page</a>.</div></div>For example, a Composition can define a template to create a virtual machine and an associated storage bucket at the same time.The <code><highlight-term id=1731573034373550403 data-label=resources data-line=4>resources</highlight-term></code> field lists the individual resources with a <code><highlight-term id=1731573034373731596 data-label=resources data-line=5>name</highlight-term></code>. This name identifies the resource inside the Composition and isn’t related to the external name used with the Provider.<h4 id=template-a-managed-resource>Template a managed resource <a class=anchor-link id=template-a-managed-resource href=#template-a-managed-resource aria-label="Link to this section: Template a managed resource"></a></h4>The contents of the <code><highlight-term id=1731573034373837446 data-label=resources data-line=6>base</highlight-term></code> are identical to creating a standalone <a href=https://docs.crossplane.io/v1.16/concepts/managed-resources/>managed resource</a>.This example uses <a href=https://marketplace.upbound.io/providers/upbound/provider-aws/v0.35.0>Upbound’s Provider AWS</a> to define a S3 storage <code><highlight-term id=1731573034374046248 data-label=resources data-line=8>Bucket</highlight-term></code> and EC2 compute <code><highlight-term id=1731573034374149047 data-label=resources data-line=15>Instance</highlight-term></code>.After defining the <code><highlight-term id=1731573034374273064 data-label=resources data-line=7>apiVersion</highlight-term></code> and <code><highlight-term id=1731573034374366757 data-label=resources data-line=8>kind</highlight-term></code>, define the <code><highlight-term id=1731573034374480544 data-label=resources data-line=10>spec.forProvider</highlight-term></code> fields defining the settings of the resource.<div class=highlight copy-lines=none label=resources><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-0-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-0-2> 2</a>kind: Composition <a class=lnlinks href=#hl-0-3> 3</a>spec: <a class=lnlinks href=#hl-0-4> 4</a> resources: <a class=lnlinks href=#hl-0-5> 5</a> - name: StorageBucket <a class=lnlinks href=#hl-0-6> 6</a> base: <a class=lnlinks href=#hl-0-7> 7</a> apiVersion: s3.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-0-8> 8</a> kind: Bucket <a class=lnlinks href=#hl-0-9> 9</a> spec: <a class=lnlinks href=#hl-0-10>10</a> forProvider: <a class=lnlinks href=#hl-0-11>11</a> region: "us-east-2" <a class=lnlinks href=#hl-0-12>12</a> - name: VM <a class=lnlinks href=#hl-0-13>13</a> base: <a class=lnlinks href=#hl-0-14>14</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-0-15>15</a> kind: Instance <a class=lnlinks href=#hl-0-16>16</a> spec: <a class=lnlinks href=#hl-0-17>17</a> forProvider: <a class=lnlinks href=#hl-0-18>18</a> ami: ami-0d9858aa3c6322f73 <a class=lnlinks href=#hl-0-19>19</a> instanceType: t2.micro <a class=lnlinks href=#hl-0-20>20</a> region: "us-east-2" </code></pre></div>When a <a href=https://docs.crossplane.io/v1.16/concepts/composite-resources/>Composite Resource</a> uses this Composition template, the Composite Resource creates two new managed resources with all the provided <code><highlight-term id=1731573034374663143 data-label=resources data-line=17>spec.forProvider</highlight-term></code> settings.The <code><highlight-term id=1731573034374753628 data-label=resources data-line=16>spec</highlight-term></code> supports any settings used in a managed resource including applying <code>annotations</code> and <code>labels</code> or using a specific <code>providerConfigRef</code>.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Compositions allow applying a <code>metadata.name</code> to a resource’s <code><highlight-term id=1731573034374851419 data-label=resources data-line=16>spec</highlight-term></code> but ignores it. The <code>metadata.name</code> field doesn’t influence the name of the managed resource in Crossplane or the external resource inside the Provider.Use the <code>crossplane.io/external-name</code> annotation on the resource to influence the external resource name.</div></div><h4 id=template-a-providerconfig>Template a ProviderConfig <a class=anchor-link id=template-a-providerconfig href=#template-a-providerconfig aria-label="Link to this section: Template a ProviderConfig"></a></h4>Compositions can define a ProviderConfig like it defines managed resources. Generating a ProviderConfig may be useful in providing unique credentials to each deployment.<div class=highlight copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-1-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-1-2> 2</a>kind: Composition <a class=lnlinks href=#hl-1-3> 3</a>spec: <a class=lnlinks href=#hl-1-4> 4</a> resources: <a class=lnlinks href=#hl-1-5> 5</a> - name: my-aws-provider-config <a class=lnlinks href=#hl-1-6> 6</a> base: <a class=lnlinks href=#hl-1-7> 7</a> apiVersion: aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-1-8> 8</a> kind: ProviderConfig <a class=lnlinks href=#hl-1-9> 9</a> spec: <a class=lnlinks href=#hl-1-10>10</a> source: Secret <a class=lnlinks href=#hl-1-11>11</a> secretRef: <a class=lnlinks href=#hl-1-12>12</a> namespace: crossplane-system <a class=lnlinks href=#hl-1-13>13</a> name: aws-secret <a class=lnlinks href=#hl-1-14>14</a> key: creds </code></pre></div><h4 id=template-another-composite-resource>Template another Composite Resource <a class=anchor-link id=template-another-composite-resource href=#template-another-composite-resource aria-label="Link to this section: Template another Composite Resource"></a></h4>Compositions can use other Composite Resources to define more complicated templates.A common use case is a Composition that uses other Compositions. For example, creating a Composition to create a standard set of networking resources that other Compositions reference.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Both Compositions must have corresponding XRDs.</div></div>This example networking Composition defines the set of resources required to create a new AWS virtual network. This includes a <code><highlight-term id=1731573034375240693 data-label=xnetwork data-line=8>VPC</highlight-term></code>, <code><highlight-term id=1731573034375412001 data-label=xnetwork data-line=13>InternetGateway</highlight-term></code> and <code><highlight-term id=1731573034375505594 data-label=xnetwork data-line=18>Subnet</highlight-term></code>.<div class=highlight copy-lines=none label=xnetwork><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-2-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-2-2> 2</a>kind: Composition <a class=lnlinks href=#hl-2-3> 3</a>spec: <a class=lnlinks href=#hl-2-4> 4</a> resources: <a class=lnlinks href=#hl-2-5> 5</a> - name: vpc-resource <a class=lnlinks href=#hl-2-6> 6</a> base: <a class=lnlinks href=#hl-2-7> 7</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-2-8> 8</a> kind: VPC <a class=lnlinks href=#hl-2-9> 9</a> # Removed for Brevity <a class=lnlinks href=#hl-2-10>10</a> - name: gateway-resource <a class=lnlinks href=#hl-2-11>11</a> base: <a class=lnlinks href=#hl-2-12>12</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-2-13>13</a> kind: InternetGateway <a class=lnlinks href=#hl-2-14>14</a> # Removed for Brevity <a class=lnlinks href=#hl-2-15>15</a> - name: subnet-resource <a class=lnlinks href=#hl-2-16>16</a> base: <a class=lnlinks href=#hl-2-17>17</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-2-18>18</a> kind: Subnet <a class=lnlinks href=#hl-2-19>19</a> # Removed for Brevity <a class=lnlinks href=#hl-2-20>20</a> compositeTypeRef: <a class=lnlinks href=#hl-2-21>21</a> apiVersion: aws.platformref.upbound.io/v1alpha1 <a class=lnlinks href=#hl-2-22>22</a> kind: XNetwork </code></pre></div>The <code><highlight-term id=1731573034375587631 data-label=xnetwork data-line=20>compositeTypeRef</highlight-term></code> gives this Composition an <code><highlight-term id=1731573034375654496 data-label=xnetwork data-line=21>apiVersion</highlight-term></code> and <code><highlight-term id=1731573034375734108 data-label=xnetwork data-line=22>kind</highlight-term></code> to reference in another Composition.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>The <a href=#enabling-composite-resources>Enabling a Composite Resource</a> section describes the <code><highlight-term id=1731573034375824890 data-label=xnetwork data-line=20>compositeTypeRef</highlight-term></code> field.</div></div>A second Composition, defining other resources, in this example, an AWS Elastic Kubernetes Cluster, can reference the previous <code><highlight-term id=1731573034376044824 data-label=xnetwork data-line=22>XNetwork</highlight-term></code><div class=highlight copy-lines=none label=xcluster><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-3-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-3-2> 2</a>kind: Composition <a class=lnlinks href=#hl-3-3> 3</a>spec: <a class=lnlinks href=#hl-3-4> 4</a> resources: <a class=lnlinks href=#hl-3-5> 5</a> - name: nested-network-composition <a class=lnlinks href=#hl-3-6> 6</a> base: <a class=lnlinks href=#hl-3-7> 7</a> apiVersion: aws.platformref.upbound.io/v1alpha1 <a class=lnlinks href=#hl-3-8> 8</a> kind: XNetwork <a class=lnlinks href=#hl-3-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-3-10>10</a> - name: eks-cluster-resource <a class=lnlinks href=#hl-3-11>11</a> base: <a class=lnlinks href=#hl-3-12>12</a> apiVersion: eks.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-3-13>13</a> kind: Cluster <a class=lnlinks href=#hl-3-14>14</a> # Removed for brevity </code></pre></div>When a Composite Resource creates all the managed resources from this Composition, the resources defined by the <code><highlight-term id=1731573034376134337 data-label=xcluster data-line=8>XNetwork</highlight-term></code> get created along with the EKS <code><highlight-term id=1731573034376221686 data-label=xcluster data-line=13>cluster</highlight-term></code>.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>This abbreviated example is from the Upbound <a href=https://github.com/upbound/platform-ref-aws>AWS Reference Platform</a>.View the complete Compositions in the reference platform’s <a href=https://github.com/upbound/platform-ref-aws/blob/main/apis/cluster/composition.yaml>package directory</a>.</div></div><h4 id=cross-resource-references>Cross-resource references <a class=anchor-link id=cross-resource-references href=#cross-resource-references aria-label="Link to this section: Cross-resource references"></a></h4>Inside a Composition some resources use identifiers or names of other resources. For example, creating a new <code>network</code> and applying the network identifier to a virtual machine.Resources inside a Composition can cross-reference other resources by matching a label or a controller reference.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Providers allow matching of labels and controller references on a per-resource basis. Check the documentation for the specific Provider resource to see what’s supported.Matching labels and controllers isn’t supported across different Providers.</div></div><h5 id=match-resource-labels>Match resource labels <a class=anchor-link id=match-resource-labels href=#match-resource-labels aria-label="Link to this section: Match resource labels"></a></h5>To match a resource label, first apply a <code><highlight-term id=1731573034376703695 data-label=matchlabel data-line=11>label</highlight-term></code> to the resource to match and use <code><highlight-term id=1731573034376790619 data-label=matchlabel data-line=19>matchLabels</highlight-term></code> in the second resource.This example creates a AWS <code><highlight-term id=1731573034376878156 data-label=matchlabel data-line=7>Role</highlight-term></code> and applies a <code><highlight-term id=1731573034376960220 data-label=matchlabel data-line=11>label</highlight-term></code>. The second resource is a <code><highlight-term id=1731573034377054252 data-label=matchlabel data-line=14>RolePolicyAttachment</highlight-term></code>, which requires attaching to an existing <code>Role</code>.Using the resource’s <code><highlight-term id=1731573034377137987 data-label=matchlabel data-line=19>roleSelector.matchLabels</highlight-term></code> ensures this <code><highlight-term id=1731573034377225833 data-label=matchlabel data-line=14>RolePolicyAttachment</highlight-term></code> references the matching <code><highlight-term id=1731573034377310959 data-label=matchlabel data-line=7>Role</highlight-term></code>, even if the unique role identifier isn’t known.<div class=highlight label=matchlabel copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-4-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-4-2> 2</a>kind: Composition <a class=lnlinks href=#hl-4-3> 3</a>spec: <a class=lnlinks href=#hl-4-4> 4</a> resources: <a class=lnlinks href=#hl-4-5> 5</a> - base: <a class=lnlinks href=#hl-4-6> 6</a> apiVersion: iam.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-4-7> 7</a> kind: Role <a class=lnlinks href=#hl-4-8> 8</a> name: iamRole <a class=lnlinks href=#hl-4-9> 9</a> metadata: <a class=lnlinks href=#hl-4-10>10</a> labels: <a class=lnlinks href=#hl-4-11>11</a> role: controlplane <a class=lnlinks href=#hl-4-12>12</a> - base: <a class=lnlinks href=#hl-4-13>13</a> apiVersion: iam.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-4-14>14</a> kind: RolePolicyAttachment <a class=lnlinks href=#hl-4-15>15</a> name: iamPolicy <a class=lnlinks href=#hl-4-16>16</a> spec: <a class=lnlinks href=#hl-4-17>17</a> forProvider: <a class=lnlinks href=#hl-4-18>18</a> roleSelector: <a class=lnlinks href=#hl-4-19>19</a> matchLabels: <a class=lnlinks href=#hl-4-20>20</a> role: controlplane <a class=lnlinks href=#hl-4-21>21</a> # Removed for brevity </code></pre></div><h5 id=match-a-controller-reference>Match a controller reference <a class=anchor-link id=match-a-controller-reference href=#match-a-controller-reference aria-label="Link to this section: Match a controller reference"></a></h5>Matching a controller reference ensures that the matching resource is in the same composite resource.Matching only a controller reference simplifies the matching process without requiring labels or more information.For example, creating an AWS <code><highlight-term id=1731573034377397632 data-label=controller1 data-line=14>InternetGateway</highlight-term></code> requires a <code><highlight-term id=1731573034377443217 data-label=controller1 data-line=7>VPC</highlight-term></code>.The <code><highlight-term id=1731573034377520278 data-label=controller1 data-line=14>InternetGateway</highlight-term></code> could match a label, but every VPC created by this Composition share the same label.Using <code><highlight-term id=1731573034377603702 data-label=controller1 data-line=19>matchControllerRef</highlight-term></code> matches only the VPC created in the same composite resource that created the <code><highlight-term id=1731573034377681184 data-label=controller1 data-line=14>InternetGateway</highlight-term></code>.<div class=highlight label=controller1 copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-5-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-5-2> 2</a>kind: Composition <a class=lnlinks href=#hl-5-3> 3</a>spec: <a class=lnlinks href=#hl-5-4> 4</a> resources: <a class=lnlinks href=#hl-5-5> 5</a> - base: <a class=lnlinks href=#hl-5-6> 6</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-5-7> 7</a> kind: VPC <a class=lnlinks href=#hl-5-8> 8</a> name: my-vpc <a class=lnlinks href=#hl-5-9> 9</a> spec: <a class=lnlinks href=#hl-5-10>10</a> forProvider: <a class=lnlinks href=#hl-5-11>11</a> # Removed for brevity <a class=lnlinks href=#hl-5-12>12</a> - base: <a class=lnlinks href=#hl-5-13>13</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-5-14>14</a> kind: InternetGateway <a class=lnlinks href=#hl-5-15>15</a> name: my-gateway <a class=lnlinks href=#hl-5-16>16</a> spec: <a class=lnlinks href=#hl-5-17>17</a> forProvider: <a class=lnlinks href=#hl-5-18>18</a> vpcIdSelector: <a class=lnlinks href=#hl-5-19>19</a> matchControllerRef: true <a class=lnlinks href=#hl-5-20>20</a># Removed for brevity </code></pre></div>Resources can match both labels and a controller reference to match a specific resource in the larger composite resource.For example, this Composition creates two <code><highlight-term id=1731573034377854723 data-label=controller2 data-line=17>VPC</highlight-term></code> resources, but the <code><highlight-term id=1731573034377920491 data-label=controller2 data-line=27>InternetGateway</highlight-term></code> must match only one.Applying a <code><highlight-term id=1731573034378167847 data-label=controller2 data-line=21>label</highlight-term></code> to the second <code><highlight-term id=1731573034378215099 data-label=controller2 data-line=17>VPC</highlight-term></code> allows the <code><highlight-term id=1731573034378264892 data-label=controller2 data-line=27>InternetGateway</highlight-term></code> to match the label <code><highlight-term id=1731573034378308519 data-label=controller2 data-line=34>type: internet</highlight-term></code> and only match objects in the same composite resource with <code><highlight-term id=1731573034378353536 data-label=controller2 data-line=32>matchControllerRef</highlight-term></code>.<div class=highlight label=controller2 copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-6-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-6-2> 2</a>kind: Composition <a class=lnlinks href=#hl-6-3> 3</a>spec: <a class=lnlinks href=#hl-6-4> 4</a> resources: <a class=lnlinks href=#hl-6-5> 5</a> - base: <a class=lnlinks href=#hl-6-6> 6</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-6-7> 7</a> kind: VPC <a class=lnlinks href=#hl-6-8> 8</a> name: my-first-vpc <a class=lnlinks href=#hl-6-9> 9</a> metadata: <a class=lnlinks href=#hl-6-10>10</a> labels: <a class=lnlinks href=#hl-6-11>11</a> type: backend <a class=lnlinks href=#hl-6-12>12</a> spec: <a class=lnlinks href=#hl-6-13>13</a> forProvider: <a class=lnlinks href=#hl-6-14>14</a> # Removed for brevity <a class=lnlinks href=#hl-6-15>15</a> - base: <a class=lnlinks href=#hl-6-16>16</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-6-17>17</a> kind: VPC <a class=lnlinks href=#hl-6-18>18</a> name: my-second-vpc <a class=lnlinks href=#hl-6-19>19</a> metadata: <a class=lnlinks href=#hl-6-20>20</a> labels: <a class=lnlinks href=#hl-6-21>21</a> type: internet <a class=lnlinks href=#hl-6-22>22</a> spec: <a class=lnlinks href=#hl-6-23>23</a> forProvider: <a class=lnlinks href=#hl-6-24>24</a> # Removed for brevity <a class=lnlinks href=#hl-6-25>25</a> - base: <a class=lnlinks href=#hl-6-26>26</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-6-27>27</a> kind: InternetGateway <a class=lnlinks href=#hl-6-28>28</a> name: my-gateway <a class=lnlinks href=#hl-6-29>29</a> spec: <a class=lnlinks href=#hl-6-30>30</a> forProvider: <a class=lnlinks href=#hl-6-31>31</a> vpcIdSelector: <a class=lnlinks href=#hl-6-32>32</a> matchControllerRef: true <a class=lnlinks href=#hl-6-33>33</a> matchLabels: <a class=lnlinks href=#hl-6-34>34</a> type: internet <a class=lnlinks href=#hl-6-35>35</a># Removed for brevity </code></pre></div><h3 id=enabling-composite-resources>Enabling Composite Resources <a class=anchor-link id=enabling-composite-resources href=#enabling-composite-resources aria-label="Link to this section: Enabling Composite Resources"></a></h3>A Composition is only a template defining how to create managed resources. A Composition limits which Composite Resources can use this template.A Composition’s <code><highlight-term id=1731573034378452901 data-label=typeref data-line=6>compositeTypeRef</highlight-term></code> defines which Composite Resource type can use this Composition.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Read more about Composite Resources in the <a href=https://docs.crossplane.io/v1.16/concepts/composite-resources/>Composite Resources page</a>.</div></div>Inside a Composition’s <code><highlight-term id=1731573034378655847 data-label=typeref data-line=5>spec</highlight-term></code> define the Composite Resource <code><highlight-term id=1731573034378729269 data-label=typeref data-line=7>apiVersion</highlight-term></code> and <code><highlight-term id=1731573034378802798 data-label=typeref data-line=8>kind</highlight-term></code> that the Composition allows to use this template.<div class=highlight label=typeref copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-7-1>1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-7-2>2</a>kind: Composition <a class=lnlinks href=#hl-7-3>3</a>metadata: <a class=lnlinks href=#hl-7-4>4</a> name: dynamodb-with-bucket <a class=lnlinks href=#hl-7-5>5</a>spec: <a class=lnlinks href=#hl-7-6>6</a> compositeTypeRef: <a class=lnlinks href=#hl-7-7>7</a> apiVersion: custom-api.example.org/v1alpha1 <a class=lnlinks href=#hl-7-8>8</a> kind: database <a class=lnlinks href=#hl-7-9>9</a> # Removed for brevity </code></pre></div><h3 id=changing-resource-fields>Changing resource fields <a class=anchor-link id=changing-resource-fields href=#changing-resource-fields aria-label="Link to this section: Changing resource fields"></a></h3>Most Compositions require customizing the fields of the resources. This can include applying unique passwords, modifying where to deploy resources, or applying labels or annotations.The primary method to change resources is using a resource <a href=https://docs.crossplane.io/v1.16/concepts/patch-and-transform/>patch and transform</a>. Patch and transforms allow matching specific input fields, modifying them and applying them to the managed resource.<div class="admonition important d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="important:"><use xlink:href="#exclamation"/></svg>Important</div><div class=admonition-content>The details of creating patch and transforms and their options are in the <a href=https://docs.crossplane.io/v1.16/concepts/patch-and-transform/>Patch and Transform page</a>.This section describes applying patches and transforms to Compositions.</div></div>Apply patches to individual <code>resources</code> with the <code><highlight-term id=1731573034379103590 data-label=patch data-line=13>patches</highlight-term></code> field.For example, taking the <code><highlight-term id=1731573034379181834 data-label=patchClaim data-line=6>location</highlight-term></code> provided in a Claim and applying it to the <code><highlight-term id=1731573034379266849 data-label=patch data-line=12>region</highlight-term></code> value in the managed resource.<div class=highlight copy-lines=none label=patchClaim><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-8-1>1</a>apiVersion: example.org/v1alpha1 <a class=lnlinks href=#hl-8-2>2</a>kind: ExampleClaim <a class=lnlinks href=#hl-8-3>3</a>metadata: <a class=lnlinks href=#hl-8-4>4</a> name: my-example-claim <a class=lnlinks href=#hl-8-5>5</a>spec: <a class=lnlinks href=#hl-8-6>6</a> location: "eu-north-1" </code></pre></div>The Composition patch uses the <code><highlight-term id=1731573034379339397 data-label=patch data-line=15>fromFieldPath</highlight-term></code> to match the <code><highlight-term id=1731573034379420250 data-label=patchClaim data-line=6>location</highlight-term></code> field in the Claim and the <code><highlight-term id=1731573034379494848 data-label=patch data-line=16>toFieldPath</highlight-term></code> to define which field to change inside the Composition.<div class=highlight copy-lines=none label=patch><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-9-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-9-2> 2</a>kind: Composition <a class=lnlinks href=#hl-9-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-9-4> 4</a>spec: <a class=lnlinks href=#hl-9-5> 5</a> resources: <a class=lnlinks href=#hl-9-6> 6</a> - name: s3Bucket <a class=lnlinks href=#hl-9-7> 7</a> base: <a class=lnlinks href=#hl-9-8> 8</a> apiVersion: s3.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-9-9> 9</a> kind: Bucket <a class=lnlinks href=#hl-9-10>10</a> spec: <a class=lnlinks href=#hl-9-11>11</a> forProvider: <a class=lnlinks href=#hl-9-12>12</a> region: "us-east-2" <a class=lnlinks href=#hl-9-13>13</a> patches: <a class=lnlinks href=#hl-9-14>14</a> - type: FromCompositeFieldPath <a class=lnlinks href=#hl-9-15>15</a> fromFieldPath: "spec.location" <a class=lnlinks href=#hl-9-16>16</a> toFieldPath: "spec.forProvider.region" </code></pre></div><h4 id=patch-sets>Patch sets <a class=anchor-link id=patch-sets href=#patch-sets aria-label="Link to this section: Patch sets"></a></h4>Some Compositions have resources which need identical patches applied. Instead of repeating the same <code>patches</code> field, resources can reference a single <code>patchSet</code>.Define a <code><highlight-term id=1731573034379783411 data-label=patchset data-line=5>patchSet</highlight-term></code> with a <code><highlight-term id=1731573034379857802 data-label=patchset data-line=6>name</highlight-term></code> and <code><highlight-term id=1731573034379942766 data-label=patchset data-line=7>patch</highlight-term></code> operations.Then apply the <code><highlight-term id=1731573034380014681 data-label=patchset data-line=5>patchSet</highlight-term></code> to each resource with <code><highlight-term id=1731573034380099745 data-label=patchset data-line=16>type: patchSet</highlight-term></code>, referencing the <code><highlight-term id=1731573034380170878 data-label=patchset data-line=6>name</highlight-term></code> in the <code><highlight-term id=1731573034380245698 data-label=patchset data-line=17>patchSetName</highlight-term></code> field.<div class=highlight copy-lines=none label=patchset><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-10-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-10-2> 2</a>kind: Composition <a class=lnlinks href=#hl-10-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-10-4> 4</a>spec: <a class=lnlinks href=#hl-10-5> 5</a> patchSets: <a class=lnlinks href=#hl-10-6> 6</a> - name: reusable-patch <a class=lnlinks href=#hl-10-7> 7</a> patches: <a class=lnlinks href=#hl-10-8> 8</a> - type: FromCompositeFieldPath <a class=lnlinks href=#hl-10-9> 9</a> fromFieldPath: "location" <a class=lnlinks href=#hl-10-10>10</a> toFieldPath: "spec.forProvider.region" <a class=lnlinks href=#hl-10-11>11</a> resources: <a class=lnlinks href=#hl-10-12>12</a> - name: first-resource <a class=lnlinks href=#hl-10-13>13</a> base: <a class=lnlinks href=#hl-10-14>14</a> # Removed for Brevity <a class=lnlinks href=#hl-10-15>15</a> patches: <a class=lnlinks href=#hl-10-16>16</a> - type: PatchSet <a class=lnlinks href=#hl-10-17>17</a> patchSetName: reusable-patch <a class=lnlinks href=#hl-10-18>18</a> - name: second-resource <a class=lnlinks href=#hl-10-19>19</a> base: <a class=lnlinks href=#hl-10-20>20</a> # Removed for Brevity <a class=lnlinks href=#hl-10-21>21</a> patches: <a class=lnlinks href=#hl-10-22>22</a> - type: PatchSet <a class=lnlinks href=#hl-10-23>23</a> patchSetName: reusable-patch </code></pre></div><h4 id=patch-with-environmentconfigs>Patch with EnvironmentConfigs <a class=anchor-link id=patch-with-environmentconfigs href=#patch-with-environmentconfigs aria-label="Link to this section: Patch with EnvironmentConfigs"></a></h4>Crossplane uses EnvironmentConfigs to create in-memory data stores. Compositions can read and write from this data store as part of the patch process.<div class="admonition important d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="important:"><use xlink:href="#exclamation"/></svg>Important</div><div class=admonition-content>EnvironmentConfigs are an alpha feature. Alpha features aren’t enabled by default.</div></div>EnvironmentConfigs can predefine data that Compositions can use or a Composite Resource can write data to their in-memory environment for other resources to read.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Read the <a href=https://docs.crossplane.io/v1.16/concepts/environment-configs/>EnvironmentConfigs</a> page for more information on using EnvironmentConfigs.</div></div>To apply a patch using EnvironmentConfigs, first define which EnvironmentConfigs to use with <code><highlight-term id=1731573034380597507 data-label=envselect data-line=6>environment.environmentConfigs</highlight-term></code>.Use either a <a href=https://docs.crossplane.io/v1.16/concepts/managed-resources/#matching-by-name-reference>reference</a> or a <a href=https://docs.crossplane.io/v1.16/concepts/managed-resources/#matching-by-selector>selector</a> to identify the EnvironmentConfigs to use.<div class=highlight label=envselect copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-11-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-11-2> 2</a>kind: Composition <a class=lnlinks href=#hl-11-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-11-4> 4</a>spec: <a class=lnlinks href=#hl-11-5> 5</a> environment: <a class=lnlinks href=#hl-11-6> 6</a> environmentConfigs: <a class=lnlinks href=#hl-11-7> 7</a> - ref: <a class=lnlinks href=#hl-11-8> 8</a> name: example-environment <a class=lnlinks href=#hl-11-9> 9</a> resources: <a class=lnlinks href=#hl-11-10>10</a> # Removed for Brevity </code></pre></div><h5 id=patch-a-composite-resource>Patch a composite resource <a class=anchor-link id=patch-a-composite-resource href=#patch-a-composite-resource aria-label="Link to this section: Patch a composite resource"></a></h5>To patch between the composite resource and the in-memory environment use <code><highlight-term id=1731573034380818660 data-label=xrpatch data-line=7>patches</highlight-term></code> inside of the <code><highlight-term id=1731573034380867357 data-label=xrpatch data-line=5>environment</highlight-term></code>.Use the <code><highlight-term id=1731573034380946554 data-label=xrpatch data-line=5>ToCompositeFieldPath</highlight-term></code> to copy data from the in-memory environment to the composite resource. Use the <code><highlight-term id=1731573034381016959 data-label=xrpatch data-line=5>FromCompositeFieldPath</highlight-term></code> to copy data from the composite resource to the in-memory environment.<div class=highlight label=xrpatch copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-12-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-12-2> 2</a>kind: Composition <a class=lnlinks href=#hl-12-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-12-4> 4</a>spec: <a class=lnlinks href=#hl-12-5> 5</a> environment: <a class=lnlinks href=#hl-12-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-12-7> 7</a> patches: <a class=lnlinks href=#hl-12-8> 8</a> - type: ToCompositeFieldPath <a class=lnlinks href=#hl-12-9> 9</a> fromFieldPath: tags <a class=lnlinks href=#hl-12-10>10</a> toFieldPath: metadata.labels[envTag] <a class=lnlinks href=#hl-12-11>11</a> - type: FromCompositeFieldPath <a class=lnlinks href=#hl-12-12>12</a> fromFieldPath: metadata.name <a class=lnlinks href=#hl-12-13>13</a> toFieldPath: newEnvironmentKey </code></pre></div>Individual resources can use any data written to their in-memory environment.<h5 id=patch-an-individual-resource>Patch an individual resource <a class=anchor-link id=patch-an-individual-resource href=#patch-an-individual-resource aria-label="Link to this section: Patch an individual resource"></a></h5>To patch an individual resource, inside the <code><highlight-term id=1731573034381083550 data-label=envpatch data-line=16>patches</highlight-term></code> of the resource, use <code><highlight-term id=1731573034381161142 data-label=envpatch data-line=17>ToEnvironmentFieldPath</highlight-term></code> to copy data from the resource to the in-memory environment. Use <code><highlight-term id=1731573034381206085 data-label=envpatch data-line=20>FromEnvironmentFieldPath</highlight-term></code> to copy data to the resource from the in-memory environment.<div class=highlight label=envpatch copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-13-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-13-2> 2</a>kind: Composition <a class=lnlinks href=#hl-13-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-13-4> 4</a>spec: <a class=lnlinks href=#hl-13-5> 5</a> environment: <a class=lnlinks href=#hl-13-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-13-7> 7</a> resources: <a class=lnlinks href=#hl-13-8> 8</a> # Removed for Brevity <a class=lnlinks href=#hl-13-9> 9</a> - name: vpc <a class=lnlinks href=#hl-13-10>10</a> base: <a class=lnlinks href=#hl-13-11>11</a> apiVersion: ec2.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-13-12>12</a> kind: VPC <a class=lnlinks href=#hl-13-13>13</a> spec: <a class=lnlinks href=#hl-13-14>14</a> forProvider: <a class=lnlinks href=#hl-13-15>15</a> cidrBlock: 172.16.0.0/16 <a class=lnlinks href=#hl-13-16>16</a> patches: <a class=lnlinks href=#hl-13-17>17</a> - type: ToEnvironmentFieldPath <a class=lnlinks href=#hl-13-18>18</a> fromFieldPath: status.atProvider.id <a class=lnlinks href=#hl-13-19>19</a> toFieldPath: vpcId <a class=lnlinks href=#hl-13-20>20</a> - type: FromEnvironmentFieldPath <a class=lnlinks href=#hl-13-21>21</a> fromFieldPath: tags <a class=lnlinks href=#hl-13-22>22</a> toFieldPath: spec.forProvider.tags </code></pre></div>The <a href=https://docs.crossplane.io/v1.16/concepts/environment-configs/>EnvironmentConfigs</a> page has more information on EnvironmentConfigs options and usage.<h3 id=use-composition-functions>Use composition functions <a class=anchor-link id=use-composition-functions href=#use-composition-functions aria-label="Link to this section: Use composition functions"></a></h3>Composition functions (or just functions, for short) are custom programs that template Crossplane resources. You can write a function to template resources using a general purpose programming language like Go or Python. Using a general purpose programming language allows a function to use more advanced logic to template resources, like loops and conditionals.<div class="admonition important d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="important:"><use xlink:href="#exclamation"/></svg>Important</div><div class=admonition-content>Composition functions is a beta feature. Crossplane enables beta functions by default. The <a href=https://docs.crossplane.io/v1.16/concepts/composition-functions/#disable-composition-functions>Composition Functions</a> page explains how to disable composition functions.</div></div>To use composition functions set the Composition <code><highlight-term id=1731573034381401711 data-label=xfn data-line=6>mode</highlight-term></code> to <code><highlight-term id=1731573034381445256 data-label=xfn data-line=6>Pipeline</highlight-term></code>.Define a <code><highlight-term id=1731573034381486358 data-label=xfn data-line=7>pipeline</highlight-term></code> of <code><highlight-term id=1731573034381552835 data-label=xfn data-line=8>steps</highlight-term></code>. Each <code><highlight-term id=1731573034381599011 data-label=xfn data-line=8>step</highlight-term></code> calls a Function.Each <code><highlight-term id=1731573034381693422 data-label=xfn data-line=8>step</highlight-term></code> uses a <code><highlight-term id=1731573034381767929 data-label=xfn data-line=9>functionRef</highlight-term></code> to reference the <code><highlight-term id=1731573034381833823 data-label=xfn data-line=10>name</highlight-term></code> of the Function to call.Some Functions also allow you to specify an <code><highlight-term id=1731573034381908749 data-label=xfn data-line=11>input</highlight-term></code>. The function defines the <code><highlight-term id=1731573034381999794 data-label=xfn data-line=13>kind</highlight-term></code> of input.<div class="admonition important d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="important:"><use xlink:href="#exclamation"/></svg>Important</div><div class=admonition-content>Compositions using <code><highlight-term id=1731573034382061977 data-label=xfn data-line=6>mode: Pipeline</highlight-term></code> can’t specify resource templates with a <code>resources</code> field.Use function “Patch and Transform” to create resource templates.</div></div>This example uses Function Patch and Transform. Function Patch and Transform is a function that implements Crossplane resource templates. You can use Function Patch and Transform to specify resource templates in a pipeline with other Functions.<div class=highlight label=xfn copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-14-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-14-2> 2</a>kind: Composition <a class=lnlinks href=#hl-14-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-14-4> 4</a>spec: <a class=lnlinks href=#hl-14-5> 5</a> # Removed for Brevity <a class=lnlinks href=#hl-14-6> 6</a> mode: Pipeline <a class=lnlinks href=#hl-14-7> 7</a> pipeline: <a class=lnlinks href=#hl-14-8> 8</a> - step: patch-and-transform <a class=lnlinks href=#hl-14-9> 9</a> functionRef: <a class=lnlinks href=#hl-14-10>10</a> name: function-patch-and-transform <a class=lnlinks href=#hl-14-11>11</a> input: <a class=lnlinks href=#hl-14-12>12</a> apiVersion: pt.fn.crossplane.io/v1beta1 <a class=lnlinks href=#hl-14-13>13</a> kind: Resources <a class=lnlinks href=#hl-14-14>14</a> resources: <a class=lnlinks href=#hl-14-15>15</a> - name: storage-bucket <a class=lnlinks href=#hl-14-16>16</a> base: <a class=lnlinks href=#hl-14-17>17</a> apiVersion: s3.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-14-18>18</a> kind: Bucket <a class=lnlinks href=#hl-14-19>19</a> spec: <a class=lnlinks href=#hl-14-20>20</a> forProvider: <a class=lnlinks href=#hl-14-21>21</a> region: "us-east-2" </code></pre></div>Read the <a href=https://docs.crossplane.io/v1.16/concepts/composition-functions/>composition functions</a> page for details on building and using composition functions.<h3 id=storing-connection-details>Storing connection details <a class=anchor-link id=storing-connection-details href=#storing-connection-details aria-label="Link to this section: Storing connection details"></a></h3>Some managed resources generate unique details like usernames, passwords, IP addresses, ports or other connection details.When resources inside a Composition create connection details Crossplane creates a Kubernetes secret object for each managed resource generating connection details.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>This section discusses creating Kubernetes secrets. Crossplane also supports using external secret stores like <a href=https://www.vaultproject.io/>HashiCorp Vault</a>.Read the <a href=https://docs.crossplane.io/v1.16/guides/vault-as-secret-store/>external secrets store guide</a> for more information on using Crossplane with an external secret store.</div></div><h4 id=composite-resource-combined-secret>Composite resource combined secret <a class=anchor-link id=composite-resource-combined-secret href=#composite-resource-combined-secret aria-label="Link to this section: Composite resource combined secret"></a></h4>Crossplane can combine all the secrets generated by the resources inside a Composition into a single Kubernetes secret and optionally copy the secret object for <a href=https://docs.crossplane.io/v1.16/concepts/claims/#claim-connection-secrets>Claims</a>.Set the value of <code><highlight-term id=1731573034382510092 data-label=writeConn data-line=5>writeConnectionSecretsToNamespace</highlight-term></code> to the namespace where Crossplane should store the combined secret object.<div class=highlight copy-lines=none label=writeConn><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-15-1>1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-15-2>2</a>kind: Composition <a class=lnlinks href=#hl-15-3>3</a># Removed for Brevity <a class=lnlinks href=#hl-15-4>4</a>spec: <a class=lnlinks href=#hl-15-5>5</a> writeConnectionSecretsToNamespace: my-namespace <a class=lnlinks href=#hl-15-6>6</a> resources: <a class=lnlinks href=#hl-15-7>7</a> # Removed for brevity </code></pre></div><h4 id=composed-resource-secrets>Composed resource secrets <a class=anchor-link id=composed-resource-secrets href=#composed-resource-secrets aria-label="Link to this section: Composed resource secrets"></a></h4>Inside the <code><highlight-term id=1731573034382553832 data-label=writeConnRes data-line=10>spec</highlight-term></code> of each resource producing connection details, define the <code><highlight-term id=1731573034382585431 data-label=writeConnRes data-line=13>writeConnectionSecretToRef</highlight-term></code>, with a <code><highlight-term id=1731573034382676035 data-label=writeConnRes data-line=14>namespace</highlight-term></code> and <code><highlight-term id=1731573034382719499 data-label=writeConnRes data-line=15>name</highlight-term></code> of the secret object for the resource.If a <code><highlight-term id=1731573034382786288 data-label=writeConnRes data-line=13>writeConnectionSecretToRef</highlight-term></code> isn’t defined, Crossplane doesn’t write any keys to the secret.<div class=highlight label=writeConnRes><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-16-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-16-2> 2</a>kind: Composition <a class=lnlinks href=#hl-16-3> 3</a>spec: <a class=lnlinks href=#hl-16-4> 4</a> writeConnectionSecretsToNamespace: other-namespace <a class=lnlinks href=#hl-16-5> 5</a> resources: <a class=lnlinks href=#hl-16-6> 6</a> - name: key <a class=lnlinks href=#hl-16-7> 7</a> base: <a class=lnlinks href=#hl-16-8> 8</a> apiVersion: iam.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-16-9> 9</a> kind: AccessKey <a class=lnlinks href=#hl-16-10>10</a> spec: <a class=lnlinks href=#hl-16-11>11</a> forProvider: <a class=lnlinks href=#hl-16-12>12</a> # Removed for brevity <a class=lnlinks href=#hl-16-13>13</a> writeConnectionSecretToRef: <a class=lnlinks href=#hl-16-14>14</a> namespace: docs <a class=lnlinks href=#hl-16-15>15</a> name: key1 </code></pre></div>Crossplane saves a secret with the <code><highlight-term id=1731573034382816345 data-label=viewComposedSec data-line=3>name</highlight-term></code> in the <code><highlight-term id=1731573034382844782 data-label=writeConnRes data-line=14>namespace</highlight-term></code> provided.<div class=highlight label=viewComposedSec><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><a class=lnlinks href=#hl-17-1>1</a>kubectl get secrets -n docs <a class=lnlinks href=#hl-17-2>2</a>NAME TYPE DATA AGE <a class=lnlinks href=#hl-17-3>3</a>key1 connection.crossplane.io/v1alpha1 4 4m30s </code></pre></div><div class="admonition tip d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="tip:"><use xlink:href="#check"/></svg>Tip</div><div class=admonition-content>Crossplane recommends using a <a href=https://docs.crossplane.io/v1.16/concepts/patch-and-transform/>Patch</a> to create a unique name for each secret.For example, a <code><highlight-term id=1731573034382906036 data-label=tipPatch data-line=15>patch</highlight-term></code> to add the unique identifier of the resource as the key name.<div class=highlight label=tipPatch copy-lines=14-20><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-0-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-0-2> 2</a>kind: Composition <a class=lnlinks href=#hl-0-3> 3</a>spec: <a class=lnlinks href=#hl-0-4> 4</a> # Removed for brevity <a class=lnlinks href=#hl-0-5> 5</a> resources: <a class=lnlinks href=#hl-0-6> 6</a> - name: key <a class=lnlinks href=#hl-0-7> 7</a> base: <a class=lnlinks href=#hl-0-8> 8</a> apiVersion: iam.aws.upbound.io/v1beta1 <a class=lnlinks href=#hl-0-9> 9</a> kind: AccessKey <a class=lnlinks href=#hl-0-10>10</a> spec: <a class=lnlinks href=#hl-0-11>11</a> # Removed for brevity <a class=lnlinks href=#hl-0-12>12</a> writeConnectionSecretToRef: <a class=lnlinks href=#hl-0-13>13</a> namespace: docs <a class=lnlinks href=#hl-0-14>14</a> name: key1 <a class=lnlinks href=#hl-0-15>15</a> patches: <a class=lnlinks href=#hl-0-16>16</a> - fromFieldPath: "metadata.uid" <a class=lnlinks href=#hl-0-17>17</a> toFieldPath: "spec.writeConnectionSecretToRef.name" <a class=lnlinks href=#hl-0-18>18</a> transforms: <a class=lnlinks href=#hl-0-19>19</a> - type: string <a class=lnlinks href=#hl-0-20>20</a> string: <a class=lnlinks href=#hl-0-21>21</a> fmt: "%s-secret" </code></pre></div></div></div><h4 id=define-secret-keys>Define secret keys <a class=anchor-link id=define-secret-keys href=#define-secret-keys aria-label="Link to this section: Define secret keys"></a></h4>A Composition must define the specific secret keys a resource creates with the <code><highlight-term id=1731573034383666494 data-label=conDeet data-line=14>connectionDetails</highlight-term></code> object.<div class="table-responsive border rounded"><table class="table table-sm"><thead><tr><th>Secret Type</th><th>Description</th></tr></thead><tbody><tr><td><code><highlight-term id=1731573034383701473 data-label=conDeet data-line=16>fromConnectionSecretKey</highlight-term></code></td><td>Create a secret key matching the key of a secret generated by the resource.</td></tr><tr><td><code><highlight-term id=1731573034383720976 data-label=conDeet data-line=18>fromFieldPath</highlight-term></code></td><td>Create a secret key matching a field path of the resource.</td></tr><tr><td><code><highlight-term id=1731573034383740951 data-label=conDeet data-line=20>value</highlight-term></code></td><td>Create a secret key with a predefined value.</td></tr></tbody></table></div><div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>The <code><highlight-term id=1731573034387991813 data-label=conDeet data-line=20>value</highlight-term></code> type must use a string value.The <code><highlight-term id=1731573034388013797 data-label=conDeet data-line=20>value</highlight-term></code> isn’t added to the individual resource secret object. The <code><highlight-term id=1731573034388030642 data-label=conDeet data-line=20>value</highlight-term></code> only appears in the combined composite resource secret.</div></div><div class=highlight label=conDeet copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-18-1> 1</a>kind: Composition <a class=lnlinks href=#hl-18-2> 2</a>spec: <a class=lnlinks href=#hl-18-3> 3</a> writeConnectionSecretsToNamespace: other-namespace <a class=lnlinks href=#hl-18-4> 4</a> resources: <a class=lnlinks href=#hl-18-5> 5</a> - name: key <a class=lnlinks href=#hl-18-6> 6</a> base: <a class=lnlinks href=#hl-18-7> 7</a> # Removed for brevity <a class=lnlinks href=#hl-18-8> 8</a> spec: <a class=lnlinks href=#hl-18-9> 9</a> forProvider: <a class=lnlinks href=#hl-18-10>10</a> # Removed for brevity <a class=lnlinks href=#hl-18-11>11</a> writeConnectionSecretToRef: <a class=lnlinks href=#hl-18-12>12</a> namespace: docs <a class=lnlinks href=#hl-18-13>13</a> name: key1 <a class=lnlinks href=#hl-18-14>14</a> connectionDetails: <a class=lnlinks href=#hl-18-15>15</a> - name: myUsername <a class=lnlinks href=#hl-18-16>16</a> fromConnectionSecretKey: username <a class=lnlinks href=#hl-18-17>17</a> - name: myFieldSecret <a class=lnlinks href=#hl-18-18>18</a> fromFieldPath: spec.forProvider.user <a class=lnlinks href=#hl-18-19>19</a> - name: myStaticSecret <a class=lnlinks href=#hl-18-20>20</a> value: "docs.crossplane.io" </code></pre></div>The <code><highlight-term id=1731573034388191039 data-label=conDeet data-line=14>connectionDetails</highlight-term></code> in a resource can reference a secret from a resource with <code><highlight-term id=1731573034388216780 data-label=conDeet data-line=16>fromConnectionSecretKey</highlight-term></code>, from another field in the resource with <code><highlight-term id=1731573034388241012 data-label=conDeet data-line=18>fromFieldPath</highlight-term></code> or a statically defined value with <code><highlight-term id=1731573034388263928 data-label=conDeet data-line=20>value</highlight-term></code>.Crossplane sets the secret key to the <code><highlight-term id=1731573034388288731 data-label=conDeet data-line=15>name</highlight-term></code> value.Describe the secret to view the secret keys inside the secret object.<div class="admonition tip d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="tip:"><use xlink:href="#check"/></svg>Tip</div><div class=admonition-content>If more than one resource generates secrets with the same secret key name, Crossplane only saves one value.Use a custom <code><highlight-term id=1731573034388312180 data-label=conDeet data-line=15>name</highlight-term></code> to create unique secret keys.</div></div><div class="admonition important d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="important:"><use xlink:href="#exclamation"/></svg>Important</div><div class=admonition-content>Crossplane only adds connection details listed in the <code><highlight-term id=1731573034388397612 data-label=conDeet data-line=16>connectionDetails</highlight-term></code> to the combined secret object. Any connection secrets in a managed resource, not defined in the <code><highlight-term id=1731573034388412953 data-label=conDeet data-line=16>connectionDetails</highlight-term></code> aren’t added to the combined secret object.</div></div><div class=highlight copy-lines=1><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><a class=lnlinks href=#hl-19-1> 1</a>kubectl describe secret <a class=lnlinks href=#hl-19-2> 2</a>Name: my-access-key-secret <a class=lnlinks href=#hl-19-3> 3</a>Namespace: default <a class=lnlinks href=#hl-19-4> 4</a>Labels: <none> <a class=lnlinks href=#hl-19-5> 5</a>Annotations: <none> <a class=lnlinks href=#hl-19-6> 6</a> <a class=lnlinks href=#hl-19-7> 7</a>Type: connection.crossplane.io/v1alpha1 <a class=lnlinks href=#hl-19-8> 8</a> <a class=lnlinks href=#hl-19-9> 9</a>Data <a class=lnlinks href=#hl-19-10>10</a>==== <a class=lnlinks href=#hl-19-11>11</a>myUsername: 20 bytes <a class=lnlinks href=#hl-19-12>12</a>myFieldSecret: 24 bytes <a class=lnlinks href=#hl-19-13>13</a>myStaticSecret: 18 bytes </code></pre></div><div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>The CompositeResourceDefinition can also limit which keys Crossplane stores from the composite resources. By default an XRD writes all secret keys listed in the composed resources <code>connectionDetails</code> to the combined secret object.Read the <a href=https://docs.crossplane.io/v1.16/concepts/composite-resource-definitions/#manage-connection-secrets>CompositeResourceDefinition documentation</a> for more information on restricting secret keys.</div></div>For more information on connection secrets read the <a href=https://docs.crossplane.io/v1.16/concepts/connection-details/>Connection Secrets knowledge base article</a>.<div class="admonition warning d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="warning:"><use xlink:href="#fire"/></svg>Warning</div><div class=admonition-content>You can’t change the <code><highlight-term id=1731573034388620877 data-label=conDeet data-line=16>connectionDetails</highlight-term></code> of a Composition. You must delete and recreate the Composition to change the <code><highlight-term id=1731573034388636987 data-label=conDeet data-line=16>connectionDetails</highlight-term></code> .</div></div><h4 id=save-connection-details-to-an-external-secret-store>Save connection details to an external secret store <a class=anchor-link id=save-connection-details-to-an-external-secret-store href=#save-connection-details-to-an-external-secret-store aria-label="Link to this section: Save connection details to an external secret store"></a></h4>Crossplane <a href=https://docs.crossplane.io/v1.16/guides/vault-as-secret-store/>External Secret Stores</a> write secrets and connection details to external secret stores like HashiCorp Vault.<div class="admonition important d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="important:"><use xlink:href="#exclamation"/></svg>Important</div><div class=admonition-content>External Secret Stores are an alpha feature.They’re not recommended for production use. Crossplane disables External Secret Stores by default.</div></div>Use <code><highlight-term id=1731573034388824039 data-label=gcp-storeconfig data-line=11>publishConnectionDetailsWithStoreConfigRef</highlight-term></code> in place of <code>writeConnectionSecretsToNamespace</code> to define the <code><highlight-term id=1731573034388848104 data-label=gcp-storeconfig data-line=2>StoreConfig</highlight-term></code> to save connection details to.For example, using a <code><highlight-term id=1731573034388870013 data-label=gcp-storeconfig data-line=2>StoreConfig</highlight-term></code> with the <code><highlight-term id=1731573034388891241 data-label=gcp-storeconfig data-line=4>name</highlight-term></code> “vault,” use <code><highlight-term id=1731573034388913326 data-label=gcp-storeconfig data-line=12>publishConnectionDetailsWithStoreConfigRef.name</highlight-term></code> matching the <code><highlight-term id=1731573034388935462 data-label=gcp-storeconfig data-line=4>StoreConfig.name</highlight-term></code>, in this example, “vault.”<div class=highlight label=gcp-storeconfig copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-20-1> 1</a>apiVersion: gcp.crossplane.io/v1alpha1 <a class=lnlinks href=#hl-20-2> 2</a>kind: StoreConfig <a class=lnlinks href=#hl-20-3> 3</a>metadata: <a class=lnlinks href=#hl-20-4> 4</a> name: vault <a class=lnlinks href=#hl-20-5> 5</a># Removed for brevity. <a class=lnlinks href=#hl-20-6> 6</a>--- <a class=lnlinks href=#hl-20-7> 7</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-20-8> 8</a>kind: Composition <a class=lnlinks href=#hl-20-9> 9</a># Removed for Brevity <a class=lnlinks href=#hl-20-10>10</a>spec: <a class=lnlinks href=#hl-20-11>11</a> publishConnectionDetailsWithStoreConfigRef: <a class=lnlinks href=#hl-20-12>12</a> name: vault <a class=lnlinks href=#hl-20-13>13</a> resources: <a class=lnlinks href=#hl-20-14>14</a> # Removed for brevity </code></pre></div>For more details read the <a href=https://docs.crossplane.io/v1.16/guides/vault-as-secret-store/>External Secret Stores</a> integration guide.<h3 id=resource-readiness-checks>Resource readiness checks <a class=anchor-link id=resource-readiness-checks href=#resource-readiness-checks aria-label="Link to this section: Resource readiness checks"></a></h3>By default Crossplane considers a Composite Resource or Claim as <code>READY</code> when the status of all created resource are <code>Type: Ready</code> and <code>Status: True</code>Some resources, for example, a ProviderConfig, don’t have a Kubernetes status and are never considered <code>Ready</code>.Custom readiness checks allow Compositions to define what custom conditions to meet for a resource to be <code>Ready</code>.<div class="admonition tip d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="tip:"><use xlink:href="#check"/></svg>Tip</div><div class=admonition-content>Use multiple readiness checks if a resource must meet multiple conditions for it to be <code>Ready</code>.</div></div>Define a custom readiness check with the <code><highlight-term id=1731573034389014742 data-label=check data-line=10>readinessChecks</highlight-term></code> field on a resource.Checks have a <code><highlight-term id=1731573034389037562 data-label=check data-line=11>type</highlight-term></code> defining how to match the resource and a <code><highlight-term id=1731573034389059595 data-label=check data-line=12>fieldPath</highlight-term></code> of which field in the resource to compare.<div class=highlight label=check copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-21-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-21-2> 2</a>kind: Composition <a class=lnlinks href=#hl-21-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-21-4> 4</a>spec: <a class=lnlinks href=#hl-21-5> 5</a> resources: <a class=lnlinks href=#hl-21-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-21-7> 7</a> - name: my-resource <a class=lnlinks href=#hl-21-8> 8</a> base: <a class=lnlinks href=#hl-21-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-21-10>10</a> readinessChecks: <a class=lnlinks href=#hl-21-11>11</a> - type: <match type> <a class=lnlinks href=#hl-21-12>12</a> fieldPath: <resource field> </code></pre></div>Compositions support matching resource fields by:<ul><li><a href=#match-a-string>string match</a></li><li><a href=#match-an-integer>integer match</a></li><li><a href=#match-that-a-field-exists>non-empty match</a></li><li><a href=#always-consider-a-resource-ready>always ready</a></li><li><a href=#match-a-condition>condition match</a></li><li><a href=#match-a-boolean>boolean match</a></li></ul><h4 id=match-a-string>Match a string <a class=anchor-link id=match-a-string href=#match-a-string aria-label="Link to this section: Match a string"></a></h4><code><highlight-term id=1731573034389081380 data-label=matchstring data-line=11>MatchString</highlight-term></code> considers the composed resource to be ready when the value of a field in that resource matches a specified string.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Crossplane only supports exact string matches. Substrings and regular expressions aren’t supported in a readiness check.</div></div>For example, matching the string <code><highlight-term id=1731573034389147055 data-label=matchstring data-line=13>Online</highlight-term></code> in the resource’s <code><highlight-term id=1731573034389169982 data-label=matchstring data-line=12>status.atProvider.state</highlight-term></code> field.<div class=highlight label=matchstring copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-22-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-22-2> 2</a>kind: Composition <a class=lnlinks href=#hl-22-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-22-4> 4</a>spec: <a class=lnlinks href=#hl-22-5> 5</a> resources: <a class=lnlinks href=#hl-22-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-22-7> 7</a> - name: my-resource <a class=lnlinks href=#hl-22-8> 8</a> base: <a class=lnlinks href=#hl-22-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-22-10>10</a> readinessChecks: <a class=lnlinks href=#hl-22-11>11</a> - type: MatchString <a class=lnlinks href=#hl-22-12>12</a> fieldPath: status.atProvider.state <a class=lnlinks href=#hl-22-13>13</a> matchString: "Online" </code></pre></div><h4 id=match-an-integer>Match an integer <a class=anchor-link id=match-an-integer href=#match-an-integer aria-label="Link to this section: Match an integer"></a></h4><code><highlight-term id=1731573034389192146 data-label=matchint data-line=11>MatchInteger</highlight-term></code> considers the composed resource to be ready when the value of a field in that resource matches a specified integer.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Crossplane doesn’t support matching <code>0</code>.</div></div>For example, matching the number <code><highlight-term id=1731573034389257993 data-label=matchint data-line=13>4</highlight-term></code> in the resource’s <code><highlight-term id=1731573034389279131 data-label=matchint data-line=12>status.atProvider.state</highlight-term></code> field.<div class=highlight label=matchint copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-23-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-23-2> 2</a>kind: Composition <a class=lnlinks href=#hl-23-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-23-4> 4</a>spec: <a class=lnlinks href=#hl-23-5> 5</a> resources: <a class=lnlinks href=#hl-23-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-23-7> 7</a> - name: my-resource <a class=lnlinks href=#hl-23-8> 8</a> base: <a class=lnlinks href=#hl-23-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-23-10>10</a> readinessChecks: <a class=lnlinks href=#hl-23-11>11</a> - type: MatchInteger <a class=lnlinks href=#hl-23-12>12</a> fieldPath: status.atProvider.state <a class=lnlinks href=#hl-23-13>13</a> matchInteger: 4 </code></pre></div><h4 id=match-that-a-field-exists>Match that a field exists <a class=anchor-link id=match-that-a-field-exists href=#match-that-a-field-exists aria-label="Link to this section: Match that a field exists"></a></h4><code><highlight-term id=1731573034389299044 data-label=NonEmpty data-line=11>NonEmpty</highlight-term></code> considers the composed resource to be ready when a field exists with a value.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Crossplane considers a value of <code>0</code> or an empty string as empty.</div></div>For example, to check that a resource’s <code><highlight-term id=1731573034389352709 data-label=NonEmpty data-line=12>status.atProvider.state</highlight-term></code> field isn’t empty.<div class=highlight label=NonEmpty copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-24-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-24-2> 2</a>kind: Composition <a class=lnlinks href=#hl-24-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-24-4> 4</a>spec: <a class=lnlinks href=#hl-24-5> 5</a> resources: <a class=lnlinks href=#hl-24-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-24-7> 7</a> - name: my-resource <a class=lnlinks href=#hl-24-8> 8</a> base: <a class=lnlinks href=#hl-24-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-24-10>10</a> readinessChecks: <a class=lnlinks href=#hl-24-11>11</a> - type: NonEmpty <a class=lnlinks href=#hl-24-12>12</a> fieldPath: status.atProvider.state </code></pre></div><div class="admonition tip d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="tip:"><use xlink:href="#check"/></svg>Tip</div><div class=admonition-content>Checking <code><highlight-term id=1731573034389373242 data-label=NonEmpty data-line=11>NonEmpty</highlight-term></code> doesn’t require setting any other fields.</div></div><h4 id=always-consider-a-resource-ready>Always consider a resource ready <a class=anchor-link id=always-consider-a-resource-ready href=#always-consider-a-resource-ready aria-label="Link to this section: Always consider a resource ready"></a></h4><code><highlight-term id=1731573034389441113 data-label=none data-line=11>None</highlight-term></code> considers the composed resource to be ready as soon as it’s created. Crossplane doesn’t wait for any other conditions before declaring the resource ready.For example, consider <code><highlight-term id=1731573034389460768 data-label=none data-line=7>my-resource</highlight-term></code> ready as soon as it’s created.<div class=highlight label=none copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-25-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-25-2> 2</a>kind: Composition <a class=lnlinks href=#hl-25-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-25-4> 4</a>spec: <a class=lnlinks href=#hl-25-5> 5</a> resources: <a class=lnlinks href=#hl-25-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-25-7> 7</a> - name: my-resource <a class=lnlinks href=#hl-25-8> 8</a> base: <a class=lnlinks href=#hl-25-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-25-10>10</a> readinessChecks: <a class=lnlinks href=#hl-25-11>11</a> - type: None </code></pre></div><h4 id=match-a-condition>Match a condition <a class=anchor-link id=match-a-condition href=#match-a-condition aria-label="Link to this section: Match a condition"></a></h4><code><highlight-term id=1731573034389479651 data-label=condition data-line=11>Condition</highlight-term></code> considers the composed resource to be ready when it finds the expected condition type, with the expected status for it in its <code>status.conditions</code>.For example, consider <code><highlight-term id=1731573034389500742 data-label=condition data-line=7>my-resource</highlight-term></code>, which is ready if there is a condition of type <code><highlight-term id=1731573034389518309 data-label=condition data-line=13>MyType</highlight-term></code> with a status of <code><highlight-term id=1731573034389535823 data-label=condition data-line=14>Success</highlight-term></code>.<div class=highlight label=condition copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-26-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-26-2> 2</a>kind: Composition <a class=lnlinks href=#hl-26-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-26-4> 4</a>spec: <a class=lnlinks href=#hl-26-5> 5</a> resources: <a class=lnlinks href=#hl-26-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-26-7> 7</a> - name: my-resource <a class=lnlinks href=#hl-26-8> 8</a> base: <a class=lnlinks href=#hl-26-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-26-10>10</a> readinessChecks: <a class=lnlinks href=#hl-26-11>11</a> - type: MatchCondition <a class=lnlinks href=#hl-26-12>12</a> matchCondition: <a class=lnlinks href=#hl-26-13>13</a> type: MyType <a class=lnlinks href=#hl-26-14>14</a> status: Success </code></pre></div><h4 id=match-a-boolean>Match a boolean <a class=anchor-link id=match-a-boolean href=#match-a-boolean aria-label="Link to this section: Match a boolean"></a></h4>Two types of checks exist for matching boolean fields:<ul><li><code>MatchTrue</code></li><li><code>MatchFalse</code></li></ul><code>MatchTrue</code> considers the composed resource to be ready when the value of a field inside that resource is <code>true</code>.<code>MatchFalse</code> considers the composed resource to be ready when the value of a field inside that resource is <code>false</code>.For example, consider <code><highlight-term id=1731573034389554755 data-label=matchTrue data-line=7>my-resource</highlight-term></code>, which is ready if <code><highlight-term id=1731573034389571804 data-label=matchTrue data-line=12>status.atProvider.manifest.status.ready</highlight-term></code> is <code><highlight-term id=1731573034389589532 data-label=matchTrue data-line=11>true</highlight-term></code>.<div class=highlight label=matchTrue copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-27-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-27-2> 2</a>kind: Composition <a class=lnlinks href=#hl-27-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-27-4> 4</a>spec: <a class=lnlinks href=#hl-27-5> 5</a> resources: <a class=lnlinks href=#hl-27-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-27-7> 7</a> - name: my-resource <a class=lnlinks href=#hl-27-8> 8</a> base: <a class=lnlinks href=#hl-27-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-27-10>10</a> readinessChecks: <a class=lnlinks href=#hl-27-11>11</a> - type: MatchTrue <a class=lnlinks href=#hl-27-12>12</a> fieldPath: status.atProvider.manifest.status.ready </code></pre></div><div class="admonition tip d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="tip:"><use xlink:href="#check"/></svg>Tip</div><div class=admonition-content>Checking <code><highlight-term id=1731573034389609322 data-label=matchTrue data-line=11>MatchTrue</highlight-term></code> doesn’t require setting any other fields.</div></div><code>MatchFalse</code> matches fields that express readiness with the value <code>false</code>.For example, consider <code><highlight-term id=1731573034389672382 data-label=matchFalse data-line=7>my-resource</highlight-term></code>, is ready if <code><highlight-term id=1731573034389688365 data-label=matchFalse data-line=12>status.atProvider.manifest.status.pending</highlight-term></code> is <code><highlight-term id=1731573034389705831 data-label=matchFalse data-line=11>false</highlight-term></code>.<div class=highlight label=matchFalse copy-lines=none><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-28-1> 1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-28-2> 2</a>kind: Composition <a class=lnlinks href=#hl-28-3> 3</a># Removed for Brevity <a class=lnlinks href=#hl-28-4> 4</a>spec: <a class=lnlinks href=#hl-28-5> 5</a> resources: <a class=lnlinks href=#hl-28-6> 6</a> # Removed for Brevity <a class=lnlinks href=#hl-28-7> 7</a> - name: my-resource <a class=lnlinks href=#hl-28-8> 8</a> base: <a class=lnlinks href=#hl-28-9> 9</a> # Removed for brevity <a class=lnlinks href=#hl-28-10>10</a> readinessChecks: <a class=lnlinks href=#hl-28-11>11</a> - type: MatchFalse <a class=lnlinks href=#hl-28-12>12</a> fieldPath: status.atProvider.manifest.status.pending </code></pre></div><div class="admonition tip d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="tip:"><use xlink:href="#check"/></svg>Tip</div><div class=admonition-content>Checking <code><highlight-term id=1731573034389723776 data-label=matchFalse data-line=11>MatchFalse</highlight-term></code> doesn’t require setting any other fields.</div></div><h2 id=verify-a-composition>Verify a Composition <a class=anchor-link id=verify-a-composition href=#verify-a-composition aria-label="Link to this section: Verify a Composition"></a></h2>View all available Compositions with <code>kubectl get composition</code>.<div class=highlight copy-lines=1><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><a class=lnlinks href=#hl-29-1>1</a>kubectl get composition <a class=lnlinks href=#hl-29-2>2</a>NAME XR-KIND XR-APIVERSION AGE <a class=lnlinks href=#hl-29-3>3</a>xapps.aws.platformref.upbound.io XApp aws.platformref.upbound.io/v1alpha1 123m <a class=lnlinks href=#hl-29-4>4</a>xclusters.aws.platformref.upbound.io XCluster aws.platformref.upbound.io/v1alpha1 123m <a class=lnlinks href=#hl-29-5>5</a>xeks.aws.platformref.upbound.io XEKS aws.platformref.upbound.io/v1alpha1 123m <a class=lnlinks href=#hl-29-6>6</a>xnetworks.aws.platformref.upbound.io XNetwork aws.platformref.upbound.io/v1alpha1 123m <a class=lnlinks href=#hl-29-7>7</a>xservices.aws.platformref.upbound.io XServices aws.platformref.upbound.io/v1alpha1 123m <a class=lnlinks href=#hl-29-8>8</a>xsqlinstances.aws.platformref.upbound.io XSQLInstance aws.platformref.upbound.io/v1alpha1 123m </code></pre></div>The <code>XR-KIND</code> lists the Composite Resource <code>kind</code> that’s allowed to use the Composition template. The <code>XR-APIVERSION</code> lists the Composite Resource API versions allowed to use the Composition template.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>The output of <code>kubectl get composition</code> is different than <code>kubectl get composite</code>.<code>kubectl get composition</code> lists all available Compositions.<code>kubectl get composite</code> lists all created Composite Resources and their related Composition.</div></div><h2 id=composition-validation>Composition validation <a class=anchor-link id=composition-validation href=#composition-validation aria-label="Link to this section: Composition validation"></a></h2>When creating a Composition, Crossplane automatically validates its integrity, checking that the Composition is well formed, for example:If using <code>mode: Resources</code>:<ul><li>The <code>resources</code> field isn’t empty.</li><li>All resources either use a <code>name</code> or don’t. Compositions can’t use both named and unnamed resources.</li><li>No duplicate resource names.</li><li>Patch sets must have names.</li><li>Patches that require a <code>fromFieldPath</code> value provide it.</li><li>Patches that require a <code>toFieldPath</code> value provide it.</li><li>Patches that require a <code>combine</code> field provide it.</li><li>Readiness checks using <code>matchString</code> aren’t empty.</li><li>Readiness checks using <code>matchInteger</code> isn’t <code>0</code>.</li><li>Readiness checks requiring a <code>fieldPath</code> value provide it.</li></ul>If using <code>mode: Pipeline</code> (Composition Functions):<ul><li>The <code>pipeline</code> field isn’t empty.</li><li>No duplicate step names.</li></ul><h3 id=composition-schema-aware-validation>Composition schema aware validation <a class=anchor-link id=composition-schema-aware-validation href=#composition-schema-aware-validation aria-label="Link to this section: Composition schema aware validation"></a></h3>Crossplane also performs schema aware validation of Compositions. Schema validation checks that <code>patches</code>, <code>readinessChecks</code> and <code>connectionDetails</code> are valid according to the resource schemas. For example, checking that the source and destination fields of a patch are valid according to the source and destination resource schema.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>Composition schema aware validation is a beta feature. Crossplane enables beta features by default.Disable schema aware validation by setting the <code>--enable-composition-webhook-schema-validation=false</code> flag on the Crossplane pod.The <a href=https://docs.crossplane.io/v1.16/concepts/pods/#edit-the-deployment>Crossplane Pods</a> page has more information on enabling Crossplane flags.</div></div><h4 id=schema-aware-validation-modes>Schema aware validation modes <a class=anchor-link id=schema-aware-validation-modes href=#schema-aware-validation-modes aria-label="Link to this section: Schema aware validation modes"></a></h4>Crossplane always rejects Compositions in case of integrity errors.Set the schema aware validation mode to configure how Crossplane handles both missing resource schemas and schema aware validation errors.<div class="admonition note d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="note:"><use xlink:href="#info"/></svg>Note</div><div class=admonition-content>If a resource schema is missing, Crossplane skips schema aware validation but still returns an error for integrity errors and a warning or an error for the missing schemas.</div></div>The following modes are available:<div class="table-responsive border rounded"><table class="table table-sm table-striped"><thead><tr><th>Mode</th><th>Missing Schema</th><th>Schema Aware Error</th><th>Integrity Error</th></tr></thead><tbody><tr><td><code>warn</code></td><td>Warning</td><td>Warning</td><td>Error</td></tr><tr><td><code>loose</code></td><td>Warning</td><td>Error</td><td>Error</td></tr><tr><td><code>strict</code></td><td>Error</td><td>Error</td><td>Error</td></tr></tbody></table></div>Change the validation mode for a Composition with the <code><highlight-term id=1731573034390003574 data-label=mode data-line=5>crossplane.io/composition-schema-aware-validation-mode</highlight-term></code> annotation.If not specified, the default mode is <code>warn</code>.For example, to enable <code>loose</code> mode checking set the annotation value to <code><highlight-term id=1731573034390020970 data-label=mode data-line=5>loose</highlight-term></code>.<div class=highlight copy-lines=none label=mode><pre tabindex=0 class=chroma><code class=language-yaml data-lang=yaml><a class=lnlinks href=#hl-30-1>1</a>apiVersion: apiextensions.crossplane.io/v1 <a class=lnlinks href=#hl-30-2>2</a>kind: Composition <a class=lnlinks href=#hl-30-3>3</a>metadata: <a class=lnlinks href=#hl-30-4>4</a> annotations: <a class=lnlinks href=#hl-30-5>5</a> crossplane.io/composition-schema-aware-validation-mode: loose <a class=lnlinks href=#hl-30-6>6</a> # Removed for brevity <a class=lnlinks href=#hl-30-7>7</a>spec: <a class=lnlinks href=#hl-30-8>8</a> # Removed for brevity </code></pre></div><div class="admonition important d-flex flex-column mx-4 p-0"><div class=admonition-title><svg class="bi flex-shrink-0" role="img" aria-label="important:"><use xlink:href="#exclamation"/></svg>Important</div><div class=admonition-content>Validation modes also apply to Compositions defined by Configuration packages.Depending on the mode configured in the Composition, schema aware validation issues may result in warnings or the rejection of the Composition.View the Crossplane logs for validation warnings.Crossplane sets a Configuration as unhealthy if there are validation errors. View the Configuration details with <code>kubectl describe configuration</code> to see the specific errors.</div></div></div></main></div><footer class="bd-footer p-5"><div class="container text-center"><div class="row pb-5 top-row"><div class="col-lg img-col"><img src=/img/crossplane-logo.svg alt="Crossplane logo" srcset="/img/crossplane-logo.svg 1x, /img/crossplane-logo.svg 2x" width=185 height=40 decoding=async data-nimg=future loading=lazy class="d-flex crossplane-footer"></div><div class="col-lg links-col d-fill justify-content-evenly ms-5"><div class=row><div class=col-lg><a class=footer-link target=_blank href=https://twitter.com/crossplane_io>Twitter</a></div><div class=col-lg><a class=footer-link target=_blank href=https://www.youtube.com/channel/UC19FgzMBMqBro361HbE46Fw>Youtube</a></div><div class=col-lg><a class=footer-link target=_blank href="https://www.youtube.com/playlist?list=PL510POnNVaaYFuK-B_SIUrpIonCtLVOzT">Podcast</a></div><div class=col-lg><a class=footer-link target=_blank href=https://groups.google.com/g/crossplane-dev>Forum</a></div></div></div></div><div class="row pb-5"><div class="col-lg copyright-col pe-4 border-end">© Crossplane Authors 2024. Documentation distributed under <a target=_blank href=https://creativecommons.org/licenses/by/4.0/>CC-BY-4.0</a>.© 2024 The Linux Foundation. All rights reserved. The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our <a target=_blank href=https://www.linuxfoundation.org/legal/trademark-usage>Trademark Usage</a> page.</div><div class="col-lg cncf-col ms-5"><a class=d-flex target=_blank href=https://www.cncf.io/><img alt=cncfLogo src=/img/cncf-white.webp width=702 height=114 decoding=async data-nimg=future loading=lazy class="cncf-footer py-3"></a>We are a Cloud Native Computing Foundation incubating project.</div></div></div></footer><script src=https://docs.crossplane.io/js/main-727bf178.bundle.min.js data-no-instant></script><script type=text/javascript>(function(e,t,n,s,o,i,a){e[n]=e[n]||function(){(e[n].q=e[n].q||[]).push(arguments)},i=t.createElement(s),i.async=1,i.src="https://www.clarity.ms/tag/"+o,a=t.getElementsByTagName(s)[0],a.parentNode.insertBefore(i,a)})(window,document,"clarity","script","el5517lxor")</script> <script>(function(e,t,n,s,o){e[s]=e[s]||[],e[s].push({"gtm.start":(new Date).getTime(),event:"gtm.js"});var a=t.getElementsByTagName(n)[0],i=t.createElement(n),r=s!="dataLayer"?"&l="+s:"";i.async=!0,i.src="https://www.googletagmanager.com/gtm.js?id="+o+r,a.parentNode.insertBefore(i,a)})(window,document,"script","dataLayer","GTM-WFF2NQHG")</script><noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-WFF2NQHG" height=0 width=0 style=display:none;visibility:hidden></iframe></noscript><script type=text/javascript>adroll_adv_id="B4XQTO44VJFVDGCGM332GU",adroll_pix_id="6ROIBHUPMVCSXN7HHIKJTK",adroll_version="2.0",function(e,t,n,s,o){e.__adroll_loaded=!0,e.adroll=e.adroll||[],e.adroll.f=["setProperties","identify","track"];var i="https://s.adroll.com/j/"+adroll_adv_id+"/roundtrip.js";for(o=0;o<e.adroll.f.length;o++)e.adroll[e.adroll.f[o]]=e.adroll[e.adroll.f[o]]||function(t){return function(){e.adroll.push([t,arguments])}}(e.adroll.f[o]);n=t.createElement("script"),s=t.getElementsByTagName("script")[0],n.async=1,n.src=i,s.parentNode.insertBefore(n,s)}(window,document),adroll.track("pageView")</script><script src=https://cdn.jsdelivr.net/npm/@docsearch/js@3></script> <script>docsearch({container:"#docSearch",appId:"9UXKYX61NK",indexName:"crossplane",apiKey:"e07e181044d561f6a4cb7261931d980a",placeholder:"Search the docs"})</script></body></html>