captive-cli 1.10.0 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fbb9f68824463afe138a9f65081be8fe6b582b6ac25c6ec8235e7b64c45832cc
4
- data.tar.gz: 0f112e5a5350bb911c77eed140d6162c5c99a78be0c065f4ac326a3c6a80ecf7
3
+ metadata.gz: 3b199e8b6db6cba9030774543de150f46d4954acac5030f83624ac5c458fff8a
4
+ data.tar.gz: b3e10499cd8575b232953818cd33255cb690ee86b7a3d01d74b7410a0ba2e595
5
5
  SHA512:
6
- metadata.gz: 5f9ea0724abef388ba43af81aa988820cd51e047b55bfa1b81919f7b6c0e1bc06fd98af49be1c29596d917715f0a8b5943bb277f91bbe0ce0d00c7125fc0b92d
7
- data.tar.gz: f4f7c16ef49fe3bb08bcef569da7cd5e5197eb50d68ac59b5012a3d33e84a79657aafb8de19ceea682ec06f4ea5bf35599df87ae44dfae889d901b14daa0d75e
6
+ metadata.gz: bacf56a333aa58ecf7c5437d74dbe0505da9fa5dd6001e6310867a9687d2066561455fd434721f39697eb3e0bc34856c82c0f1a1c5c361118f1cb684c2a2ee8c
7
+ data.tar.gz: 4157193a980ffa0a3a0dd40228d19e41daf1ffb24126ef18282a2362d68390823404d9d185d6db0abc4328f56fa7278fe933bca652d3193b765800422cbdda31
data/lib/captive/cli.rb CHANGED
@@ -5,6 +5,7 @@ require_relative "loader"
5
5
  require_relative "cli/dependencies"
6
6
  require_relative "commands/apps_commands"
7
7
  require_relative "commands/env_commands"
8
+ require_relative "commands/vault_commands"
8
9
  require_relative "commands/crons_commands"
9
10
  require_relative "commands/domains_commands"
10
11
  require_relative "commands/addons_commands"
@@ -74,6 +75,9 @@ module Captive
74
75
  desc "supabase SUBCOMMAND", "Extension Supabase d'une app : Edge Functions"
75
76
  subcommand "supabase", Commands::SupabaseCommands
76
77
 
78
+ desc "vault SUBCOMMAND", "Secrets Vault de la base d'une app"
79
+ subcommand "vault", Commands::VaultCommands
80
+
77
81
  desc "auth SUBCOMMAND", "Jeton pour kubectl", hide: true
78
82
  subcommand "auth", Commands::AuthCommands
79
83
 
@@ -2,6 +2,7 @@
2
2
 
3
3
  require_relative "supabase_auth_change"
4
4
  require_relative "supabase_realtime_change"
5
+ require_relative "database_option_change"
5
6
 
6
7
  module Captive
7
8
  module Commands
@@ -83,9 +84,43 @@ module Captive
83
84
  puts SupabaseRealtimeChange.new(addons: addons_api, paint: paint).run(app, options)
84
85
  end
85
86
 
87
+ desc "pg-cron APP", "Affiche ou modifie l'option pg_cron et pg_net de la base"
88
+ long_desc <<~DESC
89
+ Sans option : affiche si pg_cron et pg_net sont activés sur la base.
90
+ Avec --enabled : les active ou les désactive. La base redémarre.
91
+ Exige PostgreSQL 18. Réservé aux admins de l'Organization.
92
+
93
+ \x05Exemples :
94
+ \x05 captive addons pg-cron my-app-staging
95
+ \x05 captive addons pg-cron my-app-staging --enabled=true
96
+ DESC
97
+ method_option :enabled, enum: %w[true false], desc: "Option pg_cron et pg_net"
98
+ map "pg-cron" => :pg_cron
99
+ def pg_cron(app)
100
+ puts option_change(Dashboard::DatabaseOption::PG_CRON).run(app, options)
101
+ end
102
+
103
+ desc "vault APP", "Affiche ou modifie l'Option Vault de la base"
104
+ long_desc <<~DESC
105
+ Sans option : affiche si Supabase Vault est activé sur la base.
106
+ Avec --enabled : l'active ou le désactive. La base redémarre.
107
+ Exige PostgreSQL 18. Réservé aux admins de l'Organization.
108
+ Les secrets se gèrent ensuite avec captive vault.
109
+
110
+ \x05Exemples :
111
+ \x05 captive addons vault my-app-staging
112
+ \x05 captive addons vault my-app-staging --enabled=true
113
+ DESC
114
+ method_option :enabled, enum: %w[true false], desc: "Option Vault"
115
+ def vault(app)
116
+ puts option_change(Dashboard::DatabaseOption::VAULT).run(app, options)
117
+ end
118
+
86
119
  private
87
120
 
88
121
  def presenter = Presenter::Addon.new(paint: paint)
122
+
123
+ def option_change(option) = DatabaseOptionChange.new(addons: addons_api, paint: paint, option: option)
89
124
  end
90
125
  end
91
126
  end
@@ -0,0 +1,30 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Captive
4
+ module Commands
5
+ # `addons pg-cron` et `addons vault` : sans réglage, les lignes qui décrivent l'option ; avec
6
+ # --enabled, l'état voulu envoyé au dashboard, que captive-platform applique plus tard en
7
+ # redémarrant la base (ADR 0041, 0046).
8
+ class DatabaseOptionChange
9
+ def initialize(addons:, paint:, option:)
10
+ @addons = addons
11
+ @paint = paint
12
+ @option = option
13
+ end
14
+
15
+ # `options` : les options Thor de la commande, `enabled` ("true"/"false").
16
+ def run(app, options)
17
+ enabled = options["enabled"]
18
+ unless enabled
19
+ return Presenter::DatabaseOption.new(paint: @paint, option: @option)
20
+ .lines(@addons.database_option(app, @option), app: app)
21
+ end
22
+
23
+ @addons.set_database_option(app, @option, enabled: enabled == "true")
24
+ [ @paint.green(" ✓ Option #{@option.label} en cours de modification, la base redémarre : " \
25
+ "#{CLIDependencies::ASYNC_NOTICE}"),
26
+ @paint.dim(" Suivre : captive addons #{@option.command} #{app}"), ]
27
+ end
28
+ end
29
+ end
30
+ end
@@ -3,6 +3,7 @@
3
3
  require "tty-spinner"
4
4
  require_relative "db_exec"
5
5
  require_relative "db_psql"
6
+ require_relative "db_migrations_mark"
6
7
 
7
8
  module Captive
8
9
  module Commands
@@ -49,6 +50,27 @@ module Captive
49
50
  abort paint.red("✗ #{e.message}")
50
51
  end
51
52
 
53
+ desc "migrations-mark APP", "Inscrit les migrations Supabase comme jouées, sans les jouer"
54
+ long_desc <<~DESC
55
+ Pour une base migrée à la main avant que la plateforme joue les migrations au
56
+ déploiement : inscrit chaque fichier <horodatage>_<nom>.sql du dossier dans
57
+ supabase_migrations.schema_migrations, sans l'exécuter. Une version déjà inscrite
58
+ est laissée telle quelle. --up-to s'arrête à la dernière migration réellement jouée.
59
+
60
+ \x05Exemple :
61
+ \x05 captive db migrations-mark sas-seatup-staging
62
+ \x05 captive db migrations-mark sas-seatup-staging --up-to 20261020120000
63
+ DESC
64
+ method_option :dir, type: :string, default: "supabase/migrations", desc: "Dossier des migrations"
65
+ method_option :up_to, type: :string, desc: "Dernière version à inscrire (incluse)"
66
+ def migrations_mark(app)
67
+ versions = DbMigrationsMark.new(exec: DbExec.new(kubectl: kubectl, trail: trail))
68
+ .run(app, options[:dir], up_to: options[:up_to])
69
+ puts paint.green(" ✓ #{versions.size} migrations inscrites comme jouées, jusqu'à #{versions.last}.")
70
+ rescue Captive::ExecError => e
71
+ abort paint.red("✗ #{e.message}")
72
+ end
73
+
52
74
  desc "psql APP", "Ouvre une session psql sur la base, ou joue une requête avec -c"
53
75
  long_desc <<~DESC
54
76
  Session psql interactive sur la base de l'app, sous un rôle admin
@@ -0,0 +1,54 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "tempfile"
4
+ require_relative "../errors"
5
+
6
+ module Captive
7
+ module Commands
8
+ # Inscrit les migrations d'un dossier local dans supabase_migrations.schema_migrations sans
9
+ # les jouer : la base a été migrée à la main (captive db exec), l'initContainer de
10
+ # déploiement (BRIO-268) rejouerait tout sur une table de suivi vide. L'équivalent de
11
+ # `supabase migration repair --status applied`, joué via captive db exec.
12
+ class DbMigrationsMark
13
+ FILE = /\A([0-9]+)_(.*)\.sql\z/
14
+
15
+ # La table du CLI Supabase (supabase/cli, pkg/migration/history.go).
16
+ TABLE = <<~SQL
17
+ create schema if not exists supabase_migrations;
18
+ create table if not exists supabase_migrations.schema_migrations (version text not null primary key);
19
+ alter table supabase_migrations.schema_migrations add column if not exists statements text[];
20
+ alter table supabase_migrations.schema_migrations add column if not exists name text;
21
+ SQL
22
+
23
+ def initialize(exec:)
24
+ @exec = exec
25
+ end
26
+
27
+ def run(app, dir, up_to: nil)
28
+ migrations = read(dir).select { |version, _| up_to.nil? || version.to_i <= up_to.to_i }
29
+ raise ExecError, "aucune migration <horodatage>_<nom>.sql dans #{dir}" if migrations.empty?
30
+
31
+ Tempfile.create([ "marquage", ".sql" ]) do |file|
32
+ file.write(TABLE + inscription(migrations))
33
+ file.close
34
+ @exec.run(app, file.path)
35
+ end
36
+ migrations.map(&:first)
37
+ end
38
+
39
+ private
40
+
41
+ def read(dir)
42
+ Dir.children(dir).sort.filter_map { |name| FILE.match(name)&.captures }
43
+ rescue Errno::ENOENT
44
+ []
45
+ end
46
+
47
+ def inscription(migrations)
48
+ values = migrations.map { |version, name| "('#{version}', '#{name.gsub("'", "''")}')" }
49
+ "insert into supabase_migrations.schema_migrations (version, name) values\n " \
50
+ "#{values.join(",\n ")}\non conflict (version) do nothing;\n"
51
+ end
52
+ end
53
+ end
54
+ end
@@ -0,0 +1,59 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "io/console"
4
+
5
+ module Captive
6
+ module Commands
7
+ # `captive vault` : les Secrets Vault de la base (BRIO-287). La valeur se lit sur stdin, jamais
8
+ # en argument : elle finirait dans l'historique du shell et la liste des processus.
9
+ class VaultCommands < Thor
10
+ include CLIDependencies
11
+
12
+ def self.exit_on_failure? = true
13
+
14
+ desc "list APP", "Liste les Secrets Vault de la base, sans leur valeur"
15
+ long_desc <<~DESC
16
+ \x05Exemple :
17
+ \x05 captive vault list my-app-staging
18
+ DESC
19
+ def list(app)
20
+ vault_api.list(app).each do |secret|
21
+ puts [ secret["name"], paint.dim(secret["description"].to_s), paint.dim(secret["updated_at"].to_s) ]
22
+ .reject(&:empty?).join(" ")
23
+ end
24
+ end
25
+
26
+ desc "set APP NAME", "Crée un Secret Vault, ou remplace sa valeur (lue sur stdin)"
27
+ long_desc <<~DESC
28
+ La valeur est lue sur stdin, ou demandée sans écho dans un terminal.
29
+
30
+ \x05Exemple :
31
+ \x05 printf %s "$SECRET" | captive vault set my-app-staging perf_robot_secret
32
+ DESC
33
+ method_option :description, desc: "Description du secret ; absente, l'ancienne est gardée"
34
+ def set(app, name)
35
+ value = read_value
36
+ abort "La valeur est vide." if value.empty?
37
+
38
+ change = vault_api.set(app, name, value:, description: options[:description])
39
+ puts paint.green(" ✓ #{name} #{change == "created" ? "créé" : "remplacé"}")
40
+ end
41
+
42
+ desc "rm APP NAME", "Supprime un Secret Vault"
43
+ def rm(app, name)
44
+ vault_api.delete(app, name)
45
+ puts paint.green(" ✓ #{name} supprimé")
46
+ end
47
+
48
+ private
49
+
50
+ def vault_api = @vault_api ||= Dashboard::VaultResource.new(api: dashboard)
51
+
52
+ def read_value
53
+ return $stdin.read.to_s.chomp unless $stdin.tty?
54
+
55
+ IO.console.getpass("Valeur : ").to_s
56
+ end
57
+ end
58
+ end
59
+ end
@@ -28,6 +28,9 @@ module Captive
28
28
  def set_supabase_realtime(app, enabled:, postgres_changes:)
29
29
  @api.put(SUPABASE_REALTIME_PATH.call(app), { enabled: enabled, postgres_changes: postgres_changes })
30
30
  end
31
+
32
+ def database_option(app, option) = @api.get(option.path.call(app))
33
+ def set_database_option(app, option, enabled:) = @api.put(option.path.call(app), { enabled: enabled })
31
34
  end
32
35
  end
33
36
  end
@@ -0,0 +1,14 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Captive
4
+ module Dashboard
5
+ # Une option de la base d'une app, réglage de l'add-on Supabase : pg_cron et pg_net (ADR 0041),
6
+ # Vault (ADR 0046). Activée, elle redémarre la base ; elle exige PostgreSQL 18.
7
+ DatabaseOption = Data.define(:command, :label) do
8
+ def path = AppPath.new("addons/supabase/#{command}")
9
+ end
10
+
11
+ DatabaseOption::PG_CRON = DatabaseOption.new(command: "pg-cron", label: "pg_cron et pg_net")
12
+ DatabaseOption::VAULT = DatabaseOption.new(command: "vault", label: "Vault")
13
+ end
14
+ end
@@ -0,0 +1,22 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Captive
4
+ module Dashboard
5
+ # Les Secrets Vault de la base d'une app (BRIO-287), écrits tout de suite par le dashboard.
6
+ class VaultResource
7
+ PATH = AppPath.new("vault/secrets")
8
+
9
+ def initialize(api:)
10
+ @api = api
11
+ end
12
+
13
+ def list(app) = @api.get(PATH.call(app))["secrets"]
14
+
15
+ def set(app, name, value:, description: nil)
16
+ @api.put(PATH.call(app, name), { value:, description: }.compact)["change"]
17
+ end
18
+
19
+ def delete(app, name) = @api.delete(PATH.call(app, name))
20
+ end
21
+ end
22
+ end
@@ -16,8 +16,10 @@ require_relative "dashboard_api"
16
16
  require_relative "dashboard/app_path"
17
17
  require_relative "dashboard/apps_resource"
18
18
  require_relative "dashboard/env_vars_resource"
19
+ require_relative "dashboard/vault_resource"
19
20
  require_relative "dashboard/scheduled_tasks_resource"
20
21
  require_relative "dashboard/domains_resource"
22
+ require_relative "dashboard/database_option"
21
23
  require_relative "dashboard/addons_resource"
22
24
  require_relative "dashboard/functions_resource"
23
25
  require_relative "presenter/app_info"
@@ -26,6 +28,7 @@ require_relative "presenter/domain"
26
28
  require_relative "presenter/addon"
27
29
  require_relative "presenter/supabase_auth"
28
30
  require_relative "presenter/supabase_realtime"
31
+ require_relative "presenter/database_option"
29
32
  require_relative "presenter/edge_function"
30
33
  require_relative "activity_trail"
31
34
  require_relative "errors"
@@ -0,0 +1,35 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Captive
4
+ module Presenter
5
+ # Une option de la base (pg_cron, Vault), comme sur sa page du dashboard (ADR 0041, 0046).
6
+ class DatabaseOption
7
+ VALEURS = { true => "oui", false => "non" }.freeze
8
+
9
+ def initialize(paint:, option:)
10
+ @paint = paint
11
+ @option = option
12
+ end
13
+
14
+ def lines(settings, app:)
15
+ [
16
+ [ "#{@option.label} #{VALEURS.fetch(settings["enabled"], "inconnu")}", indisponible(settings) ].compact.join(" "),
17
+ (@paint.yellow("Changement en cours…") if settings["pending"]),
18
+ @paint.dim(modification(settings, app)),
19
+ ].compact
20
+ end
21
+
22
+ private
23
+
24
+ def modification(settings, app)
25
+ return "Modifiable par un admin de l'Organization" unless settings["can_edit"]
26
+
27
+ "Modifier : captive addons #{@option.command} #{app} --enabled=true|false (redémarre la base)"
28
+ end
29
+
30
+ def indisponible(settings)
31
+ @paint.dim("(PostgreSQL 18 requis)") if settings["available"] == false
32
+ end
33
+ end
34
+ end
35
+ end
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Captive
4
- VERSION = "1.10.0"
4
+ VERSION = "1.12.0"
5
5
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: captive-cli
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.10.0
4
+ version: 1.12.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Captive Studio
@@ -115,9 +115,11 @@ files:
115
115
  - lib/captive/commands/console.rb
116
116
  - lib/captive/commands/cron_declaration.rb
117
117
  - lib/captive/commands/crons_commands.rb
118
+ - lib/captive/commands/database_option_change.rb
118
119
  - lib/captive/commands/db_commands.rb
119
120
  - lib/captive/commands/db_dump.rb
120
121
  - lib/captive/commands/db_exec.rb
122
+ - lib/captive/commands/db_migrations_mark.rb
121
123
  - lib/captive/commands/db_psql.rb
122
124
  - lib/captive/commands/db_target.rb
123
125
  - lib/captive/commands/domain_announcer.rb
@@ -133,15 +135,18 @@ files:
133
135
  - lib/captive/commands/supabase_commands.rb
134
136
  - lib/captive/commands/supabase_realtime_change.rb
135
137
  - lib/captive/commands/user_login.rb
138
+ - lib/captive/commands/vault_commands.rb
136
139
  - lib/captive/credentials.rb
137
140
  - lib/captive/credentials_store.rb
138
141
  - lib/captive/dashboard/addons_resource.rb
139
142
  - lib/captive/dashboard/app_path.rb
140
143
  - lib/captive/dashboard/apps_resource.rb
144
+ - lib/captive/dashboard/database_option.rb
141
145
  - lib/captive/dashboard/domains_resource.rb
142
146
  - lib/captive/dashboard/env_vars_resource.rb
143
147
  - lib/captive/dashboard/functions_resource.rb
144
148
  - lib/captive/dashboard/scheduled_tasks_resource.rb
149
+ - lib/captive/dashboard/vault_resource.rb
145
150
  - lib/captive/dashboard_api.rb
146
151
  - lib/captive/dashboard_client.rb
147
152
  - lib/captive/dashboard_response.rb
@@ -158,6 +163,7 @@ files:
158
163
  - lib/captive/presenter/addon.rb
159
164
  - lib/captive/presenter/ansi_stripper.rb
160
165
  - lib/captive/presenter/app_info.rb
166
+ - lib/captive/presenter/database_option.rb
161
167
  - lib/captive/presenter/domain.rb
162
168
  - lib/captive/presenter/edge_function.rb
163
169
  - lib/captive/presenter/log_colorizer.rb