-
Notifications
You must be signed in to change notification settings - Fork 347
feat: added app lifecycle page #5186
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
added app life cycle page
Automatically optimized images using optipng and jpegoptim via GitHub Actions
|
Your Upsun Fixed environment has successfully deployed. 🚀 See the changed pages: Upsun Fixed docs |
| description: "Understand the {{% vendor/name %}} application lifecycle and learn how to use build, deploy, and runtime hooks to control app behavior" | ||
| --- | ||
|
|
||
| Hooks let you run custom commands at specific points in your application’s lifecycle during [`build`, `deploy`](/learn/overview/build-deploy.html), or `runtime`. They’re essential for setting up your app, managing graceful shutdowns, or preparing instances to handle traffic in autoscaling environments. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This reads weird to me. it's like it's missing some word after runtime :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi @ricardokirkner i've adjusted this sentence so it reads a bit better.
| |------|------|-----------|--------------| | ||
| | **pre_start** | string | No | Runs just before `start`. Useful for short setup actions that must run per instance, such as moving cache files or setting permissions. | | ||
| | **start** | string | Yes | The main command that launches your app. If it terminates, {{% vendor/name %}} restarts it immediately. | | ||
| | **post_start** | string | No | Runs after the `start` command but before the container is added to the router. This lets you complete warm-up tasks before the app starts handling traffic. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We should mention here that if post_start is defined, instances won't start getting traffic routes to them until that script finishes successfully.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is important to the customer experience—is this a blocking hook or not?
Could this be addressed by a Boolean column such as "Freezes/Holds Requests"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi @ricardokirkner @tylers-username i've added a boolean column to address whether its a blocking or non blocking hook
tylers-username
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@Kemi-Elizabeth - proposed a change
adjusted table and added note
…b.com/platformsh/platformsh-docs into 5185-new-page-to-be-added-about-hooks
turned vale off
Addressed changes and adjusted content accordingly
Added app life cycle page (about hooks)
Why
Closes #5185
What's changed
New page has been added to Learn section about hooks and application lifecycle.
Where are changes
/learn/overview/app-life-cycle.html
Updates are for:
sites/platformtemplates)sites/upsuntemplates)