support timezone in manifest and use when validating app-version

Author: stevethomas

README.md

@@ -208,10 +208,11 @@ Builds can be deployed with `yolo deploy <environment>`.
 
 This is a complete yolo.yml manifest file, showing default values where applicable.
 
-Note that some keys are intentionally omitted from the stub generated by `yolo init`.
+Note that some keys below are intentionally omitted from the stub generated by `yolo init`.
 
 ```yaml
 name: codinglabs
+timezone: UTC
 
 environments:
   production:
@@ -277,6 +278,31 @@ environments:
       - php artisan optimize
 ```
 
+### Continuous Integration
+
+The app version can be specified as an option with `--app-version` to the `build` and `deploy` commands.
+
+The recommended approach is to tag your GitHub releases with a date-based naming convention, and then forward the tag to
+your deploy action, similar to the following:
+
+```yaml
+- name: Deploy
+    run: php vendor/bin/yolo deploy production --app-version=${{ github.event.release.tag_name }}
+    env:
+      AWS_ACCESS_KEY_ID: ${{ secrets.PRODUCTION_AWS_ACCESS_KEY_ID }}
+      AWS_SECRET_ACCESS_KEY: ${{ secrets.PRODUCTION_AWS_SECRET_ACCESS_KEY }}
+```
+
+The current app version must start with `year.week`, for example `25.3` to represent the third week of 2025. After the
+year and week,
+use whatever convention you like; a common approach is to increment the third digit for each release, for example
+`25.3.1`,
+`25.3.2`, etc.
+
+Because the app version is validated during the build and utilises the UTC timezone by default, you may wish to set the
+manifest `timezone` option to the timezone of your team to prevent validation errors at the start of the week if your
+timezone is ahead of UTC.
+
 ### Domains
 
 Applications hosted with yolo can be served on any domain or subdomain that you own.

composer.json

@@ -18,6 +18,7 @@
     "illuminate/filesystem": "^10|^11|^12",
     "illuminate/support": "^10|^11|^12",
     "joetannenbaum/chewie": "^0.1.8",
+    "nesbot/carbon": "^3.10",
     "symfony/console": "^7.1",
     "symfony/yaml": "^7.1",
     "vlucas/phpdotenv": "^5.6"

src/Commands/BuildCommand.php

@@ -2,7 +2,9 @@
 
 namespace Codinglabs\Yolo\Commands;
 
+use Carbon\Carbon;
 use Codinglabs\Yolo\Steps;
+use Codinglabs\Yolo\Manifest;
 use Symfony\Component\Console\Input\InputArgument;
 
 use function Laravel\Prompts\error;
@@ -32,10 +34,11 @@ protected function configure(): void
 
     public function handle(): void
     {
-        $appVersion = $this->option('app-version') ?? date('y.W.N.Hi');
+        $appVersion = $this->option('app-version') ?? Carbon::now(Manifest::timezone())->format('y.W.N.Hi');
+        $expectedAppVersionPrefix = Carbon::now(Manifest::timezone())->format('y.W');
 
-        if (! str_starts_with($appVersion, date('y.W'))) {
-            error(sprintf('App version must start with %s', date('y.W')));
+        if (! str_starts_with($appVersion, $expectedAppVersionPrefix)) {
+            error(sprintf('App version must start with %s', $expectedAppVersionPrefix));
 
             return;
         }

src/Manifest.php

@@ -68,6 +68,11 @@ public static function put(string $key, mixed $value): false|int
         );
     }
 
+    public static function timezone(): string
+    {
+        return Arr::get(static::current(), 'timezone', 'UTC');
+    }
+
     public static function apex(): string
     {
         if (static::isMultitenanted()) {

src/Steps/Image/CreateAmiStep.php

@@ -2,8 +2,10 @@
 
 namespace Codinglabs\Yolo\Steps\Image;
 
+use Carbon\Carbon;
 use Codinglabs\Yolo\Aws;
 use Codinglabs\Yolo\Helpers;
+use Codinglabs\Yolo\Manifest;
 use Codinglabs\Yolo\Contracts\Step;
 use Codinglabs\Yolo\Concerns\UsesEc2;
 
@@ -15,7 +17,7 @@ public function __invoke(): string
     {
         $ami = Aws::ec2()->createImage([
             'InstanceId' => Helpers::app('amiInstanceId'),
-            'Name' => Helpers::keyedResourceName(date('y.W.N.Hi'), exclusive: false),
+            'Name' => Helpers::keyedResourceName(Carbon::now(Manifest::timezone())->format('y.W.N.Hi'), exclusive: false),
             'TagSpecifications' => [
                 [
                     'ResourceType' => 'image',