Skip to content

Commit

Permalink
deploy: b9c6478
Browse files Browse the repository at this point in the history
  • Loading branch information
@akclace
akclace committed Oct 30, 2024
1 parent 0026829 commit 1d50324
Show file tree
Hide file tree
Showing 3 changed files with 5 additions and 5 deletions.
4 changes: 2 additions & 2 deletions docs/applications/overview/index.html
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<!doctype html><html lang=en><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=robots content="index, follow"><link rel="icon shortcut" href=/favicon.ico sizes=32x32><link rel=icon href=/favicon.svg type=image/svg+xml><link rel=icon href=/favicon-dark.svg type=image/svg+xml media="(prefers-color-scheme: dark)"><link rel=icon href=/favicon-16x16.png type=image/png sizes=16x16><link rel=icon href=/favicon-32x32.png type=image/png sizes=32x32><link rel=apple-touch-icon href=/apple-touch-icon.png sizes=180x180><link fetchpriority=low href=/site.webmanifest rel=manifest><title>App Management Overview – Internal Tools Deployment Platform | Clace</title>
<meta name=description content="Overview of managing Clace applications"><link rel=canonical href=https://clace.io/docs/applications/overview/ itemprop=url><meta property="og:title" content="App Management Overview"><meta property="og:description" content="Overview of managing Clace applications"><meta property="og:type" content="article"><meta property="og:url" content="https://clace.io/docs/applications/overview/"><meta property="article:section" content="docs"><meta property="article:published_time" content="2024-03-03T00:00:00+00:00"><meta property="article:modified_time" content="2024-03-03T00:00:00+00:00"><meta property="og:site_name" content="Internal Tools Deployment Platform | Clace"><meta itemprop=name content="App Management Overview"><meta itemprop=description content="Overview of managing Clace applications"><meta itemprop=datePublished content="2024-03-03T00:00:00+00:00"><meta itemprop=dateModified content="2024-03-03T00:00:00+00:00"><meta itemprop=wordCount content="946"><meta name=twitter:card content="summary"><meta name=twitter:title content="App Management Overview"><meta name=twitter:description content="Overview of managing Clace applications"><link rel=preload href=/css/compiled/main.min.c1fe2c80102c9dc9ddc66184191e646769052d36a21b38ac5ab5077713cf7a81.css as=style integrity="sha256-wf4sgBAsncndxmGEGR5kZ2kFLTaiGzisWrUHdxPPeoE="><link href=/css/compiled/main.min.c1fe2c80102c9dc9ddc66184191e646769052d36a21b38ac5ab5077713cf7a81.css rel=stylesheet integrity="sha256-wf4sgBAsncndxmGEGR5kZ2kFLTaiGzisWrUHdxPPeoE="><link href=/css/custom.min.17ac2fefdb90012075f015cb94f8f56d236e25870b253764ac3a7cd848a08f2f.css rel=stylesheet integrity="sha256-F6wv79uQASB18BXLlPj1bSNuJYcLJTdkrDp82Eigjy8="><script>const defaultTheme="system",setDarkTheme=()=>{document.documentElement.classList.add("dark"),document.documentElement.style.colorScheme="dark"},setLightTheme=()=>{document.documentElement.classList.remove("dark"),document.documentElement.style.colorScheme="light"};"color-theme"in localStorage?localStorage.getItem("color-theme")==="dark"?setDarkTheme():setLightTheme():(defaultTheme==="dark"?setDarkTheme():setLightTheme(),defaultTheme==="system"&&(window.matchMedia("(prefers-color-scheme: dark)").matches?setDarkTheme():setLightTheme()))</script><script defer data-domain=clace.io data-api=https://pl.demo.clace.io/api/event src=https://clace.io/plscript.js></script></head><body dir=ltr><div class="nav-container hx-sticky hx-top-0 hx-z-20 hx-w-full hx-bg-transparent print:hx-hidden"><div class="nav-container-blur hx-pointer-events-none hx-absolute hx-z-[-1] hx-h-full hx-w-full hx-bg-white dark:hx-bg-dark hx-shadow-[0_2px_4px_rgba(0,0,0,.02),0_1px_0_rgba(0,0,0,.06)] contrast-more:hx-shadow-[0_0_0_1px_#000] dark:hx-shadow-[0_-1px_0_rgba(255,255,255,.1)_inset] contrast-more:dark:hx-shadow-[0_0_0_1px_#fff]"></div><nav class="hx-mx-auto hx-flex hx-items-center hx-justify-end hx-gap-2 hx-h-16 hx-px-6 hx-max-w-[90rem]"><a class="hx-flex hx-items-center hover:hx-opacity-75 ltr:hx-mr-auto rtl:hx-ml-auto" href=/><img class="hx-block dark:hx-hidden" src=/clace.png alt="Internal Tools Deployment Platform | Clace" height=100 width=100>
<meta name=description content="Overview of managing Clace applications"><link rel=canonical href=https://clace.io/docs/applications/overview/ itemprop=url><meta property="og:title" content="App Management Overview"><meta property="og:description" content="Overview of managing Clace applications"><meta property="og:type" content="article"><meta property="og:url" content="https://clace.io/docs/applications/overview/"><meta property="article:section" content="docs"><meta property="article:published_time" content="2024-03-03T00:00:00+00:00"><meta property="article:modified_time" content="2024-03-03T00:00:00+00:00"><meta property="og:site_name" content="Internal Tools Deployment Platform | Clace"><meta itemprop=name content="App Management Overview"><meta itemprop=description content="Overview of managing Clace applications"><meta itemprop=datePublished content="2024-03-03T00:00:00+00:00"><meta itemprop=dateModified content="2024-03-03T00:00:00+00:00"><meta itemprop=wordCount content="954"><meta name=twitter:card content="summary"><meta name=twitter:title content="App Management Overview"><meta name=twitter:description content="Overview of managing Clace applications"><link rel=preload href=/css/compiled/main.min.c1fe2c80102c9dc9ddc66184191e646769052d36a21b38ac5ab5077713cf7a81.css as=style integrity="sha256-wf4sgBAsncndxmGEGR5kZ2kFLTaiGzisWrUHdxPPeoE="><link href=/css/compiled/main.min.c1fe2c80102c9dc9ddc66184191e646769052d36a21b38ac5ab5077713cf7a81.css rel=stylesheet integrity="sha256-wf4sgBAsncndxmGEGR5kZ2kFLTaiGzisWrUHdxPPeoE="><link href=/css/custom.min.17ac2fefdb90012075f015cb94f8f56d236e25870b253764ac3a7cd848a08f2f.css rel=stylesheet integrity="sha256-F6wv79uQASB18BXLlPj1bSNuJYcLJTdkrDp82Eigjy8="><script>const defaultTheme="system",setDarkTheme=()=>{document.documentElement.classList.add("dark"),document.documentElement.style.colorScheme="dark"},setLightTheme=()=>{document.documentElement.classList.remove("dark"),document.documentElement.style.colorScheme="light"};"color-theme"in localStorage?localStorage.getItem("color-theme")==="dark"?setDarkTheme():setLightTheme():(defaultTheme==="dark"?setDarkTheme():setLightTheme(),defaultTheme==="system"&&(window.matchMedia("(prefers-color-scheme: dark)").matches?setDarkTheme():setLightTheme()))</script><script defer data-domain=clace.io data-api=https://pl.demo.clace.io/api/event src=https://clace.io/plscript.js></script></head><body dir=ltr><div class="nav-container hx-sticky hx-top-0 hx-z-20 hx-w-full hx-bg-transparent print:hx-hidden"><div class="nav-container-blur hx-pointer-events-none hx-absolute hx-z-[-1] hx-h-full hx-w-full hx-bg-white dark:hx-bg-dark hx-shadow-[0_2px_4px_rgba(0,0,0,.02),0_1px_0_rgba(0,0,0,.06)] contrast-more:hx-shadow-[0_0_0_1px_#000] dark:hx-shadow-[0_-1px_0_rgba(255,255,255,.1)_inset] contrast-more:dark:hx-shadow-[0_0_0_1px_#fff]"></div><nav class="hx-mx-auto hx-flex hx-items-center hx-justify-end hx-gap-2 hx-h-16 hx-px-6 hx-max-w-[90rem]"><a class="hx-flex hx-items-center hover:hx-opacity-75 ltr:hx-mr-auto rtl:hx-ml-auto" href=/><img class="hx-block dark:hx-hidden" src=/clace.png alt="Internal Tools Deployment Platform | Clace" height=100 width=100>
<img class="hx-hidden dark:hx-block" src=/clace.png alt="Internal Tools Deployment Platform | Clace" height=100 width=100>
</a><a title=QuickStart href=/docs/quickstart class="hx-text-sm contrast-more:hx-text-gray-700 contrast-more:dark:hx-text-gray-100 hx-relative -hx-ml-2 hx-hidden hx-whitespace-nowrap hx-p-2 md:hx-inline-block hx-text-gray-600 hover:hx-text-gray-800 dark:hx-text-gray-400 dark:hover:hx-text-gray-200"><span class=hx-text-center>QuickStart</span>
</a><a title=Docs href=/docs class="hx-text-sm contrast-more:hx-text-gray-700 contrast-more:dark:hx-text-gray-100 hx-relative -hx-ml-2 hx-hidden hx-whitespace-nowrap hx-p-2 md:hx-inline-block hx-text-gray-600 hover:hx-text-gray-800 dark:hx-text-gray-400 dark:hover:hx-text-gray-200"><span class=hx-text-center>Docs</span>
Expand Down Expand Up @@ -176,5 +176,5 @@
</span></span><span class=line><span class=cl>
</span></span><span class=line><span class=cl> <span class=m>2</span> <span class=m>1</span> 2024-03-01 20:00:20 +0000 UTC 86385ff67deab288c362 Updated bookmarks <span class=nv>app</span>
</span></span><span class=line><span class=cl>
</span></span><span class=line><span class=cl><span class=o>=====</span>&gt; <span class=m>5</span> <span class=m>2</span> 2024-03-02 00:23:35 +0000 UTC ed7545ae739dfe85140a Update styling <span class=k>for</span> bookmarks app</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx-opacity-0 hx-transition group-hover/code:hx-opacity-100 hx-flex hx-gap-1 hx-absolute hx-m-[11px] hx-right-0 hx-top-0"><button class="hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50" title="Copy code"><div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div><div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div></button></div></div><p>The <code>app version switch</code> command can be used to switch versions, up or down or to particular version. The <code>app version revert</code> command can be used to revert the last change. <code>app promote</code> makes the prod app run the same version as the current staging app.</p><p>In the above listing, the staging app has five versions. Three of those (1,2 and 5) were promoted to prod. <code>app version switch previous utils.demo.clace.io:/bookmarks_cl_stage</code> will change the stage app to version 4. <code>app version switch previous utils.demo.clace.io:/bookmarks</code> will change the prod app to version 2. After that, <code>app promote utils.demo.clace.io:/bookmarks</code> will change prod to also be at version 4, same as stage.</p><p>A star, like <code>PROD*</code> in the <code>app list</code> output indicates that there are staged changes waiting to be promoted. That will show up any time the prod app is at a different version than the stage app.</p><h2>App Authentication<span class="hx-absolute -hx-mt-20" id=app-authentication></span>
</span></span><span class=line><span class=cl><span class=o>=====</span>&gt; <span class=m>5</span> <span class=m>2</span> 2024-03-02 00:23:35 +0000 UTC ed7545ae739dfe85140a Update styling <span class=k>for</span> bookmarks app</span></span></code></pre></div></div><div class="hextra-code-copy-btn-container hx-opacity-0 hx-transition group-hover/code:hx-opacity-100 hx-flex hx-gap-1 hx-absolute hx-m-[11px] hx-right-0 hx-top-0"><button class="hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50" title="Copy code"><div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div><div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div></button></div></div><p>The <code>version switch</code> command can be used to switch versions, up or down or to particular version. The <code>version revert</code> command can be used to revert the last change. <code>app promote</code> makes the prod app run the same version as the current staging app.</p><p>In the above listing, the staging app has five versions. Three of those (1,2 and 5) were promoted to prod. <code>version switch previous utils.demo.clace.io:/bookmarks_cl_stage</code> will change the stage app to version 4. <code>version switch previous utils.demo.clace.io:/bookmarks</code> will change the prod app to version 2. After that, <code>app promote utils.demo.clace.io:/bookmarks</code> will change prod to also be at version 4, same as stage. The <code>switch</code> command takes <code>previous</code>, <code>next</code> and actual version number as arguments.</p><p>A star, like <code>PROD*</code> in the <code>app list</code> output indicates that there are staged changes waiting to be promoted. That will show up any time the prod app is at a different version than the stage app.</p><h2>App Authentication<span class="hx-absolute -hx-mt-20" id=app-authentication></span>
<a href=#app-authentication class=subheading-anchor aria-label="Permalink for this section"></a></h2><p>By default, apps are created with the system authentication type. System auth uses <code>admin</code> as the username. The password is displayed on the screen during the initial setup of the Clace server config.</p><p>To change app to be un-authenticated, add <code>--auth none</code> to the <code>app create</code> command. After an app is created, the auth type can be changed by running <code>app update-settings auth none /myapp</code>. OAuth based authentication is also supported, see <a href=https://clace.io/docs/configuration/authentication/>authentication</a> for details.</p><div class="hx-overflow-x-auto hx-mt-6 hx-flex hx-rounded-lg hx-border hx-py-2 ltr:hx-pr-4 rtl:hx-pl-4 contrast-more:hx-border-current contrast-more:dark:hx-border-current hx-border-yellow-100 hx-bg-yellow-50 hx-text-yellow-900 dark:hx-border-yellow-200/30 dark:hx-bg-yellow-700/30 dark:hx-text-yellow-200"><div class="ltr:hx-pl-3 ltr:hx-pr-2 rtl:hx-pr-3 rtl:hx-pl-2"><div class="hx-select-none hx-text-xl" style="font-family:apple color emoji,segoe ui emoji,segoe ui symbol">⚠️</div></div><div class="hx-w-full hx-min-w-0 hx-leading-7"><div class="hx-mt-6 hx-leading-7 first:hx-mt-0"><p>Changes done to the app settings using the <code>app update-settings</code> command are not staged or versioned, they apply immediately to the stage/prod/preview apps. App settings are fundamental properties of the app, like what authentication type to use, what git auth key to use etc.</p><p>All other changes done to app metadata (like account linking, permission approval and code reload) are staged before deployment. Use the <code>--promote</code> option on the change to promote the change immediately after applying it on the staging app. Use <code>app promote</code> command to promote later. When a promotion is done, <strong>all</strong> previously staged changes for that app are promoted, not just the most recent change.</p></div></div></div></div><div class=hx-mt-16></div><div class="hx-mb-8 hx-flex hx-items-center hx-border-t hx-pt-8 dark:hx-border-neutral-800 contrast-more:hx-border-neutral-400 dark:contrast-more:hx-border-neutral-400 print:hx-hidden"><a href=/docs/applications/routing/ title="Application Routing" class="hx-flex hx-max-w-[50%] hx-items-center hx-gap-1 hx-py-4 hx-text-base hx-font-medium hx-text-gray-600 hx-transition-colors [word-break:break-word] hover:hx-text-primary-600 dark:hx-text-gray-300 md:hx-text-lg ltr:hx-ml-auto ltr:hx-pl-4 ltr:hx-text-right rtl:hx-mr-auto rtl:hx-pr-4 rtl:hx-text-left">Application Routing<svg class="hx-inline hx-h-5 hx-shrink-0 rtl:-hx-rotate-180" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" aria-hidden="true"><path stroke-linecap="round" stroke-linejoin="round" d="M9 5l7 7-7 7"/></svg></a></div></main></article></div><footer class="hextra-footer hx-bg-gray-100 hx-pb-[env(safe-area-inset-bottom)] dark:hx-bg-neutral-900 print:hx-bg-transparent"><div class="hx-max-w-screen-xl hx-mx-auto hx-flex hx-justify-center hx-py-12 hx-pl-[max(env(safe-area-inset-left),1.5rem)] hx-pr-[max(env(safe-area-inset-right),1.5rem)] hx-text-gray-600 dark:hx-text-gray-400 md:hx-justify-start"><div class="hx-flex hx-w-full hx-flex-col hx-items-center sm:hx-items-start"><div class="hx-mt-6 hx-text-xs">© 2024 ClaceIO LLC</div></div></div></footer><script defer src=/js/main.min.998f7d6b2520d6d9875145cbe14b35964b365b44b3b1bfa6b797a74a9c173b07.js integrity="sha256-mY99ayUg1tmHUUXL4Us1lks2W0Szsb+mt5enSpwXOwc="></script><script defer src=/lib/flexsearch/flexsearch.bundle.min.0425860527cc9968f9f049421c7a56b39327d475e2e3a8f550416be3a9134327.js integrity="sha256-BCWGBSfMmWj58ElCHHpWs5Mn1HXi46j1UEFr46kTQyc="></script><script defer src=/en.search.min.3db95834d7cbb513c5e7bd8ff469faec73b56798f9d73f74f2e09a725dbbeac2.js integrity="sha256-PblYNNfLtRPF572P9Gn67HO1Z5j51z908uCacl276sI="></script></body></html>
Loading

0 comments on commit 1d50324

Please sign in to comment.