Vadovai

Amazon S3 failų tvarkyklė: prijunkite ją prie Nubbo

Kaip prijungti Amazon S3 bucket prie Nubbo: kokio IAM rakto reikia, vedlys žingsnis po žingsnio, CORS taisyklė ir ką daryti iškilus problemai.

Nubbo jungiasi prie Amazon S3 naudodama IAM prieigos raktą. Per kelias minutes jūsų bucket atsiduria failų naršyklėje su tiesioginiais įkėlimais, bendrinimo nuorodomis ir galerijomis, nieko nepadarant viešo. Šis vadovas žingsnis po žingsnio seka Nubbo vedlį abiem keliais: automatiškai arba su raktu, apribotu vienu bucket.

Ką gaunate

  • Naršykite bucket kaip diską: aplankai, rodiniai, paieška, šiukšlinė, žymos ir mėgstami.
  • Įkelkite ir atsisiųskite failus tiesiai tarp savo naršyklės ir Amazon S3. Failai niekada nepereina per Nubbo serverius.
  • Bendrinkite failus ir aplankus su slaptažodžiu, galiojimo laiku ir atsisiuntimų limitu, gaukite failus į savo bucket ir kurkite galerijas.
  • Jūsų raktai saugomi užšifruoti AES-256-GCM, o bucket galite atjungti bet kada.

Prieš pradedant

Jums reikia Amazon S3 paskyros ir Nubbo paskyros. Kiekvienas prijungtas bucket įskaičiuojamas į jūsų plano limitą: Nemokamas planas leidžia 2, Personal 5, o Pro neturi ribos. Kai kurie AWS regionai pagal numatytuosius nustatymus išjungti ir prieš naudojant juos reikia įjungti paskyroje (pavyzdžiui, Milanas, Ciurichas ar Keiptaunas). Jei bucket kursite viename iš jų, pirmiausia jį įjunkite. Block Public Access išjungti nereikia: Nubbo palieka bucket privatų.

Pasirinkite prijungimo būdą

Nubbo vedlys siūlo du kelius. Abu baigiasi taip pat: bucket prijungtas ir paruoštas įkėlimams iš naršyklės.

AutomatiškaiSu apribotu raktu
RaktasPrieiga prie visos paskyrosApribotas vienu bucket
BucketNubbo naudoja vieną iš jūsų arba sukuria naująPirmiausia jį sukuriate jūs
CORSNubbo prideda taisyklę už jusTaisyklę pridedate jūs
Kada rinktisGreičiausias būdasKai nenorite suteikti prieigos prie visos paskyros

Automatinis prijungimas

1 žingsnis: sukurkite raktą Amazon S3

  1. Prisijunkite prie AWS konsolės ir atidarykite IAM. Naudokite IAM vartotoją, niekada ne paskyros root vartotoją.
  2. Eikite į Users ir spauskite Create user. Suteikite jam pavadinimą, pavyzdžiui, nubbo, ir spauskite Next.
  3. Skiltyje Set permissions pasirinkite Attach policies directly, suraskite ir pažymėkite AmazonS3FullAccess ir sukurkite vartotoją.
  4. Atidarykite vartotoją, eikite į kortelę Security credentials ir skiltyje Access keys spauskite Create access key.
  5. Kaip naudojimo atvejį pasirinkite Application running outside AWS (arba Other, jei jo sąraše nėra) ir spauskite Next bei Create access key.
  6. Spauskite Download .csv file. Tai vienintelis kartas, kai AWS leidžia pamatyti slaptąjį prieigos raktą.

2 žingsnis: prijunkite bucket Nubbo

  1. Nubbo atidarykite Bucket’ai ir spauskite Prijungti bucket. Pasirinkite Amazon S3 ir spauskite Tęsti.

    Nubbo vedlio teikėjo žingsnis su pasirinktu Amazon S3 Nubbo vedlio teikėjo žingsnis su pasirinktu Amazon S3
  2. Pasirinkite Automatiškai ir spauskite Tęsti.

    Prijungimo būdo žingsnis su parinktimis Automatiškai ir Su apribotu raktu Prijungimo būdo žingsnis su parinktimis Automatiškai ir Su apribotu raktu
  3. Žingsnyje Jūsų raktas spauskite Įkelti failą ir pasirinkite atsisiųstą CSV arba įklijuokite jo turinį į teksto laukelį. Nubbo nuskaito prieigos raktą ir slaptąjį raktą, todėl jų nereikia kopijuoti ranka. Patikrinkite, ar Regionas yra jūsų bucket regionas. Spauskite Patikrinti raktą. Nubbo patikrina, ar raktas veikia ir ar jis turi prieigą prie visos paskyros.

    Amazon S3 žingsnis Jūsų raktas su greituoju vadovu ir rakto laukais Amazon S3 žingsnis Jūsų raktas su greituoju vadovu ir rakto laukais
  4. Pasirinkite vieną iš savo bucket ir spauskite Naudoti šį bucket arba pažymėkite Sukurti naują, įveskite pavadinimą (ir pasirinkite regioną, jei jo paprašoma) ir spauskite Sukurti ir paruošti. Nubbo prideda prie bucket CORS taisyklę, kuri leidžia įkėlimus ir atsisiuntimus tik iš programos, ir išsaugo jau esamas taisykles.

    Žingsnis Jūsų bucket su bucket sąrašu ir parinktimi Sukurti naują Žingsnis Jūsų bucket su bucket sąrašu ir parinktimi Sukurti naują
  5. Peržiūrėkite tris patikras, jei norite, pakeiskite Pavadinimas Nubbo ir spauskite Baigti. Bucket atsiranda skiltyje Bucket’ai ir jį galite atidaryti naršyklėje.

    Pabaigos žingsnis su ryšio, bucket ir CORS patikromis Pabaigos žingsnis su ryšio, bucket ir CORS patikromis

Jei Nubbo negali pridėti CORS taisyklės su jūsų raktu, vedlys nukreipia jus į žingsnį CORS. Tada sekite skyrių Pridėkite CORS taisyklę.

Prijungimas su apribotu raktu

1 žingsnis: paruoškite bucket ir raktą Amazon S3

  1. Konsolėje viršutinėje juostoje pasirinkite regioną, atidarykite S3 ir skiltyje General purpose buckets spauskite Create bucket. Suteikite jam pavadinimą (nuo 3 iki 63 simbolių: mažosios raidės, skaičiai, taškai ir brūkšneliai) ir sukurkite jį su įjungtu Block Public Access.
  2. IAM skiltyje sukurkite vartotoją be jokių teisių (Users, Create user).
  3. Atidarykite vartotoją, kortelė Permissions, Add permissions, Create inline policy. Persijunkite į JSON redaktorių, įklijuokite šią politiką, YOUR-BUCKET pakeisdami savo bucket pavadinimu, ir išsaugokite ją su pavadinimu.
  4. Sukurkite raktą skiltyje Security credentials, Create access key, kaip ir automatinio prijungimo atveju, ir atsisiųskite CSV.
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "arn:aws:s3:::YOUR-BUCKET"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject",
        "s3:AbortMultipartUpload",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
    }
  ]
}

2 žingsnis: prijunkite bucket Nubbo

  1. Skiltyje Bucket’ai spauskite Prijungti bucket, pasirinkite Amazon S3, tada Su apribotu raktu.
  2. Įkelkite rakto CSV arba įklijuokite jo turinį ir pasirinkite bucket regioną. Spauskite Patikrinti raktą.
  3. Įveskite tikslų bucket pavadinimą ir spauskite Patikrinti prieigą.
  4. Vedlys pereina į žingsnį CORS su taisykle, kurią reikia pridėti.

Pridėkite CORS taisyklę

CORS taisyklė leidžia naršyklei įkelti ir atsisiųsti failus iš jūsų bucket svetainėje https://nubbo.app. Tai ta pati taisyklė, kurią vedlys rodo žingsnyje CORS.

  1. S3 konsolėje atidarykite bucket ir eikite į kortelę Permissions.
  2. Slinkite žemyn iki Cross-origin resource sharing (CORS) ir spauskite Edit.
  3. Įklijuokite taisyklę ir spauskite Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
CORS žingsnis su taisykle, kurią reikia pridėti prie bucket CORS žingsnis su taisykle, kurią reikia pridėti prie bucket

Kai ją išsaugosite, grįžkite į Nubbo ir spauskite Pridėjau, patikrinti. Kai kuriems teikėjams reikia minutės ją pritaikyti. Jei jūsų raktas turi teisę keisti CORS, Bandyti sukonfigūruoti už mane tai padarys už jus.

Jei kas nors nepavyksta

Pranešimas NubboKą daryti
„Neteisingi prisijungimo duomenys. Patikrinkite prieigos raktą ir slaptąjį prieigos raktą.“Nukopijuokite abu raktus iš naujo, be tarpų pradžioje ar pabaigoje.
„Panašu, kad šis raktas apribotas vienu bucket. Galite tęsti apribotu keliu arba sukurti raktą su visa prieiga.“Spauskite Tęsti su apribotu raktu arba sukurkite raktą su prieiga prie visos paskyros ir spauskite Išbandyti kitą raktą.
„Bucket nerastas. Patikrinkite pavadinimą ir regioną.“Patikrinkite tikslų bucket pavadinimą ir ar pasirinktas regionas yra bucket regionas.
„Jūsų raktas neturi teisės kurti bucket.“Naudokite raktą su visa prieiga arba sukurkite bucket savo skydelyje ir spauskite Jau sukūriau jį savo skydelyje.
„Šis pavadinimas pas šį teikėją jau naudojamas; išbandykite kitą.“Bucket pavadinimai unikalūs visame teikėjo tinkle: pasirinkite kitą.
„Jūsų raktas neturi teisės to sukonfigūruoti.“Pridėkite CORS taisyklę ranka, kaip paaiškinta aukščiau.
„Dar neveikia. Peržiūrėkite taisyklę ir patikrinkite dar kartą; kai kuriems teikėjams reikia minutės ją pritaikyti.“Patikrinkite, ar kilmė yra tiksliai https://nubbo.app be pasvirojo brūkšnio gale, palaukite minutę ir patikrinkite dar kartą.
„Šis bucket jau naudojamas.“Šis bucket jau prijungtas prie Nubbo, jūsų ar kitoje paskyroje.
„Bucket yra kitame regione. Patikrinkite sukonfigūruotą regioną.“Žingsnyje Jūsų raktas pasirinkite regioną, kuriame yra bucket.
„Šiame faile neradome raktų; įklijuokite juos ranka.“Įkelkite CSV, kurį atsisiuntėte kurdami raktą, arba įklijuokite jo turinį tokį, koks jis yra.

Kiek tai kainuoja

Amazon S3 ima mokestį už saugojimą, užklausas ir išeinantį duomenų srautą. Tai paaiškiname su pavyzdžiais straipsnyje Amazon S3 kainos.

Dažnai užduodami klausimai

Ar norint naudoti Nubbo reikia padaryti S3 bucket viešą?

Ne. Nubbo palieka bucket privatų, o Block Public Access gali likti įjungtas. Įkėlimai ir atsisiuntimai naudoja presigned URL, kurių galiojimas baigiasi.

Kokių teisių reikia AWS raktui?

Automatiniam keliui reikia AmazonS3FullAccess politikos. Su apribotu raktu pakanka inline politikos, kuri suteikia prieigą tik prie jūsų bucket: objektų sąrašo, skaitymo, rašymo ir trynimo.

Ar galiu naudoti AWS root vartotojo raktus?

Tai nėra gera mintis, ir AWS to nerekomenduoja. Sukurkite IAM vartotoją tik Nubbo; vėliau galėsite išjungti jo raktą nieko kito neliesdami.

Kodėl Nubbo neturi laukų AWS raktui?

Nes AWS raktą pateikia CSV faile. Nubbo jį nuskaito tiesiogiai: jūs jį įkeliate arba įklijuojate jo turinį ir niekada nekopijuojate slaptojo rakto ranka.

Ar galiu prijungti kelis S3 bucket?

Taip. Kiekvienas bucket įskaičiuojamas į jūsų plano limitą: Nemokamas planas leidžia 2, Personal 5, o Pro neturi ribos, ir jie gali būti iš skirtingų AWS paskyrų.

Šaltiniai

Kainos ir ribos paimtos iš toliau nurodytų oficialių puslapių. Teikėjai jas keičia, todėl patikrinkite prieš apsispręsdami.